首页/开发/代码质量与评审速查/债务决策记录:把取舍写进 ADR
技术债与度量63 条

债务决策记录:把取舍写进 ADR

每个「有意负债」都留下决策记录:背景、选项、决定、代价与偿还条件(触发条件);将来复盘时能看清当初的约束,避免把有意选择误读为能力问题。

载体ADR(Architecture Decision Record)或债务台账
要素背景 / 决定 / 代价 / 偿还触发条件
复盘按触发条件定期检视与清偿

ADR 片段示例

ADR 片段示例
## Decision
v1 直接使用字符串拼接生成 SQL(交付窗口紧)
## Consequences
- 复用受限、存在注入风险(由边界白名单兜底)
## Repay When
- 支持第二种数据库,或本模块首次重大变更时

易错点

  • 记录只写决定不写代价:后人无法评估偿还收益
  • 触发条件不可观察:偿还永远不触发

数据来源与参考

  • Michael Nygard · ADR 实践(documenting architecture decisions)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌