knowledge-graph

name

knowledge-graph

description

Read and refresh a pre-built dependency graph at .claude/graph/dependency-graph.json. Use to locate where a symbol is defined, trace dependencies, find where a service is wired, or enumerate the handlers/registrations in a module — without re-scanning the codebase from scratch. This skill is primarily a reader: the graph is built (and incrementally refreshed) by the bundled builder `node .claude/skills/knowledge-graph/scripts/build-graph.js`. Invoke at session start (to refresh if stale) and before grep/glob searches for symbol relationships.

Knowledge Graph

A pre-built dependency graph lives at .claude/graph/dependency-graph.json. The bundled builder is node .claude/skills/knowledge-graph/scripts/build-graph.js (incremental by default, --full to force a rebuild).

Customization (local — in the builder script, not AGENTS.md): the bundled builder supports PHP, JS/TS, and Python out of the box and auto-detects common source roots. Edit its SCAN_DIRS / language parsers to extend it, or point this skill at a project-specific builder if your repo already has one. If no builder is available, skip the graph and fall back to grep/glob.

This skill has two responsibilities:

1. Refresh the graph at session start if it is stale (base_commit ≠ git rev-parse HEAD).
2. Read the graph to answer dependency, namespace, and structure questions instantly.

Read it before running grep/glob searches for symbol relationships, namespace exploration, or dependency tracing. It eliminates redundant file scans and speeds up the first useful response in any session.

---

Graph shape

{