結合 Tier 0 / Tier 1 / Tier 2 權限控制分級、契約式規格 (Spec)、常青領域規範 (docs/policies/) 與四區原子決策記憶 (ADR · Decision Log · Rejected · Horizon)、原生版控分支隔離 (git · jj · GitHub PR) 與 漸進式授權 (AI 幕僚預審與宏觀排序 + Human 最終把關) 的規格驅動治理工作流底座。
- 嚴守 SDD 先審規範後寫代碼順序:
main嚴格只放經 Human 核准生效之檔案;所有待審提案置於propose/*純文件分支,採用免編號<category>-<slug>.md並於核准當下始取號NNNN-;在規範與 spec.md 獲准前嚴禁搶跑寫代碼。 - 常青規範 (
policies/) 與四區決策記憶 (decisions/) 雙軌互補:docs/policies/: 按領域聚合現行有效作業規則與檢核表,搭配決定性程式 (Linter--fix與 Hooks) 自動落實。docs/decisions/adr/與docs/decisions/decision-log/: 一決策一檔記錄歷史決策理由 (Why)。docs/decisions/rejected/: 未上市即否決或被更佳方案取代之提案,標題下置頂## Rejection Rationale與---保留原稿防重踩舊坑。docs/decisions/horizon/: 長期方向認同但暫不實施之遠期演進藍圖,含 24 小時主動式 AI 副手藍圖。
- 漸進式授權 (
approval_policy: supervised): 系統穩定前由跨模型 AI Agent 先行預審挑刺並依宏觀架構排定審核優先序,100% 由 Human 掌握最終拍板權。
- 待審提案的審核順序:docs/handoff/REVIEW-QUEUE.md
scope路由表:docs/INDEX.md- Tier 0 指令檔:AGENTS.md
- 治理憲章總則提案:docs/PROTOCOL.md
- 統一詞彙表(正式版 / 待審隔離版):docs/GLOSSARY.md · docs/GLOSSARY.proposed.md
- 跨 Session 交接摘要:docs/handoff/HANDOFF.md