跳到主要内容

决策记录

治理级决策记录（ADR）。与 ../change-protocol.md §6.3 一致。

什么时候需要 ADR​

  • L4 治理协议变更：必须有 ADR，且须附 7 天公示窗口。
  • 关键决策 / 跨项目共识：建议用 ADR 记录，确保决策可追溯、可 supersede。
  • L0–L3 的常规变更：只需走 ../proposals/ 提案流程，不需要 ADR。提案被接受后移入 proposals/accepted/ 即完成归档。

当前本目录为空，是因为尚未发生 L4 变更或需要 ADR 级别记录的跨项目决策。

命名（唯一权威）​

ADR-NNNN--<slug>.md
  • NNNN：四位单调递增序号，不回收（即使被 superseded）
  • <slug>：小写短横线 topic slug
  • 日期不进文件名；日期放在 frontmatter 的 date:
  • 本目录只接受上述 ADR 序号命名，便于稳定排序与 supersede 链追踪。

每份 ADR 最小 frontmatter​

---
adr_id: ADR-NNNN
title: <一句话决策>
status: proposed | accepted | rejected | superseded | deprecated
date: YYYY-MM-DD
deciders: [<姓名 / Controller / Agent ID>]
supersedes: <ADR-XXXX 或空>
superseded-by: <ADR-NNNN 或空>
---

# 标题（可与 title 一致）

## 背景

## 决策

## 结果

## 备选方案

## 关联
- 相关 PR / commit / proposals / 讨论

L4 ADR 须在文末附 7 天公示窗口的 start / end（ISO-8601 日期）。

谁能写 ADR​

  • 任何人 / Agent 都可以起 ADR（status: proposed）；
  • accepted 必须由 ../roles-and-responsibilities.md 中的相应角色拍板；
  • ADR 一旦 accepted 不做 in-place 改写；需修订时新起 ADR 并维护 supersedes / superseded-by 链。

INDEX​

INDEX.md 可按 ADR 号 / 状态列目录，由派生脚本或 CI 生成。