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
|
- Read `documentation/TODO__Agents.md` — it has active tasks, known bugs, and context
|
||||||
about what was recently changed and why.
|
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
|
### 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`.
|
The ID is in the URL. Including it in `data_kv` causes a `400: Unknown column in SET`.
|
||||||
```ts
|
```ts
|
||||||
@@ -405,3 +418,4 @@ Start here, then go deeper as needed:
|
|||||||
| IDAA Recovery Meetings module | `documentation/MODULE__AE_IDAA_Recovery_Meetings.md` |
|
| IDAA Recovery Meetings module | `documentation/MODULE__AE_IDAA_Recovery_Meetings.md` |
|
||||||
| IDAA Video Conferences module | `documentation/MODULE__AE_IDAA_Video_Conferences.md` |
|
| IDAA Video Conferences module | `documentation/MODULE__AE_IDAA_Video_Conferences.md` |
|
||||||
| Naming conventions | `documentation/AE__Naming_Conventions.md` |
|
| Naming conventions | `documentation/AE__Naming_Conventions.md` |
|
||||||
|
| Codebase knowledge graph | `graphify-out/GRAPH_REPORT.md` |
|
||||||
|
|||||||
Reference in New Issue
Block a user