Harness-augmentation layer for AI coding assistants: skills, commands, hooks, and a shared MCP server
Single tool (tooling_discover) with adequate naming and clear description, but schema completeness is hampered by returning a generic dict without documented structure. Parameters are typed and described, following good naming conventions. However, the return type annotation is vague (→ dict), lacking specification of output fields, structure, and what the 'trust tier' grouping contains. The tool follows verb_noun naming (discover) and includes parameter descriptions with context, but falls short of production-grade schema documentation. The implementation is read-only and well-scoped, but documentation of what fields the LLM should expect in the response would significantly improve usability.
Discover available tools for a technology domain. Searches the tooling registry, active MCP tools, project dependencies, and local CLI availability to find relevant tools for the given domain.
Output schema not documented. Tool returns dict but does not specify field names, types, or structure of 'discovered tools grouped by trust tier'. LLMs cannot plan downstream tool calls without knowing what fields to extract.
Return type annotation is generic dict without schema. Docstring describes what the tool does but not what the response contains. Production tools document output schema (field names, types, structure) so LLMs know what to expect.
Error handling lacks recovery guidance. Docstring includes 'No keywords provided' error example but does not describe other failure modes (project path not found, discovery service unavailable, etc.) or what the LLM should do next.
Parameter constraint not enforced in description. 'domain_keywords' accepts 'comma-separated keywords' but does not specify minimum/maximum keyword count, length limits per keyword, or character restrictions. Validation happens inside the tool but is not documented for the LLM.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | C | 64 | 2026-07-28+ | v2 |
| 2026-03-09 | D | 57 | - | v1 |