Skip to content

Latest commit

 

History

History
17 lines (14 loc) · 1.43 KB

AGENTS.md

File metadata and controls

17 lines (14 loc) · 1.43 KB

graphify

This project has a knowledge graph at graphify-out/ with god nodes, community structure, and cross-file relationships.

When the user types /graphify, use the installed graphify skill or instructions 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.
  • Do not build or update the graph until the user explicitly approves the initial extraction. Once graphify-out/graph.json exists, update it at architectural batch boundaries rather than after every small code edit.
  • Git hooks are intentionally disabled. Use the refresh and validation commands in docs/maintainer/GRAPHIFY.md; use --force after deletions or large refactors so stale symbols cannot survive in the graph.