25 lines
1.7 KiB
Markdown
25 lines
1.7 KiB
Markdown
## graphify
|
|
|
|
This project has a knowledge graph at graphify-out/ with god nodes, community structure, and cross-file relationships.
|
|
|
|
When the user types `/graphify`, invoke the `skill` tool with `skill: "graphify"` before doing anything else.
|
|
|
|
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.
|
|
- Dirty graphify-out/ files are expected after hooks or incremental updates; dirty graph files are not a reason to skip graphify. Only skip graphify if the task is about stale or incorrect graph output, or the user explicitly says not to use it.
|
|
- 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).
|
|
|
|
## coordination watcher
|
|
|
|
At the beginning of every session, the coordination watcher is mandatory and must be operational for Codex, Claude, and Qwen before coordination work continues.
|
|
|
|
Session-start checklist:
|
|
- Run `docs/coordination/coordination_loop.sh ensure`.
|
|
- Read every pending message relevant to the current agent.
|
|
- After messages are processed, run `docs/coordination/coordination_loop.sh ack`.
|
|
- If the watcher cannot be started or checked, report that blocker immediately in the handoff/status response.
|
|
|
|
Every new handoff or restart prompt must include this watcher requirement by default.
|