Update nexus wiki content
This commit is contained in:
50
wiki/concepts/ArchitectureDecisionRecord.md
Normal file
50
wiki/concepts/ArchitectureDecisionRecord.md
Normal file
@@ -0,0 +1,50 @@
|
||||
---
|
||||
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
|
||||
- 架构决策记录
|
||||
Reference in New Issue
Block a user