aios/docs/aios-v2/adr/README.md

AIOS V2 Architecture Decision Records

本目录记录影响多个模块、长期演进、兼容性、安全或交付流程的关键架构决策。

ADR 列表

ADR	决策
ADR-001	AIOS 作为唯一控制面
ADR-002	OpenClaw/Hermes 与控制面解耦
ADR-003	所有变更必须通过 GitOps
ADR-004	多租户隔离默认拒绝
ADR-005	文档与代码同步门禁
ADR-006	候选持久化采用可替换 SQLite Snapshot

ADR 状态

• Proposed：提出但未采纳。
• Accepted：当前有效决策。
• Superseded：被新 ADR 替代。
• Deprecated：保留历史但禁止新实现采用。

何时必须新增或更新 ADR

以下变化必须新增或更新 ADR：

1. 控制面与 Runtime 权限边界变化；
2. 多租户隔离模型变化；
3. API、数据模型或状态机出现不兼容变化；
4. 持久化、消息、密钥、审计或部署方案发生跨模块变化；
5. GitOps、发布、回滚或文档门禁变化；
6. 替换 OpenClaw、Hermes、Agent Router 或核心基础设施。

ADR 变化必须同步更新：

• 02-TARGET-ARCHITECTURE.md
• 04-MODULE-CONTRACTS.md
• 05-TRACEABILITY-MATRIX.md
• 对应代码、测试和部署资产