跳至主要内容

ADR 索引

kit 預寫 3 條方法論 ADR,可直接採用或調整。這些是如何工作的決策,不是選什麼技術棧。

#標題Status日期
ADR-0001Strangler Fig 遷移協議Accepted2026-04-24
ADR-0002Dev harness 約定Accepted2026-04-24
ADR-0003產品決策記錄(first-class ADR 類別)Accepted2026-04-24

如何使用

  1. 作為你 repo 的起始 ADR-0001/0002/0003,或重編號對齊你的序列
  2. 技術 ADR(monorepo / backend 框架 / ORM 等)從 0004+ 開始
  3. 新 ADR 用 docs/templates/adr-template.md

如何新增 ADR

  1. 複製 docs/templates/adr-template.mddocs/adr/NNNN-<slug>.md(下一編號)
  2. 填:Status(初為 Proposed)、Date、Deciders、Tags、Context、Decision、Consequences、Alternatives、References
  3. 加行到本 index
  4. PR → Architect + senior eng review → merge;status 改 Accepted

Status 生命週期

ProposedAccepted → (Deprecated | Superseded by ADR-XXXX)

絕不刪 deprecated ADR。保留軌跡。