---
title: "Architecture Decision Record"
type: concept
tags: []
last_updated: 2026-05-01
---

## Definition
Architecture Decision Record（架构决策记录）是一种轻量级文档，用于捕获架构决策的上下文、选项和理由。ADR 记录的是"为什么这样做"，而不仅仅是"做了什么"。

## ADR Format

```markdown
# ADR-001: [Decision Title]

## Status
Proposed | Accepted | Deprecated | Superseded by ADR-XXX

## Context
What is the issue that we're seeing that is motivating this decision?

## Decision
What is the change that we're proposing and/or doing?

## Consequences
What becomes easier or harder because of this change?
```

## Key Elements
- **Status**：Proposed（提议中）/ Accepted（已接受）/ Deprecated（已废弃）/ Superseded（被替代）
- **Context**：驱动决策的问题或背景
- **Decision**：具体的决策内容
- **Consequences**：决策的后果——什么变得更容易，什么变得更难

## Core Principles
- **记录 WHY，而非 WHAT**：代码已经说明了"做了什么"，ADR 应该说明"为什么这样做"
- **可追溯性**：随着系统演进，ADR 提供了决策的历史脉络
- **知识共享**：新成员可以通过 ADR 理解架构决策的背景

## Related Concepts
- [[SoftwareArchitect]]：ADR 是 Software Architect Agent 的核心工具之一
- [[DomainDrivenDesign]]：ADR 常用于记录领域模型的边界决策

## Sources
- [[engineering-software-architect]]

## Aliases
- ADR
- Architecture Decision Record
- 架构决策记录