Codebase Memory — Knowledge Graph Tools

Graph tools return precise structural results in ~500 tokens vs ~80K for grep.

Always prefer MCP graph tools over grep, glob, or file search for code discovery.

Priority Order

1. search_graph — find functions, classes, routes, and variables by pattern.
2. trace_path — trace who calls a function or what it calls.
3. get_code_snippet — read specific function or class source code.
4. check_index_coverage — validate candidate paths and missed ranges before claims.
5. query_graph — run Cypher queries for complex patterns.
6. get_architecture — get a high-level project summary.

Quick Decision Matrix

Use project="@current" for eligible graph reads in the active checkout, or use the exact project="<name>" returned by list_projects. Never replace @current with its borrowed source project in later graph calls because the alias revalidates the worktree on every call.