文件
Coograph 是面向 AI 編程代理的圖優先上下文層。開源核心在 儲存庫，採用 MIT 授權。這套文件是簡版。儲存庫的 README 是完整版，以那邊為準。
從哪裡開始
- 快速開始 — 安裝、首次建構、首次查詢。
- 程式碼圖 — 圖裡有什麼、怎麼建構、怎麼查詢。
- 工作流程 — Plan → Propose → Apply → Review → Archive，以及驅動它的代理。
兩條姿態準則
Coograph 初始化的每個專案都附帶兩條不可妥協的準則。兩條都作為 banner 寫在 CLAUDE.md 和 .github/copilot-instructions.md 頂部：
- CODE-GRAPH FIRST — 程式碼圖優先 —— 任何程式碼庫導航都先從圖查詢開始。grep 只是備援，只有圖確實不在時才用。
- OPENSPEC OR STOP — — 牽涉多檔案或行為變化的變更，必須先提 OpenSpec 提案、使用者核可，才能寫程式碼。
兩條準則都被設計成「對話中途不會忘記」。詳見 工作流程。
儲存庫結構
.github/code-graph/ — MCP server, parsers, git hooks
.github/agents/ — Planner, Reviewer, Debugger, Verifier, Explore
.github/skills/ — coograph-propose, coograph-apply, etc.
.claude/hooks/ — Lifecycle hooks (block-generated, log-bash, …)
openspec/changes/ — Active proposals
openspec/changes/archive/— Completed proposals
bench/ — Benchmark harness + fixture
website/ — This site授權
MIT。開源核心永久免費。Pro 提供客製服務 —— 見 /pro。