位于 workflows/ 目录下：

• new-project.md — 完整的新项目初始化工作流
• plan-phase.md — 含研究与验证的阶段规划工作流
• execute-phase.md — 基于 Wave 的执行编排器
• progress.md — 状态检查与智能路由至下一动作
• debug.md — 支持持久化状态的系统性调试工作流
• quick.md — 含 GSD 质量保障的即兴任务工作流（跳过可选智能体）
• discuss-phase.md — 通过自适应提问收集阶段上下文
• verify-work.md — 对话式 UAT，验证已构建功能
• map-codebase.md — 面向 Brownfield 项目的并行代码库分析
• pause-work.md — 中断执行时生成交接文档
• resume-work.md — 全上下文恢复执行
• add-todo.md — 捕获想法或任务以供后续处理
• check-todos.md — 列出并推进待办事项
• add-phase.md — 将新阶段追加至里程碑末尾
• insert-phase.md — 插入紧急小数阶段（如 1.1）
• remove-phase.md — 移除未来阶段并自动重编号
• new-milestone.md — 启动新里程碑周期
• complete-milestone.md — 存档里程碑并打标签
• audit-milestone.md — 核验里程碑完成质量
• settings.md — 配置工作流开关

智能体文件

位于 agents/ 目录下：

• gsd-project-researcher.md — 研究领域生态（技术栈、功能、架构、典型陷阱）
• gsd-phase-researcher.md — 研究特定阶段的实施路径
• gsd-research-synthesizer.md — 将并行研究成果整合为统一的 SUMMARY.md
• gsd-roadmapper.md — 基于需求与研究成果生成路线图
• gsd-planner.md — 为单个阶段生成详细执行计划
• gsd-plan-checker.md — 在执行前校验计划是否能达成阶段目标
• gsd-executor.md — 执行单个计划，按任务粒度提交（task-by-task commits）
• gsd-verifier.md — 通过比对 must_haves 与实际代码库验证阶段目标达成情况
• gsd-debugger.md — 基于科学方法开展调试，支持持久化状态
• gsd-codebase-mapper.md — 分析现有代码库，服务于 Brownfield 场景
• gsd-integration-checker.md — 验证跨阶段集成与端到端（E2E）流程

参考文件

位于 references/ 目录下：

• questioning.md — 深度提问技巧与上下文检查清单
• ui-brand.md — UI/UX 设计原则与品牌规范

模板文件

位于 templates/ 目录下：

• project.md — PROJECT.md 模板
• requirements.md — REQUIREMENTS.md 模板
• research-project/ — 研究输出模板（STACK、FEATURES、ARCHITECTURE、PITFALLS、SUMMARY）

工作流模式

GSD 采用“编排器 + 子智能体”（Orchestrator + Subagent）模式：

1. 编排器（工作流）— 始终驻留于主上下文，负责启动子智能体并调度整体流程
2. 子智能体（智能体）— 每次启动均使用全新上下文，专注单一任务，返回结构化结果
3. 迭代机制 — 规划 → 校验 → 再规划的闭环（planner → checker → planner），直至通过质量门禁

该设计带来以下优势：

• 轻量级编排器上下文（约占用 15% 上下文预算）
• 每个子智能体拥有完整新鲜上下文（100%）
• 天然支持并行执行（如 4 个研究员、Wave 内多计划并发）
• 前置验证，避免无效执行浪费资源