Build Code Graph

Evidence-backed, drill-down architecture graphs for coding agents.

Build Code Graph separates deterministic code evidence, reviewed architectural semantics, and presentation. The portable agent-codegraph.json artifact helps agents identify ownership, contracts, runtime flows, and the source evidence that should be verified before editing.

Status

The project is under active development toward v0.1.0. TypeScript and JavaScript repositories are the first supported target.

Repository Layout

• skills/build-code-graph: installable Codex skill
• tests/fixtures: deterministic analyzer and graph fixtures
• examples: generated examples and screenshots for releases

Current Workflow

1. Analyze a repository into compiler-resolved symbols and calls.
2. Scaffold and review a small semantic architecture profile.
3. Merge evidence and semantics into agent-codegraph.json.
4. Query the graph from an agent or inspect it in the interactive viewer.
5. Refresh evidence and review architectural drift after code changes.

The graph narrows source reading. It does not replace source verification.