用途:追溯记录过去已做出但从未文档化的架构决策。触发场景包括 /doc-audit 发现 BACKFILL-ADR 候选行、用户以过去时描述某项决策、或代码考古发现无对应决策记录的迁移或子系统退役。
主要能力:分四阶段执行。阶段一进行七项资格自检并确认至少两个独立证据定位符(如 commit SHA 加迁移文件);阶段二尽力重建历史背景,无法重建的部分明确标注而非编造;阶段三起草并强制加入逐字诚实声明;阶段四保存文件。
使用方式:需提供至少两个独立证据定位符,以及受影响架构特性的可度量信号。可选提供 /doc-audit 的 BACKFILL-ADR 行作为起始简报。保存时先查找 docs/adr/ 等目录,自动编号为现有最大号加一,文件名为 NNNN-kebab-imperative-title.md,并更新决策日志 README 索引,标注 (backfilled YYYY-MM-DD)。
限制:决策为当前或进行中时不应使用;已记录时改用 adr-critique;重建置信度低时拒绝起草并转至 open-questions.md;无法命名可度量信号时拒绝。诚实声明不可移除或弱化,否则拒绝。每条消息最多提出一个问题或一个步骤。backfill ADR 不使用 proposed 或 rfc 状态。