code-tool-router

# Code Tool Router Classify the question before searching, then use the cheapest reliable tool. | Intent | First tool | Verification | | --- | --- | --- | | Exact string, config key, error text, filename, or symbol spelling | `rg` | Open matching files | | Broad semantic discovery or similar implementations | Semble | Confirm with `rg` and source reads | | Definitions, references, rename, or type-aware navigation | Serena or another LSP tool | Check generated and dynamic call sites with `rg` | | Callers, callees, complexity, or dependency graph | CodeGraphContext (CGC) | Confirm important edges in source | | Current library or API behavior | Official documentation | Compare with local pinned usage | Exact search examples: ```bash rg -n "reset_session\\(" . rg --files | rg "memory|context" ``` Semantic discovery examples: ```bash uvx --from semble==0.5.4 semble search "where session context is assembled" . uvx --from semble==0.5.4 semble find-related src/path/file.ts 42 . ``` Graph examples: ```bash cgc stats . --context "$(basename "$PWD")" cgc find name reset_session --context "$(basename "$PWD")" cgc analyze callers reset_session --context "$(basename "$PWD")" cgc analyze complexity --limit 20 --context "$(basename "$PWD")" ``` If a specialized tool is unavailable, continue with `rg`, direct source reads, and the language's own analysis tools. Do not claim a rename or impact set is complete without type-aware or source-level verification. Use semantic and graph results as shortlists, not proof. Source code and reproducible tests remain authoritative.