---
name: architecture-design-workflow
type: procedure
when: '架构设计, 架构, architecture, 设计系统, 多端设计, 系统设计, 技术方案设计, 模块划分, 技术方案, 方案设计, 架构评审'
scope:
  - backend
  - frontend
  - infrastructure
products:
  - '*'
owner_mechanism_id: mc-architecture-design
consumed_contracts:
  - architecture_decision_workshop_contract
  - design_artifact_pack_contract
  - architecture_design_contract_entry
  - technology_decision_contract
  - brainstorm_contract
  - detail_discipline_contract
  - first_principles_contract
required_sections:
  - 输入集确认
  - 输出目录决策
  - 技术栈策略
  - 前端仓库策略
  - 不确定项决策
  - Mermaid 图要求
  - 架构设计审查
hard_rules:
  - 正式架构设计前必须完成六类架构决策研讨并引用用户确认的决策记录
  - 架构设计必须进入包含数据库、API、OpenAPI/SQL 和一致性报告的设计产物包复验流程
  - 输出目录名必须给推荐并进入用户确认；未确认时不得 delivered
  - 后端必须默认优先 Java，除非存在项目证据或用户确认 override
  - 前端必须默认优先最新稳定 Vue 生态 + TypeScript，除非存在项目证据或用户确认 override
  - 不同前端端必须默认不同项目仓库或独立应用边界；合并仓库必须用户确认
  - 不确定项必须包含推荐、理由、备选、风险和用户确认问题
  - 架构级不确定项必须接 Brainstorm / Decision Sovereignty / User Confirmation
  - 关键业务流程必须有 Mermaid sequenceDiagram
  - Mermaid 必须可渲染
acceptance_checks:
  - ArchitectureDesignContract 已创建且 status 非 pending
  - 输出目录决策 status 为 confirmed
  - 所有 required_source_artifacts 已覆盖
  - Mermaid 图 render_check_status 为 passed
  - 架构设计审查 review.passed 为 true
id: ka-procedure-架构设计工作流
asset_kind: procedure
lifecycle_status: active
authority: supporting
routes:
  - code_change
primary_triggers:
  - 架构设计工作流
secondary_triggers: []
negative_triggers: []
priority: P1
specificity: 5
consumes:
  - mc-architecture-design
emits:
  - architecture_design_contract
  - design_artifact_pack
  - architecture_decision_records
required_evidence:
  - workflow_id
  - required_mechanisms
version: 1.1.0
last_reviewed: '2026-06-01'
stages: ["架构设计", "详细设计"]
---

## 适用场景
从多个 task 输入（原型说明、需求文档等）到完整架构设计产出的工作流。适用于多端、多模块、有不确定项的系统设计。

## 步骤
1. **输入集确认**: 识别所有 task-* 目录下的原型说明及需求文档，确认覆盖所有端
2. **架构决策研讨**: 逐域闭合业务流程、数据、安全、后端、前端和基础设施决策，生成 `00-架构决策记录.md`
3. **输出目录决策**: 给出推荐目录名，等待用户确认
4. **技术栈策略**:
   - 后端默认 Java 优先（项目证据或用户确认可 override）
   - 前端默认最新稳定 Vue 生态 + TypeScript（语言、构建工具、路由、状态管理、接口类型、测试、lint/format）
   - 项目已有技术栈优先于 SoloForge 默认
5. **前端仓库策略**: 不同前端端默认不同仓库；合并仓库需用户确认
6. **不确定项决策**: 每个不确定项包含推荐、理由、备选、风险和用户确认问题
7. **架构级不确定项**: 接入 Brainstorm → Decision Sovereignty → User Confirmation
8. **设计产物包**: 架构、数据库、API、OpenAPI/SQL 和一致性报告按权威来源联动生成/升级
9. **Mermaid 图**: 关键业务流程、登录鉴权、跨端协作、前后端交互、异步任务必须有 sequenceDiagram
10. **架构设计审查**: reviewArchitectureDesign 与 DesignArtifactPack 真实复验通过

## 检查点
- [ ] 所有 task-* 输入已识别并覆盖
- [ ] 六类架构决策均已确认并记录 decision refs
- [ ] 输出目录已用户确认
- [ ] 技术栈有项目证据或用户确认支撑
- [ ] 不确定项全部有推荐和用户确认问题
- [ ] Mermaid sequenceDiagram 覆盖关键流程
- [ ] reviewArchitectureDesign passed
- [ ] 设计产物包进入 implementation_ready

## 禁止退化
- 未确认目录不得 delivered
- 缺少 Mermaid 图不得 completed
- 六类决策未确认或设计产物包未复验不得 completed
- 架构级决策无 human gate 不得 approved
- 模版章节缺失不得 completed
