Standalone CLI and MCP server for deterministic repository context
Three tools with complete input schemas and descriptions. git_context and stack_context have clear, actionable descriptions (120-140 chars). All parameters are typed (boolean/string) with descriptions. However, output schemas are entirely undocumented, LLMs cannot plan downstream calls or extract structured data. No error handling guidance. Parameter descriptions lack format constraints (e.g., 'since' accepts any string; should specify ISO 8601). No enum constraints despite boolean flags that could be clearer. Tool names follow verb_noun pattern but lack specificity, 'git_context' and 'stack_context' are generic; 'get_git_branch_context' would be clearer. command_help is a utility tool with minimal value to agents.
Show context CLI help. Omit name for the full command overview, or pass a command name to scope help.
Concise branch context for the current repository, with optional PR detail, remote URLs, working-tree diffs, and merge-base branch diff.
Deterministic tech-stack summary for a directory: languages, ecosystems, tooling, and frameworks.
Output schemas completely undocumented. LLMs cannot infer what fields git_context, stack_context, or command_help return, blocking downstream tool composition and data extraction.
Parameter 'since' in git_context accepts free-form string with no format constraint. Should specify ISO 8601 (YYYY-MM-DD) or relative format (e.g., '7 days ago') to prevent LLM hallucination.
No error handling guidance. Tools do not document what happens on failure (e.g., 'not a git repo', 'GitHub API rate limit', 'invalid date format'). LLMs cannot recover from errors.
Tool names are generic. 'git_context' could mean commit history, branch info, or remote status. 'get_git_branch_context' or 'describe_git_branch' would be clearer and help LLMs disambiguate.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 55 | <=2025-11-25 | v2 |
command_help is a utility tool with minimal agent value. It mirrors CLI help text rather than enabling a core workflow. Consider removing or repositioning as a resource.