文件

Coograph 是面向 AI 編程代理的圖優先上下文層。開源核心在 儲存庫，採用 MIT 授權。這套文件是簡版。儲存庫的 README 是完整版，以那邊為準。

從哪裡開始

• 快速開始 — 安裝、首次建構、首次查詢。
• 程式碼圖 — 圖裡有什麼、怎麼建構、怎麼查詢。
• 工作流程 — Plan → Propose → Apply → Review → Archive，以及驅動它的代理。
• OpenSpec — 每次改動所用的四個檔案、閘門，以及封存如何回饋 Retro。
• 模型 — 讓每個代理跑在不同模型上：需要你主動開啟，從不替你預設，而且每次都會告訴你用了哪個。
• Retro — 記錄規則被打破的時刻與每次工作階段的 token 成本，以 OpenSpec 形式提出對指令和 hook 的修改。

兩條姿態準則

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, Retro
.github/skills/          — coograph-propose, coograph-apply, etc.
.github/retro/           — Retro analyzer, rule registry, README
.github/scripts/         — Drift, idempotency and plugin-sync checks
.claude/hooks/           — Lifecycle hooks (block-generated, log-bash, capture-signals, …)
.agents/ .codex/ .opencode/ — Per-tool native config
plugin/                  — Generated Claude Code plugin
.claude-plugin/          — Marketplace manifest
openspec/changes/        — Active proposals
openspec/changes/archive/— Completed proposals
examples/                — A finished initialized project

授權

MIT。開源核心永久免費。Pro 提供客製服務 —— 見 /pro。