用途:记录一项具有架构意义的决策,保留背景、约束、备选方案、决定及其后果,形成便于未来维护者复查的紧凑决策文档。仅修改已获批准的决策文档,不设计整体系统、不静默批准决策、不删除历史、不审计代码、不实现该选择。
主要能力与产物规则:优先沿用仓库既有 ADR 约定;否则使用 docs/architecture/decisions/NNNN-<slug>.md 及下一个未使用的递增编号。新记录默认状态为 Proposed,仅在获得授权决策者明确确认后使用 Accepted。不重编号、不删除或改写历史记录的决定与理由;可在规则下做限定范围的状态与取代链接更新,替代方案被明确接受后旧记录标记为 Superseded 并双向链接。记录须短到可作为单一决策审阅,并保留未来复核所需的理由。区分采纳前所需证据与采纳后所需监控。优先使用稳定的仓库引用而非会话或分支临时链接。
执行方式:按清单逐步推进,内部将各项标记为 PENDING、PROVEN(附具体证据)、CLEARED(有证据表明条件不存在)或 UNPROVEN(存在缺口),逐节核对,返回前解决所有 PENDING。依次完成:确定决策契约(范围、负责人、为何具有架构意义,搜索重复/冲突/被取代决策,确认是单一决策);收集背景与力量(价值中立描述问题,提取业务驱动、质量属性、约束、假设,区分事实与预测);评估备选(包含现状与最简可信方案,用同一组驱动因素比较,说明落选原因及可令其翻案的触发条件);记录决策(标题、状态、日期、决策者、背景、驱动、方案、决定、后果、验证、复核触发);验证与报告。
适用场景:需要为单个重要架构选择留下可追溯记录时。限制:不适用于广泛系统设计、审计或实现;若请求含多个独立决策,需明确批准后才拆分;范围不清、编号不安全、归属冲突或无写入位置时返回 BLOCKED;权威或路径不明时也返回 BLOCKED。输出按用户语言,含 Result、Scope、Evidence、Verification、Completion 五个字段,并保留决策身份、状态、负责人、所选方案、备选、后果、证据与验证需求。