AGENTS -- 文件索引

本檔案是 artifact-first multi-agent workflow 的文件索引。每個 agent 只需載入自己的入口檔 + 當前階段所需的參考文件。

Agent 入口檔

文件模組

Markdown 書寫語言規範

• 長期維護的 Markdown 文件以繁體中文（臺灣）為主。
• 專有名詞、檔名、CLI 指令、環境變數、artifact type、狀態值、placeholder、schema literal 保留英文原字。
• 不得更動會被 agent、validator、腳本依賴的精確字串，例如 ## Metadata、Task ID、Artifact Type、Owner、Status、Last Updated 與各種狀態值。
• 所有規範中的紀錄時間、Last Updated 與相關時間戳，一律使用 Asia/Taipei，採 ISO 8601 並帶 +08:00。
• source template repo（含 .council-forge-source-repo）中，root、template/ 與 Obsidian 入口文件必須保持語義一致；由 template/ 複製出的 downstream terminal repo 不再建立新的 template/，只維護 root 文件與 OBSIDIAN.md。
• GitHub 對外入口以 README.md / README.zh-TW.md 為準；Obsidian 入口以 OBSIDIAN.md 為準。
• 歷史 artifacts、實驗輸出、外部 repo 內 Markdown 不在追溯改寫範圍內。

階段載入矩陣

兩層架構詳見 docs/orchestration.md §2.8：管理層 PDCA 對應上表「PDCA 階段」欄；執行層 TAO/ReAct 內含於 Coding 階段內 subagent dispatch（詳見 docs/agentic_execution_layer.md）。

交叉引用慣例

• 使用 see docs/X.md §N 引用特定章節，避免重複貼內容。
• 範例："Research artifact format: see docs/artifact_schema.md §5.2"
• Agent 入口檔（CLAUDE/GEMINI/CODEX.md）內嵌了 agent 無法自行額外載入時必須遵守的關鍵規則。
• docs/ 內的參考文件由協調者（Claude Code）依階段按需載入。

章節速查

docs/artifact_schema.md

• §1-§4 通用規則 / §5 索引

docs/schemas/*

• artifact-spec-task.md(§5.1) / artifact-spec-research.md(§5.2) / artifact-spec-plan.md(§5.3)
• artifact-spec-code.md(§5.4) / artifact-spec-test.md(§5.5) / artifact-spec-verify.md(§5.6)
• artifact-spec-decision.md(§5.7) / artifact-spec-status.md(§5.8) / artifact-gallery.md

docs/subagent_roles.md

• §3 Claude Code / §4 Gemini CLI（含 Memory Bank Curator 模式） / §5 Codex CLI / §6 Implementer / §7 Tester / §8 Verifier / §9 Reviewer

docs/premortem_rules.md

• §1-2 When & where / §3 Required fields / §4 Quality rules (P1-P8) / §5 Violation levels / §6 Minimum counts