code-intelligence

# code-intelligence > For a **structure** question — *who calls X*, *where is Y used*, *what > imports Z*, *what breaks if I change this symbol* — a code-graph answers far > more precisely than a blind `grep`, at a fraction of the tokens. This skill > routes such questions to the native code-graph engine (ADR-124, Class A) or a > consumer-shipped index first, and falls back to grep **with a stated reason** > when the graph cannot answer. It is the executable side of > [`external-code-graph-interop`](../../rules/external-code-graph-interop.md): > *orchestrator first, owner where it wins*. ## When to use - The question is about **relationships between code symbols**, not content: callers/callees, references, imports, inheritance, change-impact. - You are about to `grep`/`Read` across many files to reconstruct a call or import graph by hand. **When NOT to use:** content/semantic questions ("what does this function *mean*", "find the string 'password'"), single-file edits, or a repo with no code-graph and no appetite to build one — plain `grep`/read is right there. ## Procedure 1. **Detect the source.** `agent-config code-graph detect` — is a fresh consumer `graph.json` or native cache present? (A consumer-shipped fresh index wins; the native engine covers stale-or-absent — ADR-124 § 2.) 2. **Build if absent and worthwhile.** No graph + a repo in the launch set (PHP / TS / JS)? `agent-config code-graph build` (deterministic, LLM-free, ~seconds). Skip for a o...