@boyingliu01/xp-gate 0.18.5 → 0.19.0

package/plugins/dsh/skills/sprint-flow/templates/auto-estimate-output-template.md

@@ -0,0 +1,110 @@
+# AUTO-ESTIMATE 输出模板
+
+本模板定义了 Phase 1/6 PREP 在终端向用户展示 AUTO-ESTIMATE 结果的标准格式。
+
+## 输出格式
+
+```
++-------------------------------------------------------------+
+| AUTO-ESTIMATE 评估结果                                        |
++-------------------------------------------------------------+
+| 需求：{task_description}                                      |
+| 类型：{change_type}                                          |
+|                                                             |
+| [{impact_level}] Impact: {impact_label}                      |
+|                                                             |
+| 引用：{ref_count} 处                                          |
+| 跨模块：{cross_module_count} 个 ({module_list})               |
+| 循环依赖：{circular_dep_status}                               |
+| Public API：{public_api_count} 个                             |
+| {additional_metrics}                                         |
+|                                                             |
+| 建议流程：{recommended_flow}                                  |
+|                                                             |
+| {risk_warning}                                               |
+|                                                             |
+| [接受建议]  [修改流程]  [取消]                                 |
++-------------------------------------------------------------+
+```
+
+## 字段说明
+
+| 字段 | 说明 | 示例 |
+|------|------|------|
+| `{task_description}` | 用户输入的需求描述 | 删除平面维护界面 |
+| `{change_type}` | 变更类型 | 删除/修改已存在代码 或 新增功能 |
+| `{impact_level}` | 影响级别标识 | `[轻量]` / `[标准]` / `[复杂]` |
+| `{impact_label}` | 影响级别标签 | 低 / 中 / 高 |
+| `{ref_count}` | 引用出现次数 | 12 |
+| `{cross_module_count}` | 跨模块数量 | 3 |
+| `{module_list}` | 涉及模块名列表 | auth, user, admin |
+| `{circular_dep_status}` | 循环依赖状态 | ✅ 无 / ⚠️ 存在 (A ↔ B) |
+| `{public_api_count}` | Public API 暴露数 | 5 |
+| `{additional_metrics}` | 附加指标（可选行） | 测试文件：4 个 / 影响范围：3 层调用 |
+| `{recommended_flow}` | 建议流程描述 | 轻量流程 (reduced-intensity Delphi) |
+| `{risk_warning}` | 风险警告（可选块） | ⚠️ 此操作涉及循环依赖… |
+| 操作按钮 | 用户确认选项 | 接受建议 / 修改流程 / 取消 |
+
+## 风险警告格式
+
+当检测到高风险信号时（循环依赖、大范围 Public API、>10 处引用），追加风险警告块：
+
+```
+|                                                             |
+| ⚠️ {risk_description}                                        |
+|   {mitigation_suggestion}                                    |
+|                                                             |
+```
+
+## 修改流程子菜单
+
+当用户选择「修改流程」时，展示以下选项：
+
+```
++-------------------------------------------------------------+
+| 选择流程级别：                                                |
+|                                                             |
+| [1] 轻量流程 — reduced DESIGN + 简化 Delphi + BUILD/VERIFY   |
+| [2] 标准流程 — brainstorming + Delphi + BUILD + VERIFY       |
+| [3] 完整流程 — 完整 Sprint Flow (6 phases)                   |
+|                                                             |
+| 修改原因（必填）：____________________                        |
+|                                                             |
+| [确认]  [取消]                                                |
++-------------------------------------------------------------+
+```
+
+## 指标计算规则
+
+### 对于删除/修改已存在代码
+
+| 指标 | 计算方式 | 工具 |
+|------|---------|------|
+| 引用计数 | `grep -rn "{target_pattern}" --include="*.{ext}" | wc -l` | bash |
+| 跨模块依赖 | 分析 import 语句中不同目录层级的引用 | bash + grep |
+| 循环依赖 | 检查 import 图是否存在环 | bash |
+| Public API 暴露 | `grep -rn "^export "` 计数 | bash |
+| 测试文件数 | `find . -name "*{target}*.test.*" | wc -l` | bash |
+
+### 对于新增功能（brainstorming 后）
+
+| 指标 | 计算方式 | 来源 |
+|------|---------|------|
+| 新增模块数 | 设计文档中列出的模块数 | Phase 2/6 DESIGN 输出 |
+| 跨系统集成 | 涉及 API/DB/外部 数量 | Phase 2/6 DESIGN 输出 |
+| 状态复杂度 | 状态机状态数 | Phase 2/6 DESIGN 输出 |
+| REQ 数量 | user_stories 数量 | Phase 2/6 DESIGN 输出 |
+
+## 路由决策表
+
+| 评估结果 | 路由 | 说明 |
+|---------|------|------|
+| **轻量** (引用 ≤3, 同模块，无循环依赖) | reduced DESIGN → 简化 Delphi → BUILD/VERIFY（6 phases, reduced intensity） | 低强度执行，仍需 DELPHI-GATE APPROVED |
+| **标准** (引用 4-10, 跨 1-2 模块) | 完整 DESIGN → BUILD → VERIFY（6 phases） | 标准 sprint |
+| **复杂** (引用 >10 或 循环依赖 或 跨 3+ 模块) | 完整 Sprint Flow（6 phases） | 完整流程 + 风险警告 |
+
+**所有流程路线均需在 Phase 3/6 BUILD 前获得 delphi-review APPROVED verdict。**
+
+## 学习闭环
+
+当用户选择「修改流程」时，记录 override 数据到 `.sprint-state/auto-estimate-learning.json`（追加模式），用于阈值迭代优化。

package/plugins/dsh/skills/sprint-flow/templates/emergent-issues-template.md

@@ -0,0 +1,120 @@
+# Emergent Issues Template
+
+## 使用说明
+
+此模板用于 Phase 6/6 CLOSE (USER ACCEPTANCE) 人工验收。
+
+⚠️ 这是 AI 无法预测的 UX/质量问题，只有实际使用才能发现。
+
+---
+
+# Emergent Issues - [需求名称]
+
+## 验收元信息
+
+```yaml
+验收日期: YYYY-MM-DD
+验收阶段: Phase 6/6 - CLOSE (USER ACCEPTANCE)
+验收人: [姓名]
+MVP 版本: v1.0
+Sprint ID: sprint-YYYY-MM-DD-NN
+```
+
+---
+
+## 检查清单
+
+### 1. 核心功能体验 (Core Functionality UX)
+
+- [ ] 功能是否按预期工作？
+- [ ] 输入 → 输出的流程是否流畅？
+- [ ] 边界情况处理是否正确？（空值、极限值、异常输入）
+- [ ] 错误处理是否友好？
+
+**发现的问题**:
+| 问题描述 | 严重程度 | 影响范围 | 发现场景 |
+|---------|---------|---------|---------|
+| [填写] | [Critical/Major/Minor] | [填写] | [填写] |
+
+---
+
+### 2. 多轮交互体验 (Multi-turn Interaction UX)
+
+- [ ] 多轮对话/操作是否连贯？
+- [ ] 上下文是否正确传递？
+- [ ] 用户意图理解是否准确？
+- [ ] 响应是否生硬/机械？
+
+**发现的问题**:
+| 问题描述 | 严重程度 | 影响范围 | 发现场景 |
+|---------|---------|---------|---------|
+| [填写] | [Critical/Major/Minor] | [填写] | [填写] |
+
+---
+
+### 3. 视觉/交互体验 (Visual/Interaction UX)
+
+- [ ] UI 元素是否清晰可辨？
+- [ ] 是否存在"看起来像按钮但不可点击"的元素？
+- [ ] 错误消息位置是否合理？
+- [ ] 响应时间是否满意？
+- [ ] 移动端/桌面端是否一致？
+
+**发现的问题**:
+| 问题描述 | 严重程度 | 影响范围 | 发现场景 |
+|---------|---------|---------|---------|
+| [填写] | [Critical/Major/Minor] | [填写] | [填写] |
+
+---
+
+### 4. 用户认知负担 (Cognitive Load)
+
+- [ ] 用户是否容易理解如何使用？
+- [ ] 是否需要额外学习/培训？
+- [ ] 概念/术语是否一致？
+- [ ] 流程是否符合用户心智模型？
+
+**发现的问题**:
+| 问题描述 | 严重程度 | 影响范围 | 发现场景 |
+|---------|---------|---------|---------|
+| [填写] | [Critical/Major/Minor] | [填写] | [填写] |
+
+---
+
+### 5. 意外发现 (Unexpected Observations)
+
+- [ ] 是否发现了未预期的用户行为？
+- [ ] 是否发现了新需求场景？
+- [ ] 是否发现了潜在优化点？
+
+**发现的问题**:
+| 问题描述 | 严重程度 | 影响范围 | 发现场景 |
+|---------|---------|---------|---------|
+| [填写] | [Critical/Major/Minor] | [填写] | [填写] |
+
+---
+
+## Emergent Issues Summary
+
+| 总计发现问题数 | Critical | Major | Minor |
+|---------------|----------|-------|-------|
+| [填写] | [填写] | [填写] | [填写] |
+
+---
+
+## 验收结论
+
+- [ ] ✅ 验收通过，进入 CLEANUP → Sprint 结束
+- [ ] ⚠️ 发现问题需 Sprint 2 迭代
+- [ ] ❌ 重大问题，需重新规划
+
+**验收人签名**: ________________  **日期**: ________________
+
+---
+
+## Next Step
+
+根据验收结论：
+- ✅ 验收通过 → 进入 Phase 6/6 CLOSE (CLEANUP) 自动执行
+- ⚠️ 发现问题 → 记录反馈 → 准备 Sprint 2 → 进入 CLEANUP
+- ❌ 重大问题 → Sprint 2 回到 Phase 2/6 DESIGN 重新规划

package/plugins/dsh/skills/sprint-flow/templates/pain-document-template.md

@@ -0,0 +1,115 @@
+# Pain Document Template
+
+## 使用说明
+
+此模板用于 Phase 2/6 DESIGN (brainstorming) 输出。基于 office-hours 六个强制问题验证需求真实性。
+
+---
+
+# Pain Document - [需求名称]
+
+## 元信息
+
+```yaml
+生成日期: YYYY-MM-DD
+生成阶段: Phase 2/6 - DESIGN
+来源: brainstorming / office-hours skill
+Sprint ID: sprint-YYYY-MM-DD-NN
+```
+
+---
+
+## 1. 需求现实 (Demand Reality)
+
+**真实用户是否真的需要这个？**
+
+[回答]
+
+**现在有什么替代方案？**
+
+[回答]
+
+**为什么他们还没有用替代方案？**
+
+[回答]
+
+---
+
+## 2. 当前状态 (Status Quo)
+
+**用户现在怎么解决这个问题？**
+
+[回答]
+
+**他们的现状有多糟糕？**
+
+[回答]
+
+---
+
+## 3. 绝望的具体性 (Desperate Specificity)
+
+**能否描述一个具体的用户场景？**
+
+[回答]
+
+**这个场景有多绝望？**
+
+[回答]
+
+---
+
+## 4. 最窄切入点 (Narrowest Wedge)
+
+**最小的可行切入点是什么？**
+
+[回答]
+
+**为什么这是"最窄"？**
+
+[回答]
+
+---
+
+## 5. 观察证据 (Observation)
+
+**你自己是否观察到这个问题？**
+
+[回答]
+
+**数据或访谈支持吗？**
+
+[回答]
+
+---
+
+## 6. 未来适配 (Future-fit)
+
+**这个需求在未来 3-5 年是否仍然存在？**
+
+[回答]
+
+**是否会被技术变化淘汰？**
+
+[回答]
+
+---
+
+## Pain Statement (一句话痛点)
+
+> [用一句话描述为什么这是真实痛点]
+
+---
+
+## Proposed Solution (建议方案)
+
+基于六个问题推导出的初步方案：
+
+[方案描述]
+
+---
+
+## Next Step
+
+- 进入 Phase 2/6 DESIGN (PLAN 阶段) 自动执行
+- 调用 autoplan + delphi-review 进行设计评审

package/plugins/dsh/skills/sprint-flow/templates/sprint-progress-template.md

@@ -0,0 +1,140 @@
+# Sprint Progress Template
+
+本模板定义了 Sprint 进度看板的标准显示格式。
+Orchestrator 在每个 Phase 完成后、以及响应用户 `--status` 查询时，使用此模板渲染进度。
+
+## 渲染规则
+
+1. 从 `.sprint-state/sprint-state.json` 读取 `id`, `task_description`, `phase`, `status`, `started_at`, `phase_history`, `outputs`, `isolation`
+2. 按下方模板渲染 ASCII 看板
+3. 状态图标映射：✅ completed | 🔄 running | ⏸️ paused | ⬜ pending | ⏭️ skipped | ❌ failed
+
+## 看板模板
+
+```
++============================================================+
+|  SPRINT PROGRESS                      {sprint_id}          |
++============================================================+
+|  需求: {task_description}                                   |
+|  分支: {branch}                                             |
+|  状态: {overall_status}        启动: {started_at}           |
++============================================================+
+|                                                             |
+|  {icon_1} Phase 1/6  PREP             {duration_1}          |
+|  {icon_2} Phase 2/6  DESIGN           {duration_2}          |
+|  {icon_3} Phase 3/6  BUILD            {duration_3}          |
+|  {icon_4} Phase 4/6  VERIFY           {duration_4}          |
+|  {icon_5} Phase 5/6  SHIP             {duration_5}          |
+|  {icon_6} Phase 6/6  CLOSE            {duration_6}          |
+|                                                             |
+|  [{progress_bar}] {pct}%                                    |
++============================================================+
+|  > 当前: Phase {current_phase}/6 {current_phase_name}       |
+|    状态: {current_phase_status}                              |
+|                                                             |
+|  下一步: {next_action}                                       |
+|    {next_action_detail}                                      |
++============================================================+
+|  输出物:                                                     |
+|    {output_list}                                             |
++============================================================+
+```
+
+## 字段说明
+
+| 字段 | 来源 | 说明 |
+|------|------|------|
+| `{sprint_id}` | `sprint-state.json → id` | Sprint 标识 |
+| `{task_description}` | `sprint-state.json → task_description` | 需求描述（缺失时显示 "-"） |
+| `{branch}` | `sprint-state.json → isolation.branch` | 工作分支 |
+| `{overall_status}` | `sprint-state.json → status` | running / paused / completed |
+| `{started_at}` | `sprint-state.json → started_at` | Sprint 启动时间（格式化: YYYY-MM-DD HH:MM） |
+| `{icon_N}` | `phase_history[N].status` | 状态图标（见上方映射） |
+| `{duration_N}` | `phase_history[N].duration_seconds` | 耗时（见下方格式化规则） |
+| `{current_phase}` | `sprint-state.json → phase` | 当前阶段编号 (1-6) |
+| `{current_phase_name}` | Phase 名称映射 | PREP / DESIGN / BUILD / VERIFY / SHIP / CLOSE |
+| `{current_phase_status}` | `phase_history` 中当前阶段的 status | running / paused / completed |
+| `{next_action}` | 下方"下一步行动表" | 用户需要执行的操作 |
+| `{next_action_detail}` | 操作细节 | 具体指令 |
+| `{output_list}` | `sprint-state.json → outputs` | 已生成的输出物路径列表（每项一行） |
+| `{progress_bar}` | 已完成阶段数 / 总阶段数 | 格式: `████▓░░░░░░` |
+| `{pct}` | 完成百分比 | 整数 |
+
+## 进度条生成规则
+
+```
+总阶段数 = 6（Phase 1/6, 2/6, 3/6, 4/6, 5/6, 6/6）
+已完成数 = phase_history 中 status == "completed" 的数量
+每个阶段 = 1 个字符宽度
+填充: 已完成 = █ | 当前 = ▓ | 待做 = ░ | 跳过 = ▒
+```
+
+## 下一步行动表
+
+| 当前阶段 | 当前状态 | 下一步行动 | 行动细节 |
+|---------|---------|-----------|---------|
+| Phase 1/6 | completed | 确认评估 | 查看 AUTO-ESTIMATE 结果，选择流程级别 |
+| Phase 1/6 | running | 等待隔离 | worktree 创建 + 评估中，无需操作 |
+| Phase 2/6 | completed | 确认设计评审 | delphi-review 已通过，检查 specification.yaml |
+| Phase 2/6 | paused | 等待设计 | brainstorming 或 delphi-review 等待 APPROVED |
+| Phase 2/6 | running | 等待规划 | brainstorming/autoplan 执行中，无需操作 |
+| Phase 3/6 | completed | 审阅代码 | BUILD 完成，进入 Phase 4/6 VERIFY |
+| Phase 3/6 | running | 等待构建 | ralph-loop 迭代中，无需操作 |
+| Phase 4/6 | completed | 确认发布 | 验证完成，反馈已收集，准备进入 Phase 5/6 SHIP |
+| Phase 4/6 | running | 等待验证 | code-walkthrough + QA + feedback 执行中 |
+| Phase 5/6 | completed | 确认验收 | PR 已创建 + 部署完成，准备进入 Phase 6/6 CLOSE |
+| Phase 5/6 | paused | 确认合并 | PR 已创建，确认是否合并 |
+| Phase 6/6 | completed | Sprint 完成 | 检查 Sprint Summary，如有 emergent issues 考虑 Sprint 2 |
+| Phase 6/6 | paused | 执行验收 | ⚠️ 必须人工验收，请实际使用后确认 |
+| 任意 | failed | 处理错误 | 查看错误信息，决定修复或放弃 |
+
+## 耗时格式化规则
+
+```
+< 60s     → "{N}s"
+< 60m     → "{N}m"
+< 24h     → "{X}h {Y}m"
+>= 24h    → "{X}d {Y}h"
+无数据    → "-"
+```
+
+## 向后兼容
+
+当 `sprint-state.json` 缺少以下字段时（旧版 sprint 创建的状态文件），渲染规则：
+- `task_description` 缺失 → 显示 "-"
+- `started_at` 缺失 → 显示 "-"
+- `phase_history` 缺失 → 从 `phase` 字段推断：小于等于 `phase` 的阶段标记为 ✅，当前阶段标记为 🔄，其余标记为 ⬜；所有耗时显示 "-"
+- **旧版 11-phase sprint-state.json**: phase 编号为 -1, -0.5, 0..8 的历史文件仍可渲染，但新 sprint 使用 1-6 numbering
+
+## 示例渲染
+
+```
++============================================================+
+|  SPRINT PROGRESS                      sprint-2026-07-08-01 |
++============================================================+
+|  需求: 为 sprint-flow 添加进度看板功能                       |
+|  分支: sprint/2026-07-08-01                                 |
+|  状态: running          启动: 2026-07-08 10:25              |
++============================================================+
+|                                                             |
+|  ✅ Phase 1/6  PREP             5m                           |
+|  ✅ Phase 2/6  DESIGN          12m                           |
+|  🔄 Phase 3/6  BUILD           15m                           |
+|  ⬜ Phase 4/6  VERIFY           -                            |
+|  ⬜ Phase 5/6  SHIP             -                            |
+|  ⬜ Phase 6/6  CLOSE            -                            |
+|                                                             |
+|  [██▓░░░] 50%                                                |
++============================================================+
+|  > 当前: Phase 3/6 BUILD                                    |
+|    状态: running                                             |
+|                                                             |
+|  下一步: 等待构建完成                                        |
+|    ralph-loop 迭代中，完成后自动进入 Phase 4/6 VERIFY        |
++============================================================+
+|  输出物:                                                     |
+|    设计文档: .sprint-state/phase-outputs/design-doc.md       |
+|    评审报告: .sprint-state/delphi-reviewed.json              |
+|    规格说明: .sprint-state/phase-outputs/specification.yaml  |
++============================================================+
+```

package/plugins/dsh/skills/sprint-flow/templates/sprint-summary-template.md

@@ -0,0 +1,121 @@
+# Sprint Summary Template
+
+## 使用说明
+
+此模板用于 Phase 6/6 CLOSE 结束时生成 Sprint 总结。
+
+---
+
+# Sprint Summary - [需求名称]
+
+## Sprint 元信息
+
+```yaml
+Sprint ID: sprint-YYYY-MM-DD-NN
+开始日期: YYYY-MM-DD
+结束日期: YYYY-MM-DD
+总耗时: [X hours/days]
+MVP 版本: v1.0
+最终状态: [completed/needs-sprint-2]
+```
+
+---
+
+## 阶段执行统计
+
+| Phase | 耗时 | 状态 | 暂停次数 | 备注 |
+|-------|------|------|---------|------|
+| 1/6: PREP | [X min] | ✅ 完成 | 0 | worktree + 规模评估 |
+| 2/6: DESIGN | [X min] | ✅ 完成 | [N] | brainstorming + delphi-review |
+| 3/6: BUILD | [X min] | ✅ 完成 | [N] | ralph-loop + TDD |
+| 4/6: VERIFY | [X min] | ✅ 完成 | [N] | code-walkthrough + QA + feedback |
+| 5/6: SHIP | [X min] | ✅ 完成 | [N] | PR + deploy + canary |
+| 6/6: CLOSE | [X min] | ✅ 完成 | 1 (UAT 必须) | 人工验收 + cleanup |
+
+---
+
+## Skills 调用统计
+
+| Skill | 调用次数 | 结果 | 备注 |
+|-------|---------|------|------|
+| brainstorming | 1 | ✅ | design doc |
+| autoplan | 1 | ✅/⚠️ | [taste_decisions 数量] |
+| delphi-review (design) | [N] rounds | ✅ APPROVED | [Round 数量] |
+| delphi-review (code-walkthrough) | [N] rounds | ✅ APPROVED | [Round 数量] |
+| to-issues | 1 | ✅ | slices-manifest.json |
+| test-driven-development | [N] | ✅ | BUILD 内部调用 |
+| test-specification-alignment | 1 | ✅ | [覆盖率] |
+| browse | 1 | ✅ | [QA 通过] |
+| qa (web) | 1 | ✅ | [health score] |
+| benchmark (web) | 1 | ✅ | [perf baseline] |
+| learn | 1 | ✅ | [记录数量] |
+| retro | 1 | ✅ | Sprint 回顾 |
+| ship | 1 | ✅ | [PR URL] |
+| land-and-deploy | 1 | ✅ | [部署 URL] |
+| canary | 1 | ✅ | [监控正常] |
+
+---
+
+## Emergent 发现统计
+
+| 类别 | 数量 | 处理状态 | 备注 |
+|------|------|---------|------|
+| Critical | [N] | [自动 Sprint 2] | [描述] |
+| Major | [N] | [询问用户] | [描述] |
+| Minor | [N] | [可选纳入 Sprint 2] | [描述] |
+
+---
+
+## 交付物清单
+
+| 交付物 | 路径 | 状态 |
+|-------|------|------|
+| Pain Document | `.sprint-state/phase-outputs/pain-document.md` | ✅ |
+| Specification | `.sprint-state/phase-outputs/specification.yaml` | ✅ |
+| MVP v1 | `.sprint-state/phase-outputs/mvp-v1/` | ✅ |
+| Review Report | `.sprint-state/phase-outputs/review-report.md` | ✅ |
+| Emergent Issues | `.sprint-state/phase-outputs/emergent-issues.md` | ✅/⚠️ |
+| Feedback Log | `.sprint-state/phase-outputs/feedback-log.md` | ✅ |
+| Sprint Summary | `.sprint-state/phase-outputs/sprint-summary.md` | ✅ |
+
+---
+
+## 关键决策记录
+
+| 决策点 | 选项 | 选择 | 理由 |
+|-------|------|------|------|
+| [决策1] | [A/B] | [选择] | [理由] |
+| [决策2] | [A/B] | [选择] | [理由] |
+
+---
+
+## Sprint 2 建议（如有 emergent issues）
+
+```yaml
+Sprint 2 触发: [auto/user-confirm/none]
+Sprint 2 Pain Document: sprint2-pain.md
+
+Critical Issues (自动纳入):
+  - [Issue 1]
+  - [Issue 2]
+
+Major Issues (建议纳入):
+  - [Issue 1]
+
+Minor Issues (可选纳入):
+  - [Issue 1]
+```
+
+---
+
+## 下一步行动
+
+根据 Sprint 状态：
+- ✅ Sprint 完成 → 结束流程
+- ⚠️ 有 emergent issues → 提示用户是否开始 Sprint 2
+- ❌ Sprint 失败 → 记录失败原因，结束流程
+
+---
+
+**Sprint 结束时间**: YYYY-MM-DD HH:MM:SS
+**报告生成人**: sprint-flow skill

package/plugins/dsh/skills/sprint-flow/tools.md

@@ -0,0 +1,29 @@
+# Tools Whitelist — Sprint Flow
+
+Sprint Flow is an **orchestration skill** that coordinates subagents and system commands.
+It does NOT implement code directly — it delegates implementation to subagents.
+
+## Allowed Tools
+
+| Tool | Usage | Rationale |
+|------|-------|-----------|
+| `Bash(git, gh, npm, node)` | git worktree/branch/commit, gh PR/release, npm/node CLI | Required for sprint infrastructure management |
+| `Read` | Read project files, configs, docs | Required for context gathering |
+| `Write` | Write sprint-state, specification.yaml, phase summaries | Required for sprint state persistence |
+| `Edit` | Edit sprint-state, CHANGELOG, VERSION | Required for version management |
+| `Glob` | Find project files by pattern | Required for project discovery |
+| `Grep` | Search file contents | Required for codebase understanding |
+| `Task` | Delegate to subagents (quick, deep, unspecified-high) | Core orchestration mechanism |
+| `Skill` | Invoke integrated skills (brainstorming, autoplan, delphi-review, etc.) | Required for skill chain execution |
+| `TodoWrite` | Track sprint progress | Required for progress visibility |
+| `Question` | Ask user at decision gates | Required for user decision points |
+
+## Denied Tools
+
+| Tool | Rationale |
+|------|-----------|
+| `rm -rf (any recursive force remove)` | Destructive — sprint flow only cleans up via `git worktree remove` |
+| `git push --force` | Destructive — never force push during sprint |
+| `DROP TABLE or destructive DB operations` | Destructive — sprint flow orchestrates, does not manage databases |
+| `Write(source code)` | Sprint flow NEVER writes implementation code directly — delegates to subagents via `Task` |
+| `Edit(source code)` | Sprint flow NEVER edits implementation code — delegates to subagents via `Task` |