Martin Fowler
·
Bliki：架构决策记录
💡
原文英文，约900词，阅读约需4分钟。
📝
内容提要
架构决策记录（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保存在代码库中可以方便团队成员访问，确保决策记录与相关代码紧密关联。
架构决策记录的历史背景是什么？
架构决策记录的概念由Michael Nygard于2011年首次提出，强调轻量文档的重要性。
➡️
