Reduce Claude AI token consumption by 5x-27x through structural code manifest generation and dependency graph analysis
Single tool 'context-mapper' has a reasonable description (145 chars, within 10-1024 range) but critical schema deficiencies. Input schema is present with two parameters (path, dry_run) but lacks type validation details and parameter descriptions in the schema itself. The tool name lacks a clear action verb (should be 'generate_context_manifest' or 'analyze_project_context'). No output schema is documented, LLMs cannot predict what fields to expect. No error handling guidance. The tool performs a read-only analysis but the description does not explicitly state this or clarify what 'lightweight dependency graph' means to an LLM. No pagination, no result limits documented, no guidance on handling large projects.
Manifest Generator + Graph Builder. Generates CONTEXT_MANIFEST.md and a lightweight dependency graph. Scans project files, extracts imports, builds dependency graph, and generates structured manifest for token-efficient AI context.
Tool name lacks action verb. 'context-mapper' is a noun phrase; should start with verb like 'generate_', 'analyze_', or 'build_' to signal intent to LLM.
No output schema documented. LLMs cannot plan downstream actions or extract results without knowing what fields the tool returns (e.g., manifest_path, graph_structure, file_count, import_count).
Parameter descriptions missing in schema. 'path' and 'dry_run' have no descriptions visible in the input schema, LLMs cannot infer what 'path' means (absolute? relative? must exist?) or when to set dry_run=true.
No error handling guidance. Tool description does not explain what happens on invalid paths, permission errors, or projects too large to analyze. LLM has no recovery path.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 33 | 2026-07-28+ | v2 |
No result limits or pagination documented. For large projects, the dependency graph and manifest could be enormous. Description should state max file count, max output size, or pagination strategy.