核心问题

ADR、PRD、技术方案分别解决什么问题?

真实场景

团队有 PRD,也有技术方案,但半年后仍然没人知道为什么当初做某个技术选择。

因为 PRD 和技术方案都不是专门记录决策权衡的。

常见误区

坏判断是:

文档已经很多了,不需要 ADR。

问题不在文档数量,而在文档类型是否覆盖了“为什么”。

工程视角

三类文档的职责不同:

PRD:用户需要什么,业务目标是什么。
技术方案:系统如何实现,接口和模块怎么设计。
ADR:为什么选择这个方案,而不是其他方案。

它们互补,不互相替代。

PM 可以怎么做

PM 可以维护三者之间的连接:

  • PRD 里链接相关 ADR。
  • ADR 里说明对应业务目标。
  • 技术方案里引用已接受的 ADR。
  • 需求变更时检查 ADR 是否需要重评。

Atlas Action

下次重大需求建立文档关系:

PRD -> 技术方案 -> ADR

每个重要技术决策都应该能追溯到业务目标。

小结

PRD 讲“要什么”,技术方案讲“怎么做”,ADR 讲“为什么这样做”。

PM 能把三者连起来,就能让产品和工程拥有同一份上下文。