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:
@@ -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` |
|
||||
|
||||
Reference in New Issue
Block a user