ADR-NNN — <决策主题>
决策
<明确的决策陈述:选了什么方案>
如果有"M{N} 最小版"概念,分阶段说明:
M0 阶段最小实施:
- <具体决策点 1>
- <具体决策点 2>
M1+ 演化空间:
- <未来可以扩展的方向 1>
- <未来可以扩展的方向 2>
上下文
<背景:为什么需要这个决策。可列候选方案对比,但不展开详细评分(评分留在 review 资产)>
| 候选 | 优点 | 缺点 |
|---|---|---|
| <候选 1> | <优点> | <缺点> |
| <候选 2> | <优点> | <缺点> |
| <选定的候选> | <优点> | <缺点> |
<为什么选这个而不是那个的核心理由 — 1-3 段>
后果
收益:
- <收益 1>
- <收益 2>
成本:
- <成本 1>
- <成本 2>
残余风险:
- <风险 1 + 应对路径>
- <风险 2 + 应对路径>
备选方案
考虑过未采用:
- <候选 1>:<未采用原因>
- <候选 2>:<未采用原因>
关联
- 触发章节:CHAP-
<章节标题> - 影响章节:CHAP-
/ CHAP- / ... - M{N} 实施承接:
projects/<project-id>/engineering/engineering-packs/m{N}-*.md§<节号> - 关联 ADR:ADR-
(<关系描述>) - 项目级调研(如有):
projects/<project-id>/research/<topic>/ - 后续 ADR:<如本决策预期演化为某条新 ADR>
ADR 编写规范(来自 commons/playbooks/architecture-document-rewrite.md):
- ADR 不变更(accepted 后追加 superseded 关系,不直接改原文)
- ADR 不超过 80 行(紧凑 + 聚焦 + 不堆方法论)
- 方法论对比只列结论不展开评分