codegraph-guidance
Trigger: architecture, codebase map, call flow, dependency, symbol, impact, affected files. Use CodeGraph before broad filesystem exploration.
SKILL.md.claude/skills/codegraph-guidance/SKILL.md
GitHubActivation Contract
Use before answering or changing structural codebase questions.
Hard Rules
- Resolve the project root, confirm it is a project, then check
.codegraph/. - Initialize once only when the index is missing in a real project.
- Prefer
codegraph_explore; usecodegraph exploreonly if MCP is unavailable. - Do not use administrative/destructive lifecycle commands in ordinary work.
Execution Steps
- Run
git rev-parse --show-toplevel || pwd. - Check
<root>/.codegraph/; if absent, runcodegraph init <root>. - Ask one focused explore question for symbols, path, callers/callees and blast radius.
- Fall back to filesystem search only if CodeGraph fails; state the fallback.
Output Contract
Return the indexed evidence, call path/blast radius, and affected files. Do not claim structural facts from intuition.