Switchboard provides 9 tools with basic schemas and descriptions, but falls short of production quality. Tool names follow verb_noun convention (bash, read, grep, find, ls, write, edit, submit_pr_description, submit_verdict), which is good. However, descriptions are minimal (10-50 chars), parameter descriptions are sparse or missing, and output schemas are not documented. The edit tool's 'edits' parameter lacks type detail. No error handling guidance, no enum constraints on verdict/status fields, and no indication of idempotency or retry safety. Tools like submit_pr_description and submit_verdict are write operations but lack confirmation patterns or dry-run support. Parameter naming is inconsistent: 'path' vs 'pattern' for similar operations. No documentation of which tools are idempotent or safe to retry.

• Document output schemas for all tools. E.g., bash returns {stdout: string, stderr: string, exitCode: number, timedOut: boolean}; read returns {content: string, encoding: string}; grep returns {matches: [{line: number, text: string}], totalMatches: number}.
• Expand parameter descriptions to 50-150 chars. For 'pattern' in grep/find, clarify: 'Grep pattern (POSIX ERE regex, e.g. ^ERROR.*failed$)' or 'Find pattern (glob or path, e.g. *.ts or src/core)'. For 'edits' in edit, specify: 'Array of {lineNumber: number, operation: "insert"|"replace"|"delete", content?: string}'.
• Add error handling guidance. E.g., bash: 'If exitCode is non-zero, stderr contains the error. Timeout errors are retryable; permission errors require elevated privileges.' write: 'EACCES = permission denied; ENOSPC = disk full; EISDIR = path is a directory.'
• Implement confirmation pattern for destructive tools. Add optional 'dryRun: boolean' parameter to write, edit, bash. For submit_verdict, require explicit confirmation or add a 'preview_verdict' tool first.
• Add enum constraint to submit_verdict's 'verdict' parameter. Document valid values: 'approve', 'request_changes', 'comment'. Return error if invalid: 'Invalid verdict: got "approved", must be one of: approve, request_changes, comment'.