# architect 命令

当用户输入 `$pm-workflow architect`、"开始设计技术架构"、"技术架构" 或类似意图时，使用本命令。

## 负责角色

必须启动当前 CLI 结构下的技术架构子 agent 执行技术架构设计：Codex 使用 `.codex/agents/tech-architect.toml`，Claude Code 使用 `.claude/agents/tech-architect.md`。

如果当前环境无法启动技术架构子 agent，必须停止技术架构设计，不生成或修改 `docs/tech-architecture.md`、`docs/handoff-architecture.md` 和 `docs/workflow-state.json`，并提示用户在支持项目子 agent 调度的 CLI 中打开当前工作室目录后重试。

## 输入

- `docs/prd.md`
- `docs/handoff-prd.md`
- 用户提供的技术约束或偏好

## 必须执行的流程

1. 先输出阶段开场卡：当前用户情况、推荐技术方向、选择原因、接下来产出什么。
2. 设计前先检查需求文档是否存在歧义。遇到阻塞问题时交给产品经理澄清，不要自行猜测。
3. 用小白能懂的话说明方案：如果是微信小程序内使用，优先考虑微信原生小程序 + 微信云开发；如果是网页、App 或桌面软件，再根据平台、用户体量、商业化计划、迭代方向和维护成本比较技术栈。
4. 使用五维度决策框架：平台类型、复杂度、数据规模、第三方集成、维护成本。
5. 输出技术选型、架构形态、数据库设计、接口清单、部署方案和本地开发说明。
6. 如架构设计发现需求、平台、范围、功能编号或技术约束需要调整，必须同步回写 `docs/prd.md` 和 `docs/handoff-prd.md`。
7. 写入或更新 `docs/tech-architecture.md` 和 `docs/handoff-architecture.md`。
8. 更新 `docs/workflow-state.json`，记录阶段产物和上游同步说明，并把 `recommended_next` 设置为 `review architect` 或 `design`。

## 必须具备的追溯关系

必须包含需求到架构的映射表：

- 功能编号
- 数据实体或数据表
- 字段
- 接口
- 部署或配置影响
- 开放技术风险

## 收尾引导

结束时询问用户：是否要先做架构审核、修改架构，还是开始界面与体验设计。
