记录约束、备选方案、取舍原因和失效条件,使后续维护能追溯决策依据。
定义
工程决策记录保存“为什么这样实现”,与描述系统当前行为的文档分工。它可以来自真实方案取舍,也可以来自经过确认的需求纠偏。
可复用要点
- 写明原先目标、实际偏差、采取的修正和被放弃的方案。
- 把经验改写为有适用条件、可检查的规则,保留证据来源。
- 当前系统事实放入维护文档;历史取舍保留在决策记录中,避免两者混写。
- 记录结论何时需要重新检查,避免历史判断变成永久禁令。
边界
不是每次操作都需要记录,也不能仅从最终代码推测当时意图。DSH 相关文章是作者的个人分析,本页只提炼材料中可复用的方法,不认定其对组织内部流程的所有描述均已得到官方确认。
知识连接
spec-coding 保存规范与任务资产,context-engineering 决定后续会话读到什么;决策记录为两者提供可追溯的取舍依据。