Single tool 'sofagent_audit' has a basic description but critically lacks input parameter descriptions. The schema defines 'gitDiffPath' as a string but provides no guidance on format, expected values, or usage context. No output schema is documented. The description (67 chars) is minimal and does not explain when to use this tool, what it returns, or how to interpret results. No error handling guidance. Tool naming is acceptable (verb_noun pattern) but the overall definition quality is poor.

• Add detailed parameter description for 'gitDiffPath': 'Path to a git diff file, repository directory, or git diff output. Examples: /path/to/changes.diff, /home/user/repo, or output from `git diff HEAD~1`. Required.'
• Document the output schema with example response: { violations: [{ruleId: string, severity: 'error'|'warning', message: string, line?: number}], summary: {totalViolations: number, passedRules: number} }
• Expand tool description to 150-200 chars: 'Scans git diffs against 24 discipline rules to ensure Agent code changes follow sofagent conventions (e.g. no hardcoded secrets, proper error handling, type safety). Returns violations grouped by severity.'
• Add error handling examples: 'If path is invalid, returns {error: "Path not found", suggestion: "Verify path exists and is readable"}. If no git repo detected, returns {error: "Not a git repository"}.'
• Clarify what 'Agent discipline' means in context: add a link or brief explanation of the 24 rules (e.g. 'See sofagent/engine/audit/src/rulesets/ for rule definitions').