Workwright has well-structured tool definitions with explicit schemas (Zod-based), clear naming conventions (verb_noun pattern), and comprehensive parameter descriptions. All 14 tools are registered with input schemas and descriptions. However, output schemas are not documented, LLMs cannot predict return structure. Error handling is minimal (generic error messages without recovery guidance). Tool descriptions average ~100 chars, which is adequate but could be more prescriptive about when/why to use each tool. Parameter descriptions are generally good (60-80 chars), but some tools lack context about dependencies (e.g., workwright_wait_for_text doesn't explain how it relates to workwright_execute). No security concerns detected (no secrets in params), but destructive tools (workwright_close_all) lack confirmation patterns.

• Document output schemas for all tools. Define return types (e.g., workwright_list returns {sessions: [{index: number, shell: string, cwd: string, pid: number}]}). This enables LLMs to plan downstream calls and extract data reliably.
• Add confirmation patterns to destructive tools. Implement a dry-run mode or require explicit confirmation for workwright_close and workwright_close_all. E.g., add a 'confirm' boolean parameter that defaults to false.
• Enhance error messages with recovery guidance. Instead of returning raw exceptions, categorize errors: 'Session not found (index 5). Available sessions: 0, 1, 2. Try workwright_list() to see active sessions.' This guides LLM retry logic.
• Add dependency hints to tool descriptions. E.g., workwright_wait_for_text: 'Use after workwright_execute() to wait for command output. Useful for detecting completion or errors.' workwright_select: 'Switches the active session for subsequent tool calls.'
• Implement pagination and structured output for discovery tools. workwright_list should return {total: number, sessions: [{index, shell, cwd, pid}]}. workwright_get_config should return typed fields, not raw text.

Inferred effective spec: <=2025-11-25.

• Relies on Roots (deprecated) - pass files/dirs via tool parameters, resource URIs, or configuration