cc-devflow 4.5.9 → 4.5.11

package/.claude/skills/cc-investigate/PLAYBOOK.md

@@ -5,7 +5,7 @@
 `cc-investigate -> cc-do -> cc-check`
 
 - Enter from: a bug, regression, or broken requirement whose root cause is still unclear.
-- Stay in: `cc-investigate` until `planning/analysis.md` and the repair handoff are both frozen.
+- Stay in: `cc-investigate` until `planning/tasks.md#Root Cause Contract` and the repair handoff are both frozen.
 - Exit to: `cc-do` only after root cause, repair boundary, and source roadmap progress are explicit in canonical artifacts.
 - Reroute to: `cc-plan` for scope/design truth changes, or `roadmap` for project-level priority decisions.
 
@@ -16,7 +16,7 @@
 3. 先确认 loop 复现的是用户报告的同一个失败。
 4. 先看最近变化，再决定是不是 regression。
 5. 先证伪假设，再冻结根因。
-6. `planning/analysis.md` 和 `planning/tasks.md` 必须足够让 `cc-do` 脱离当前会话继续工作。
+6. `planning/tasks.md` 必须足够让 `cc-do` 脱离当前会话继续工作。
 7. 调查失败三次后先重建入口，不准继续乱补。
 8. 没有 frozen root-cause contract，不准进入 repair task。
 9. 多组件、深层调用、flaky 问题必须先补边界探针、反向追踪或条件等待证据。
@@ -24,6 +24,7 @@
 11. workflow forensics 先分类 artifact / git / state / tool / permission / process failure，再决定是否进入修复。
 12. 退出前必须跑 Roadmap Sync Gate：`implementation drift`、`missing spec truth`、`roadmap mismatch` 三种结论都要让 source RM 的状态和 next action 跟上。
 13. Root Cause Proof Ladder 必须证明 symptom site、first bad state、violated contract、original trigger、counterfactual proof 和 escape reason。
+14. 分配 `FIX-*` change key 后立刻执行 Worktree Branch Contract：detached worktree 先挂到 `FIX/<task>`；当前在 `main` / default branch 时停止，不写 investigation artifacts。
 
 ## Iron Law
 
@@ -44,11 +45,10 @@ root-cause contract 至少包含：稳定复现或缩小后的可验证症状、
 5. `L5 Counterfactual Proof`：恢复 contract 或替换输入后，症状变化的实际观察。
 6. `L6 Escape Reason`：为什么测试、类型、review、监控或 artifact gate 没挡住。
 
-缺 `L2`、`L4` 或 `L5` 时，`analysis.md` 只能写 `needs-more-evidence`、`Evidence Request` 或 reroute，不能生成 `cc-do` repair task。
+缺 `L2`、`L4` 或 `L5` 时，`planning/tasks.md#Root Cause Contract` 只能写 `needs-more-evidence`、`Evidence Request` 或 reroute，不能生成 `cc-do` repair task。
 
 ## Required Outputs
 
-- `planning/analysis.md`
 - `planning/tasks.md`
 - `planning/task-manifest.json`
 - `change-meta.json`
@@ -76,7 +76,7 @@ root-cause contract 至少包含：稳定复现或缩小后的可验证症状、
 | `backward-trace` | 错误出现在深层堆栈或坏值来源不明 | 从 immediate failure site 反追 original trigger |
 | `reference-compare` | 同仓库有相似可用路径 | 列出 working / broken 差异并逐项接受或排除 |
 | `condition-wait` | flaky、sleep、timeout、重试后消失 | 找真实等待条件，不先加大延时 |
-| `history-trace` | 同一区域反复坏 | 查历史 `analysis.md`、TODO、report-card finding |
+| `history-trace` | 同一区域反复坏 | 查历史 `planning/analysis.md`、TODO、report-card finding |
 | `pattern-research` | 陌生框架 / 依赖 / 平台错误 | 脱敏后查通用错误类型 |
 | `contract-check` | 修复边界可能扩大 | 判定 implementation drift / missing spec truth / roadmap mismatch |
 | `diagnose-only` | 用户只要问题解释或现在不能修 | 冻结 root cause、owner、risk、next action，不生成实现完成态 |
@@ -101,7 +101,7 @@ root-cause contract 至少包含：稳定复现或缩小后的可验证症状、
 
 ## Boundary And Trace Evidence
 
-复杂链路必须在 `analysis.md` 写清：
+复杂链路必须在 `planning/tasks.md#Root Cause Contract` 写清：
 
 - Boundary Probe Matrix：component boundary、input observed、output observed、config/env observed、state observed、verdict
 - Backward Trace Chain：immediate failure site、caller chain、bad value origin、original trigger、why symptom-site fix is rejected
@@ -125,7 +125,7 @@ root-cause contract 至少包含：稳定复现或缩小后的可验证症状、
 3. `TODOS.md`、backlog、roadmap 中的相关项
 4. 既有 `planning/analysis.md` 和 `review/report-card.json`
 
-命中历史时，写入 `analysis.md` 的 `Prior Investigations`，说明这次是复发、同类结构味道，还是无关历史。
+命中历史时，写入 `planning/tasks.md#Root Cause Contract` 的 `Prior Investigations`，说明这次是复发、同类结构味道，还是无关历史。
 
 ## Domain And Decision Context
 
@@ -173,14 +173,15 @@ root-cause contract 至少包含：稳定复现或缩小后的可验证症状、
 
 ## Local Kit
 
-- 模板在 `assets/`
+- 默认模板在 `assets/TASKS_TEMPLATE.md` 和 `assets/TASK_MANIFEST_TEMPLATE.json`
+- 旧分析模板在 `assets/legacy/`，只用于 legacy fallback / migration
 - 调查契约在 `references/investigation-contract.md`
 - 需要分析骨架时用 `scripts/bootstrap-analysis.sh`
 - Roadmap 回写使用 `../cc-roadmap/scripts/locate-roadmap-item.sh` 和 `../cc-roadmap/scripts/sync-roadmap-progress.sh`
 
 ## Exit Rule
 
-只有当下一位执行者读完 `planning/analysis.md`、`planning/tasks.md`、`planning/task-manifest.json` 就知道：
+只有当下一位执行者读完 `planning/tasks.md`、`planning/task-manifest.json` 就知道：
 
 - 为什么坏
 - 该修什么