feat(graphify): add full-project knowledge graph + Claude Code hooks

Runs graphify over src/ + documentation/ to build a persistent knowledge
graph (2,234 nodes, 4,651 edges, 217 communities) used by Claude for
codebase queries. Includes post-commit hook for incremental updates and
PreToolUse hooks enforcing query-before-grep in Claude Code sessions.

- graphify-out/: graph.json, GRAPH_REPORT.md, labels, manifest, root ptr
- .claude/settings.json: PreToolUse hooks (graphify query enforcement)
- CLAUDE.md: graphify section added by `graphify claude install`
- .gitignore: exclude cache/, graph.html, settings.local.json
- vite.config.ts: exclude graphify-out/ from HMR watch

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Scott Idem
2026-06-23 21:59:24 -04:00
parent dcc0f9a05b
commit 28ef0e9d3f
12 changed files with 72829 additions and 2 deletions

View File

@@ -117,3 +117,13 @@ src/routes/
| `documentation/GEMINI__Svelte_and_Me.md` | Svelte 5 runes patterns |
| `documentation/PROJECT__AE_Events_Launcher_Native_integration.md` | Electron/Launcher |
| `documentation/PROJECT__AE_Events_Badges_Review_Print.md` | Badges — kiosk editing (Task 4.0 open) |
## graphify
This project has a knowledge graph at graphify-out/ with god nodes, community structure, and cross-file relationships.
Rules:
- For codebase questions, first run `graphify query "<question>"` when graphify-out/graph.json exists. Use `graphify path "<A>" "<B>"` for relationships and `graphify explain "<concept>"` for focused concepts. These return a scoped subgraph, usually much smaller than GRAPH_REPORT.md or raw grep output.
- If graphify-out/wiki/index.md exists, use it for broad navigation instead of raw source browsing.
- Read graphify-out/GRAPH_REPORT.md only for broad architecture review or when query/path/explain do not surface enough context.
- After modifying code, run `graphify update .` to keep the graph current (AST-only, no API cost).