Martin Fowler
·
Bliki：架构决策记录
内容提要
架构决策记录（ADR）是简短文档，记录产品或生态系统的单一决策，包括决策内容、背景和影响。ADR应简洁明了，通常一页，便于理解和讨论。每个ADR都有状态，如“提议”、“接受”或“取代”。在记录决策时需考虑替代方案及其利弊，并明确决策的后果和不确定性。ADRs在建议过程中促进团队对齐和专业知识的引导。
关键要点
-
架构决策记录（ADR）是简短文档，记录与产品或生态系统相关的单一决策。
-
ADR应简洁明了，通常一页，包含决策内容、背景和影响。
-
每个ADR都有状态，如“提议”、“接受”或“取代”。
-
记录决策时需考虑替代方案及其利弊，并明确决策的后果和不确定性。
-
ADR促进团队对齐和专业知识的引导，帮助澄清思维。
-
建议将ADR保存在代码库的源代码仓库中，便于访问。
-
每个ADR应为单独文件，按单调序列编号，并包含决策名称。
-
一旦ADR被接受，不应重新打开或更改，而应被取代。
-
ADR应包含决策的简要理由和考虑的替代方案。
-
决策通常在不确定性下做出，应记录决策的信心水平。
-
ADR在建议过程中起到中心作用，记录决策并引导专业知识。
-
保持ADR简短且切中要点，通常为单页，支持材料可链接。
-
ADR不仅适用于软件架构，也适用于其他上下文中的决策记录。
-
Michael Nygard于2011年首次提出“架构决策记录”一词，强调轻量文档的重要性。
延伸解读
ADR的结构与重要性
架构决策记录（ADR）不仅是决策的记录工具，更是团队沟通与思维澄清的重要手段。通过书写ADR，团队成员能够更好地理解决策背后的原因和影响，从而促进不同观点的讨论与解决。保持ADR简洁明了，有助于快速传达关键信息，避免冗长的文档造成的理解障碍。
决策记录的管理与存储
将ADR存储在代码库中，能够确保相关人员随时访问和参考。这种做法不仅提高了透明度，还能帮助团队在面对不确定性时，快速回顾和评估过去的决策。建议使用轻量级标记语言编写ADR，以便于阅读和版本对比，确保文档的可维护性。
决策的后果与不确定性
每个ADR都应明确记录决策的后果及其不确定性。这不仅有助于团队理解当前决策的影响，还能为未来的决策提供参考。记录决策的信心水平和触发重新评估的条件，可以帮助团队在环境变化时及时调整策略，保持灵活性。
延伸问答
什么是架构决策记录（ADR）？
架构决策记录（ADR）是简短文档，记录与产品或生态系统相关的单一决策，包括决策内容、背景和影响。
ADR的主要组成部分有哪些？
ADR通常包括决策内容、背景、影响、状态、替代方案及其利弊，以及决策的信心水平。
如何有效地记录ADR？
记录ADR时应保持简洁明了，通常为单页，并考虑替代方案及其利弊，明确决策的后果和不确定性。
ADR的状态有哪些？
ADR的状态包括“提议”、“接受”和“取代”，每个状态反映了决策的当前阶段。
为什么要将ADR保存在代码库中？
将ADR保存在代码库中可以方便团队成员访问，确保决策记录与相关代码紧密关联。
架构决策记录的历史背景是什么？
架构决策记录的概念由Michael Nygard于2011年首次提出，强调轻量文档的重要性。
