核心问题

写 ADR 前必须回答哪些问题?

真实场景

技术决策会结束了,大家觉得“都明白”。但人的记忆很短,组织的记忆更短。

如果不写下来,未来只能靠猜。

常见误区

坏判断是:

等系统稳定后再补文档。

等到稳定后,当初的权衡通常已经忘了。

工程视角

ADR 要记录的是决策发生时的上下文,而不是事后美化的故事。

PM 可以怎么做

使用这张清单:

1. 这次决策要解决什么业务问题?
2. 当前有哪些硬约束?
3. 候选方案有哪些?
4. 每个方案的主要收益是什么?
5. 每个方案的主要代价是什么?
6. 为什么最终选择这个?
7. 为什么没有选择其他方案?
8. 我们接受了什么风险?
9. 需要哪些后续动作降低风险?
10. 什么条件出现时要重新评估?

Atlas Action

建立一个 ADR 文件夹,并从下一次重大技术选择开始写,不追求补完历史。

docs/adr/001-use-kafka-for-learning-events.md

小结

ADR 的本质是把工程判断保存下来。

PM 写好 ADR,就是在替未来团队节省理解成本。