# Architecture Decision Records

ADR 用于记录重要架构决策。

创建 ADR 的场景：

- 技术栈替换
- 核心架构改变
- 数据模型改变
- Agent Runtime 机制改变
- 安全边界改变
- 基础设施选型改变

建议状态：

- Proposed
- Accepted
- Superseded
- Deprecated

模板：

```text
# ADR-XXX: Title

## Status

Proposed

## Context

为什么需要做这个决策？

## Decision

最终决定是什么？

## Alternatives

考虑过哪些方案？

## Consequences

优点、缺点、风险。

## Related Documents

相关文档。
```