Nuntius provides 5 git-focused tools with clear verb-noun naming (generate_message, commit, push, status). All tools have descriptions and input schemas are visible in tools_test.go. However, parameter descriptions are minimal (10-30 chars), output schemas are not formally documented, and error handling lacks recovery guidance. The 'generate_and_commit' tool violates single-responsibility principle by combining two concerns. No tool annotations (readOnlyHint/destructiveHint) despite clear risk profiles. Descriptions meet minimum length but lack LLM-optimization detail (e.g., when to use generate_message vs generate_and_commit, what 'auto' diff mode does).

• Split generate_and_commit into two separate tools: generate_message and commit. This allows agents to generate, review, and commit independently, matching the single-responsibility principle.
• Expand parameter descriptions to 50-100 chars. For diff_from, explain: 'auto: includes both staged and unstaged changes; staged: only staged changes; provided: use the supplied diff parameter'.
• Add tool annotations: mark commit, push, generate_and_commit as destructiveHint=true; mark generate_message and status as readOnlyHint=true. This enables safer agent planning.
• Document output schemas explicitly in tool descriptions or as a separate schema field. E.g., 'Returns {message: string, files: string[]}' for generate_message.
• Enhance error messages with recovery hints. E.g., 'generation failed: no changes detected. Try calling status() to see what files have changed, or provide a diff via diff_from=provided'.