Update nexus wiki content

This commit is contained in:
2026-05-03 05:42:06 +08:00
parent 90f3811b83
commit 111bc65b7b
707 changed files with 32306 additions and 7289 deletions

View 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
- 架构决策记录