cc-devflow 4.5.10 → 4.5.11

package/.claude/skills/cc-investigate/assets/TASKS_TEMPLATE.md

@@ -18,6 +18,7 @@
 - Open for root-cause doubt: `planning/tasks.md#Root Cause Contract` Project Postmortem Recall, Feedback Loop, Evidence Chain, Boundary Probe Matrix.
 - Open for scheduling: `planning/task-manifest.json`, dependencies, touched files.
 - Open for audit/recovery: Git state, CLI logs, report-card findings, Workflow Forensics.
+- Machine JSON rule: after editing this file, run `cc-devflow task-contract compile --change <changeId> --change-key <changeKey>` and `cc-devflow task-contract validate --change <changeId> --change-key <changeKey>`; do not handwrite `task-manifest.json` or `change-meta.json`.
 
 ## Root Cause Contract
 
@@ -59,6 +60,8 @@ Risk / Escalate If:
 > This is the default human-authored investigation contract. Do not create
 > `planning/analysis.md` for new investigations unless the user explicitly
 > requests a legacy artifact or a migration requires preserving one.
+> `task-manifest.json` and `change-meta.json` are generated by
+> `cc-devflow task-contract compile`, not by manual AI JSON authoring.
 
 ## Execution Handoff
 
@@ -88,32 +91,32 @@ Risk / Escalate If:
 - Parallel boundaries:
 - Correct test seam:
 - Evidence request if blocked:
-- Do not repair symptom site unless analysis proves it is the original trigger:
+- Do not repair symptom site unless Root Cause Contract proves it is the original trigger:
 
 ## Phase 1: Reproduce And Probe Guard
 
 - [ ] T001 [TEST] Capture the failing behavior as a stable reproduction (dependsOn:none) `path/to/test`
   Goal: 让 bug 先变成一个快、准、可复跑且匹配用户症状的失败事实。
   Files: `path/to/test`
-  Read first: `analysis.md`, `tasks.md`
+  Read first: `tasks.md`
   Project postmortem search: `rg -n "<symptom|test seam|module|model-risk>" devflow/postmortems` or record `no-project-postmortems-yet`
   Verification: `npm test -- path/to/test`
   Evidence: failing output or reproducible log + symptom match evidence
   Correct seam: test must exercise the real trigger chain through a public interface
   Root cause proof: must expose or preserve evidence for first bad state and original trigger
-  Ready when: feedback loop 已稳定，analysis 已记录必要的 boundary / trace / comparison / root-cause-ladder evidence
+  Ready when: feedback loop 已稳定，Root Cause Contract 已记录必要的 boundary / trace / comparison / root-cause-ladder evidence
 
 ## Phase 2: Repair
 
 - [ ] T002 [IMPL] Apply the minimal root-cause fix (dependsOn:T001) `path/to/file`
   Goal: 只修已确认根因，不扩成重写。
   Files: `path/to/file`
-  Read first: `analysis.md`, `path/to/test`
+  Read first: `tasks.md`, `path/to/test`
   Project postmortem search: `rg -n "<root cause|module|failure-class|model-risk>" devflow/postmortems` or record `no-project-postmortems-yet`
   Verification: `npm test -- path/to/test`
   Evidence: passing output + Git diff
   Do not re-decide: root cause, first bad state, original trigger, allowed files, forbidden files
-  Ready when: T001 已证明同一个用户症状存在，analysis 已证明根因源头和 counterfactual proof
+  Ready when: T001 已证明同一个用户症状存在，Root Cause Contract 已证明根因源头和 counterfactual proof
 
 ## Phase 3: Verify
 

package/.claude/skills/cc-investigate/assets/TASK_MANIFEST_TEMPLATE.json

@@ -6,7 +6,7 @@
     "documentLanguage": ""
   },
   "planningMeta": {
-    "ccInvestigateSkillVersion": "1.5.0",
+    "ccInvestigateSkillVersion": "1.5.1",
     "analysisVersion": "analysis.v1",
     "workBranch": "FIX/XXX-short-bug-name",
     "approvedAt": "2026-04-17T12:00:00.000Z",
@@ -43,7 +43,7 @@
         "componentBoundary": "api -> service",
         "inputObserved": "Request payload matches the reproduced failure",
         "outputObserved": "Service receives invalid state",
-        "configEnvObserved": "Relevant env/config values recorded in analysis.md",
+        "configEnvObserved": "Relevant env/config values recorded in planning/tasks.md#Root Cause Contract",
         "stateObserved": "State snapshot or log pointer",
         "verdict": "fail"
       }
@@ -196,7 +196,6 @@
       ],
       "context": {
         "readFiles": [
-          "analysis.md",
           "tasks.md",
           "change-meta.json"
         ],
@@ -205,7 +204,7 @@
         ],
         "notes": [
           "Prove the bug first",
-          "Do not repair the symptom site unless analysis proves it is the original trigger",
+          "Do not repair the symptom site unless Root Cause Contract proves it is the original trigger",
           "Do not change unrelated contracts in this task"
         ]
       },

package/.claude/skills/cc-investigate/references/investigation-contract.md

@@ -37,8 +37,9 @@
 
 - `planning/tasks.md#Root Cause Contract` 是人类真相源
 - `planning/tasks.md` 的 task blocks 是修复 handoff
-- `planning/task-manifest.json` 是执行真相源
-- `change-meta.json` 必须记录 roadmap sync status、spec diagnosis 和 no-op reason / updated files
+- `planning/task-manifest.json` 是 CLI 生成的执行真相源，不手写
+- `change-meta.json` 必须由 CLI / 模板更新，记录 roadmap sync status、spec diagnosis 和 no-op reason / updated files
+- 修改机器态结构时改 `cc-devflow task-contract` / 模板 / validator，再重新生成；不要在 change 目录里补 JSON
 
 ## Root-Cause Hypothesis
 

package/.claude/skills/cc-plan/CHANGELOG.md

@@ -1,5 +1,18 @@
 # CC-Plan Skill Changelog
 
+## v3.9.2 - 2026-05-13
+
+- make CLI-owned machine artifacts a hard rule: AI writes `planning/tasks.md`, then runs `cc-devflow task-contract compile` / `validate` for `task-manifest.json` and `change-meta.json`
+- forbid hand-authored process JSON and require CLI / template / validator fixes when machine-state structure changes
+- internalize planning operating rules: assumptions first, smallest reversible scope, explicit conflict choice, intent-focused verification, and CLI-owned deterministic state
+- keep the thin entrypoint budget under the existing `cc-plan` limit while preserving the planning contract
+
+## v3.9.1 - 2026-05-13
+
+- slim the public `SKILL.md` entrypoint into a thin harness contract focused on branch safety, artifact ownership, density switching, and completion gates
+- move low-frequency deep planning, review, postmortem, and external-best-practice details behind conditional `PLAYBOOK.md` / `references/*` escalation instead of default context
+- keep `planning/tasks.md`, lean `task-manifest.json`, `change-meta.json`, and `workflow-context --compact` as the durable execution contract
+
 ## v3.9.0 - 2026-05-13
 
 - collapse the default planning artifact surface to `planning/tasks.md` plus CLI-generated `task-manifest.json` and `change-meta.json`