Factory Code exposes 9 tools with minimal schema documentation and sparse descriptions. Most tools lack parameter type definitions in visible code. Bash, Read, Write, Edit, Grep, Glob, WebFetch, Delegate, and Respond are defined with only name and brief description; input schemas are inferred from tool-names.ts and text-tool-parser.ts but lack explicit JSON Schema registration. Descriptions are generic (10-40 chars) and do not explain WHEN to use each tool or what happens on failure. No output schemas documented. Destructive tools (Bash, Write, Edit) lack confirmation patterns or dry-run support. Error handling is absent from visible definitions.

• Expand all tool descriptions to 100-200 characters. Include WHEN to use (e.g., 'Read: Retrieve file contents when you need to inspect code, config, or logs. Use offset/limit for large files.').
• Add explicit JSON Schema to all tools with type, description, and constraints for each parameter. E.g., Bash: {command: {type: 'string', description: 'Shell command (no pipes to external tools)', pattern: '^[a-zA-Z0-9\s\-./]+$'}}.
• Document output schemas for all tools. E.g., Read returns {content: string, size: number, truncated: boolean}.
• Implement confirmation pattern for Bash, Write, Edit: require explicit 'confirm: true' parameter or return {status: 'pending_confirmation', action: '...', confirm_token: '...'}.
• Add error recovery guidance: 'If file not found, try Glob to discover available files' or 'If Bash fails, check syntax with a simpler command first.'