再聊对架构决策记录的一些思考
内容提要
本文介绍了ADR的重要性和实践方法，ADR可以加速了解系统、降低认知成本，并在团队间高效同步决策知识。建议团队先进行ADR讨论和决策共识，保持ADR轻量化和开放的技术氛围。ADR具有高潜在价值，推荐团队实践。
延伸解读
技术方案为何难以替代ADR
文章指出，技术方案通常是长文档，容易过期且缺乏维护，并且散落在不同迭代中，难以整合。更重要的是，技术方案只体现决策结果，无法反映决策的演进过程和上下文。因此，仅靠技术方案追溯系统关键决策面临挑战，而ADR能弥补这些不足。
团队排斥ADR的常见原因与应对
技术人员排斥ADR主要源于三点：不愿花精力写文档、对评审有误解、不确定何时该写。文章建议保持ADR模板简单轻量，打破对文档化的固有认知；同时明确系统负责人可感知的影响较大的决策场景，如新建子系统、引入新技术组件、工程结构重大调整等，让实践有据可依。
ADR的核心价值在于共识而非留存
文章强调，ADR的关键价值不仅在于决策的留存和追溯，更在于通过干系人讨论使决策知识在团队间高效同步。共同参与、共识的决策更容易落地。因此，开放的技术氛围至关重要，应避免一言堂和强压式决策，让成员充分抛出观点和疑问，直至达成共识。
ADR与敏捷文化的契合点
文章认为，敏捷文化推行的轻文档机制与轻量级ADR并不冲突，两者相契合。在自组织团队中，ADR天然适合引入，因为它强调轻量、共识和开放讨论，这与敏捷原则一致。团队可以先从一个小ADR做起，邀请成员讨论，逐步培养习惯。
Q&A
什么是ADR，它的主要作用是什么？
ADR（架构决策记录）是记录架构决策的工具，主要作用是加速系统了解和降低认知成本。
团队在实施ADR时常见的挑战有哪些？
团队常见的挑战包括对文档化的抵触、对评审的误解以及缺乏实践准则。
如何解决团队对ADR的排斥？
可以通过保持ADR模板简单轻量，打破对文档化的固有认知来解决团队的排斥。
ADR在团队决策中有什么关键价值？
ADR的关键价值在于通过讨论实现决策知识的高效同步，促进团队共识。
实施ADR时，团队应该如何保持开放的技术氛围？
团队应避免一言堂和强压式决策，鼓励成员参与讨论，提出观点和疑问。
为什么ADR与敏捷文化相契合？
ADR与敏捷文化相契合，因为它推行轻文档机制，适合在自组织团队中引入。
