From b0d46157917a45b030be48789fa85c75c4222a55 Mon Sep 17 00:00:00 2001 From: Scott Idem Date: Tue, 23 Jun 2026 22:08:18 -0400 Subject: [PATCH] docs(bootstrap): add graphify knowledge graph section Documents the graphify query-before-grep workflow for agents: query/explain/path commands, auto-rebuild via post-commit hook, and GRAPH_REPORT.md for broad architecture overview. Adds row to the reading order table. Co-Authored-By: Claude Sonnet 4.6 --- documentation/BOOTSTRAP__AI_Agent_Quickstart.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/documentation/BOOTSTRAP__AI_Agent_Quickstart.md b/documentation/BOOTSTRAP__AI_Agent_Quickstart.md index bd76d8ae..8c129619 100644 --- a/documentation/BOOTSTRAP__AI_Agent_Quickstart.md +++ b/documentation/BOOTSTRAP__AI_Agent_Quickstart.md @@ -55,6 +55,19 @@ running in Docker. The frontend talks to it exclusively via the V3 REST API. - Read `documentation/TODO__Agents.md` — it has active tasks, known bugs, and context about what was recently changed and why. +### Codebase Exploration — Use graphify First +A persistent knowledge graph lives at `graphify-out/graph.json` (2,234 nodes, 4,651 edges, +217 labeled communities). Query it before grepping or reading source files: + +```bash +graphify query "how does badge printing work" # BFS traversal — broad context +graphify explain "db_save_ae_obj_li__ae_obj" # plain-language node explanation +graphify path "leads_loc" "ae_comp__leads" # shortest path between two concepts +``` + +The graph is rebuilt automatically after every `git commit` (post-commit hook). For a +broad architecture overview without a specific question, read `graphify-out/GRAPH_REPORT.md`. + ### V3 API — Never Include the Object ID in PATCH Body Fields The ID is in the URL. Including it in `data_kv` causes a `400: Unknown column in SET`. ```ts @@ -405,3 +418,4 @@ Start here, then go deeper as needed: | IDAA Recovery Meetings module | `documentation/MODULE__AE_IDAA_Recovery_Meetings.md` | | IDAA Video Conferences module | `documentation/MODULE__AE_IDAA_Video_Conferences.md` | | Naming conventions | `documentation/AE__Naming_Conventions.md` | +| Codebase knowledge graph | `graphify-out/GRAPH_REPORT.md` |