arch-design

name	arch-design
description	架构选型与设计方法论：架构模式对比、领域驱动设计、C4 模型图、ADR 架构决策记录、架构设计文档。 TRIGGER when: 系统架构选型、微服务 vs 单体选型、事件驱动/CQRS 评估、分层/六边形/洋葱架构、领域建模、限界上下文、聚合、画 C4 模型图、写 ADR、架构决策记录、输出架构设计文档。 DO NOT TRIGGER when: 方案评审（用 arch-review）、架构演进规划（用 arch-evolution）、全栈工程实践（用 arch-engineering）。

架构选型与设计

目标

为架构选型和设计提供结构化决策框架，确保每个决策有 trade-off 分析、关键决策有 ADR 记录、架构图用 C4 模型分层表达。

工作流

1. 领域发现

• 通过事件风暴识别领域事件和命令
• 映射限界上下文，划定模块边界
• 定义聚合根和不变量
• 建立上下文映射（上游/下游、防腐层、共享内核）

DDD 核心概念职责表和"何时不用 DDD"判断见： references/architecture-patterns.md（领域驱动设计指南节）

2. 架构选型

根据团队规模、业务复杂度和演进阶段选择架构模式。7 种模式对比矩阵（模块化单体/微服务/事件驱动/CQRS/分层/六边形/洋葱）见： references/architecture-patterns.md

核心决策原则：

• 小团队 + 边界不清晰 → 模块化单体
• 清晰领域 + 团队自治 → 微服务
• 松耦合 + 异步工作流 → 事件驱动
• 读写不对称 + 复杂查询 → CQRS
• 优先选择可逆决策而非"最优"决策

C4 模型画法规范（Mermaid/PlantUML 模板、命名规范、每层粒度、坏味道标红）见： references/c4-conventions.md

3. 决策记录

关键架构决策必须写 ADR。模板、示例和编号规范见： references/adr-guide.md

4. 架构设计文档

输出架构设计方案时遵循标准模板（12 节结构）见： references/architecture-spec-template.md

决策规则

• 每个抽象层必须证明其复杂性的合理性——不做架构宇航员
• 领域优先，技术其次——先理解业务问题再选工具
• 架构方案含至少两个备选选项及 trade-off 矩阵
• 关键决策附 ADR（Context → Decision → Consequences）
• 架构图用 C4 模型分层表达（Context / Container / Component / Code）