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 <noreply@anthropic.com>
This commit is contained in:
Scott Idem
2026-06-23 22:08:18 -04:00
parent e6a41316f2
commit b0d4615791

View File

@@ -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` |