Single tool 'index_repository' has a basic description but lacks critical detail. Input schema visible with two parameters (repo_path, mode) but both lack descriptions, violating the requirement that every parameter must explain what it controls. No output schema documented. Description is 87 chars (below the 194-char baseline for A+ tools) and does not explain WHEN to use this tool, what it returns, or whether it has side effects. The tool modifies state (builds a graph) but the description does not declare this. No error handling guidance. Tool name is verb-noun compliant but the schema is incomplete.

• Add descriptions to both parameters: 'repo_path' should specify format (absolute path, relative path, or git URL?); 'mode' should list valid enum values and explain the difference (e.g., 'full: re-index entire repo; incremental: update only changed files').
• Document the output schema with example fields: Does it return a graph_id, file_count, symbol_count, or a status message? LLMs need to know what to expect.
• Expand tool description to 150 - 250 chars: 'Indexes a codebase repository to build a code intelligence graph for semantic search and navigation. Returns a graph_id for use with query tools. Idempotent, safe to retry. Requires read access to the repository.'
• Add error handling guidance: 'If repo_path is invalid, returns error with available paths. If indexing times out, returns partial results with a resume_token for incremental completion.'
• Declare the tool's risk level and permissions: 'Requires read access to repository files. Writes to cache directory (CBM_CACHE_DIR). Idempotent operation.'

Inferred effective spec: <=2025-11-25.

• Relies on Logging (deprecated) - log to stderr or use OpenTelemetry