跳到主要内容

ADR-NNN — <决策主题>

决策

<明确的决策陈述:选了什么方案>

如果有"M{N} 最小版"概念,分阶段说明:

M0 阶段最小实施

  1. <具体决策点 1>
  2. <具体决策点 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 行(紧凑 + 聚焦 + 不堆方法论)
  • 方法论对比只列结论不展开评分