| name | xyz-harness-brainstorming |
| description | Phase 1 (spec) of the xyz-harness workflow. Explores user intent, requirements and design before implementation, produces spec.md. |
Dev-flow 上下文
| 项目 | 值 |
|---|
| 所在阶段 | Phase 1 (spec) brainstorming |
| 执行者 | 主 agent（交互 + 编排） |
| 上游 | 用户提出需求 |
| 下游（完成后进入） | Phase 2 (plan) — 加载 writing-plans skill |
关键变更（V2）
- Review-Gate 由 coding-workflow 扩展自动管理，skill 中不再手动 dispatch review subagent
- Gate Handoff 已删除，gate 检查在
coding-workflow-gate tool 内部自动执行
- Phase Transition 不再要求单独 session 跑 gate
完整流程
- Quick overview — 主 agent 快速浏览项目结构
- Ask clarifying questions — one at a time
- Propose 2-3 approaches — with trade-offs
- Present design — get user approval
- Assumption Audit — 验证所有假设
- Write design doc — save to
.xyz-harness/${topic}/spec.md
- Spec completeness check — verify six elements
- Terminology & ADR Step
- User reviews written spec
Goal 追踪
Brainstorming 完成后、编写 spec 前，提示用户使用 /goal 初始化任务追踪（任务列表：Write spec.md）。
这是 Phase 1 唯一需要用户手动触发 /goal 的阶段。Phase 2/3 起由 coding-workflow 扩展自动注入 Goal。
完成后
编写完 spec.md 后，调用 coding-workflow-gate(phase=1) 提交。
不要自行审查 spec，不要 dispatch review subagent。Gate tool 内部会自动：
- 启动 Review-Gate Workflow（循环审查 + 修复）
- Review-Gate 通过后自动触发 Phase-Gate（脚本检查）
- Phase-Gate 通过后自动触发 Retrospect
阶段完成
Phase-Gate 通过 + Retrospect 完成后，主 agent 收到 steer 指令调用 coding-workflow-phase-start() 进入 Phase 2。
