cc-devflow 4.5.7 → 4.5.8

package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/task-manifest.json

@@ -22,7 +22,7 @@
     ]
   },
   "planningMeta": {
-    "reqPlanSkillVersion": "3.8.1",
+    "reqPlanSkillVersion": "3.8.2",
     "designVersion": "design.v1",
     "approvedAt": "2026-04-15T10:05:00.000Z",
     "approvedBy": "user",
@@ -179,7 +179,60 @@
       },
       "status": "passed",
       "attempts": 1,
-      "maxRetries": 1
+      "maxRetries": 1,
+      "tddPhase": "red",
+      "verticalSlice": "Slice 1",
+      "testSeam": {
+        "entry": "share dialog UI behavior",
+        "behaviorAsserted": "The missing copy action is reproduced as a failing test",
+        "specStyleTestName": "The missing copy action is reproduced as a failing test",
+        "oneLogicalBehavior": true,
+        "publicVerificationPath": "Run the share dialog test and observe the copy action through the rendered dialog",
+        "implementationDetailRisk": "low"
+      },
+      "feedbackLoop": {
+        "type": "automated-test",
+        "determinism": "deterministic",
+        "expectedFailure": "Fails before the behavior exists"
+      },
+      "allowedMocks": [
+        "clipboard boundary"
+      ],
+      "testQuality": {
+        "usesPublicInterface": true,
+        "describesBehavior": true,
+        "specStyleName": true,
+        "oneLogicalBehavior": true,
+        "verifiesThroughPublicPath": true,
+        "survivesInternalRefactor": true,
+        "mocksOnlySystemBoundaries": true,
+        "noBulkRed": true
+      },
+      "greenMinimality": {
+        "guard": "Keep the task scoped to its stated verification evidence",
+        "noSpeculativeBranches": true
+      },
+      "completion": {
+        "command": "SCRIPT_ROOT=\".claude/skills/cc-do/scripts\"; if [[ ! -d \"$SCRIPT_ROOT\" && -d \".codex/skills/cc-do/scripts\" ]]; then SCRIPT_ROOT=\".codex/skills/cc-do/scripts\"; fi; bash \"$SCRIPT_ROOT\"/mark-task-complete.sh --manifest docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/task-manifest.json --tasks docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/tasks.md --task T001",
+        "requiredBeforeCompletion": [
+          "verification evidence captured",
+          "checkpoint written",
+          "spec review gate recorded",
+          "code review gate recorded"
+        ],
+        "forbiddenShortcuts": [
+          "manual checkbox edit",
+          "manual manifest status edit",
+          "leaving currentTaskId stale"
+        ]
+      },
+      "refactorCandidates": [
+        "duplication",
+        "long method",
+        "primitive obsession",
+        "naming",
+        "more than three nested branches"
+      ]
     },
     {
       "id": "T002",
@@ -231,7 +284,60 @@
       },
       "status": "passed",
       "attempts": 1,
-      "maxRetries": 1
+      "maxRetries": 1,
+      "tddPhase": "green",
+      "verticalSlice": "Slice 2",
+      "testSeam": {
+        "entry": "share dialog UI behavior",
+        "behaviorAsserted": "The dialog exposes a copy button and confirms the copied state",
+        "specStyleTestName": "The dialog exposes a copy button and confirms the copied state",
+        "oneLogicalBehavior": true,
+        "publicVerificationPath": "Run the share dialog test and observe the copy action through the rendered dialog",
+        "implementationDetailRisk": "low"
+      },
+      "feedbackLoop": {
+        "type": "automated-test",
+        "determinism": "deterministic",
+        "expectedFailure": ""
+      },
+      "allowedMocks": [
+        "clipboard boundary"
+      ],
+      "testQuality": {
+        "usesPublicInterface": true,
+        "describesBehavior": true,
+        "specStyleName": true,
+        "oneLogicalBehavior": true,
+        "verifiesThroughPublicPath": true,
+        "survivesInternalRefactor": true,
+        "mocksOnlySystemBoundaries": true,
+        "noBulkRed": true
+      },
+      "greenMinimality": {
+        "guard": "Implement only the code needed to pass the current red behavior",
+        "noSpeculativeBranches": true
+      },
+      "completion": {
+        "command": "SCRIPT_ROOT=\".claude/skills/cc-do/scripts\"; if [[ ! -d \"$SCRIPT_ROOT\" && -d \".codex/skills/cc-do/scripts\" ]]; then SCRIPT_ROOT=\".codex/skills/cc-do/scripts\"; fi; bash \"$SCRIPT_ROOT\"/mark-task-complete.sh --manifest docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/task-manifest.json --tasks docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/tasks.md --task T002",
+        "requiredBeforeCompletion": [
+          "verification evidence captured",
+          "checkpoint written",
+          "spec review gate recorded",
+          "code review gate recorded"
+        ],
+        "forbiddenShortcuts": [
+          "manual checkbox edit",
+          "manual manifest status edit",
+          "leaving currentTaskId stale"
+        ]
+      },
+      "refactorCandidates": [
+        "duplication",
+        "long method",
+        "primitive obsession",
+        "naming",
+        "more than three nested branches"
+      ]
     },
     {
       "id": "T003",
@@ -287,7 +393,60 @@
       },
       "status": "passed",
       "attempts": 1,
-      "maxRetries": 1
+      "maxRetries": 1,
+      "tddPhase": "evidence",
+      "verticalSlice": "Slice 3",
+      "testSeam": {
+        "entry": "share dialog UI behavior",
+        "behaviorAsserted": "Fresh verification evidence is ready for cc-check",
+        "specStyleTestName": "Fresh verification evidence is ready for cc-check",
+        "oneLogicalBehavior": true,
+        "publicVerificationPath": "Run the share dialog test and observe the copy action through the rendered dialog",
+        "implementationDetailRisk": "low"
+      },
+      "feedbackLoop": {
+        "type": "automated-test",
+        "determinism": "deterministic",
+        "expectedFailure": ""
+      },
+      "allowedMocks": [
+        "clipboard boundary"
+      ],
+      "testQuality": {
+        "usesPublicInterface": true,
+        "describesBehavior": true,
+        "specStyleName": true,
+        "oneLogicalBehavior": true,
+        "verifiesThroughPublicPath": true,
+        "survivesInternalRefactor": true,
+        "mocksOnlySystemBoundaries": true,
+        "noBulkRed": true
+      },
+      "greenMinimality": {
+        "guard": "Keep the task scoped to its stated verification evidence",
+        "noSpeculativeBranches": true
+      },
+      "completion": {
+        "command": "SCRIPT_ROOT=\".claude/skills/cc-do/scripts\"; if [[ ! -d \"$SCRIPT_ROOT\" && -d \".codex/skills/cc-do/scripts\" ]]; then SCRIPT_ROOT=\".codex/skills/cc-do/scripts\"; fi; bash \"$SCRIPT_ROOT\"/mark-task-complete.sh --manifest docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/task-manifest.json --tasks docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/tasks.md --task T003",
+        "requiredBeforeCompletion": [
+          "verification evidence captured",
+          "checkpoint written",
+          "spec review gate recorded",
+          "code review gate recorded"
+        ],
+        "forbiddenShortcuts": [
+          "manual checkbox edit",
+          "manual manifest status edit",
+          "leaving currentTaskId stale"
+        ]
+      },
+      "refactorCandidates": [
+        "duplication",
+        "long method",
+        "primitive obsession",
+        "naming",
+        "more than three nested branches"
+      ]
     }
   ],
   "metadata": {
@@ -297,5 +456,39 @@
   },
   "deferredQuestions": [
     "If users still miss the copied-state confirmation, open RM-002 for richer feedback."
-  ]
+  ],
+  "executionProtocol": {
+    "templateCompliance": {
+      "required": true,
+      "sourceTemplate": "assets/TASKS_TEMPLATE.md",
+      "taskBlockMustInclude": [
+        "Goal",
+        "TDD phase",
+        "Files",
+        "Read first",
+        "Verification",
+        "Evidence",
+        "Test seam",
+        "Public verification path",
+        "Allowed mocks",
+        "Completion"
+      ],
+      "titleOnlyTasks": "forbidden"
+    },
+    "selection": {
+      "sourceOfTruth": "planning/task-manifest.json.currentTaskId",
+      "commandTemplate": "SCRIPT_ROOT=\".claude/skills/cc-do/scripts\"; if [[ ! -d \"$SCRIPT_ROOT\" && -d \".codex/skills/cc-do/scripts\" ]]; then SCRIPT_ROOT=\".codex/skills/cc-do/scripts\"; fi; bash \"$SCRIPT_ROOT\"/select-ready-tasks.sh --manifest docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/task-manifest.json"
+    },
+    "completion": {
+      "manualStatusEdit": "forbidden",
+      "commandTemplate": "SCRIPT_ROOT=\".claude/skills/cc-do/scripts\"; if [[ ! -d \"$SCRIPT_ROOT\" && -d \".codex/skills/cc-do/scripts\" ]]; then SCRIPT_ROOT=\".codex/skills/cc-do/scripts\"; fi; bash \"$SCRIPT_ROOT\"/mark-task-complete.sh --manifest docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/task-manifest.json --tasks docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/tasks.md --task <task-id>",
+      "failurePolicy": "Do not hand-edit status; fix missing checkpoint, review gate, or dependency evidence and rerun the script.",
+      "updates": [
+        "planning/task-manifest.json.tasks[].status",
+        "planning/task-manifest.json.currentTaskId",
+        "planning/task-manifest.json.status",
+        "planning/tasks.md checkbox"
+      ]
+    }
+  }
 }

package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/tasks.md

@@ -4,7 +4,7 @@
 
 - Requirement version: `REQ-001.v1`
 - Design version: `design.v1`
-- CC-Plan skill version: `3.8.1`
+- CC-Plan skill version: `3.8.2`
 - Source roadmap item: `RM-001`
 - Source roadmap version: `roadmap.v1`
 
@@ -39,34 +39,68 @@
 
 > 顶部 handoff 只保留执行者必须知道的现实，不重复讲背景故事。
 
+## Execution Protocol
+
+ClaudeCode / Codex 执行本计划时，必须把本文件当成任务模板合同，而不是普通 TODO 列表。
+
+- Template source: `assets/TASKS_TEMPLATE.md`
+- Task selection: read `planning/task-manifest.json.currentTaskId`; if empty, run the ready-task selector before choosing work.
+- Task block rule: read the full task block before coding; title-only execution is invalid.
+- Completion rule: after verification and review gates pass, run the completion script; do not manually edit checkbox, status, or `currentTaskId`.
+- Completion failure: if the script fails, fix the missing checkpoint / review / dependency evidence and rerun it. Do not bypass it by editing JSON or Markdown.
+
+```bash
+SCRIPT_ROOT=".claude/skills/cc-do/scripts"
+if [[ ! -d "$SCRIPT_ROOT" && -d ".codex/skills/cc-do/scripts" ]]; then
+  SCRIPT_ROOT=".codex/skills/cc-do/scripts"
+fi
+bash "$SCRIPT_ROOT/select-ready-tasks.sh" --manifest docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/task-manifest.json
+bash "$SCRIPT_ROOT/mark-task-complete.sh" --manifest docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/task-manifest.json --tasks docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/tasks.md --task <task-id>
+```
+
 ## Phase 1: Foundation
 
 - [x] T001 [TEST] Add a failing dialog test for the missing copy action (dependsOn:none) `src/features/share/ShareDialog.test.tsx`
   Goal: 证明当前 share dialog 还不能一键复制 invite link。
+  TDD phase: red
   Files: `src/features/share/ShareDialog.test.tsx`
   Read first: `design.md`, `src/features/share/ShareDialog.tsx`
   Verification: `npm test -- src/features/share/ShareDialog.test.tsx`
   Evidence: failing output that shows the missing button / action
+  Completion: after verification evidence and required checkpoint/review records exist, run `SCRIPT_ROOT=".claude/skills/cc-do/scripts"; if [[ ! -d "$SCRIPT_ROOT" && -d ".codex/skills/cc-do/scripts" ]]; then SCRIPT_ROOT=".codex/skills/cc-do/scripts"; fi; bash "$SCRIPT_ROOT/mark-task-complete.sh" --manifest docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/task-manifest.json --tasks docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/tasks.md --task T001`; do not hand-edit status.
+  Test seam: share dialog UI behavior
+  Public verification path: Run the share dialog test and observe the copy action through the rendered dialog
+  Allowed mocks: clipboard boundary
   Ready when: 没有上游依赖，且现有 dialog test 已可运行
 
 - [x] T002 [IMPL] Add the copy button and copied-state confirmation (dependsOn:T001) `src/features/share/ShareDialog.tsx`
   Goal: 用最小实现让 T001 转绿，并保持当前 share contract 不变。
+  TDD phase: green
   Files: `src/features/share/ShareDialog.tsx`
   Read first: `design.md`, `src/features/share/ShareDialog.test.tsx`
   Verification: `npm test -- src/features/share/ShareDialog.test.tsx`
   Evidence: passing output + checkpoint + review notes
+  Completion: after verification evidence and required checkpoint/review records exist, run `SCRIPT_ROOT=".claude/skills/cc-do/scripts"; if [[ ! -d "$SCRIPT_ROOT" && -d ".codex/skills/cc-do/scripts" ]]; then SCRIPT_ROOT=".codex/skills/cc-do/scripts"; fi; bash "$SCRIPT_ROOT/mark-task-complete.sh" --manifest docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/task-manifest.json --tasks docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/tasks.md --task T002`; do not hand-edit status.
+  Test seam: share dialog UI behavior
+  Public verification path: Run the share dialog test and observe the copy action through the rendered dialog
+  Allowed mocks: clipboard boundary
   Ready when: T001 已经见红，且当前 touched files 没有外部依赖阻塞
 
 ## Phase 2: Verify
 
 - [x] T003 Run targeted checks and collect fresh evidence (dependsOn:T002) `share dialog quality gates`
   Goal: 为 `cc-check` 准备本次实现的真实验证证据。
+  TDD phase: evidence
   Files: `src/features/share/ShareDialog.tsx`, `src/features/share/ShareDialog.test.tsx`
   Read first: `tasks.md`, `task-manifest.json`
   Verification:
   - `npm test -- src/features/share/ShareDialog.test.tsx`
   - `npm run lint -- src/features/share/ShareDialog.tsx`
   Evidence: passing test output + clean lint output
+  Completion: after verification evidence and required checkpoint/review records exist, run `SCRIPT_ROOT=".claude/skills/cc-do/scripts"; if [[ ! -d "$SCRIPT_ROOT" && -d ".codex/skills/cc-do/scripts" ]]; then SCRIPT_ROOT=".codex/skills/cc-do/scripts"; fi; bash "$SCRIPT_ROOT/mark-task-complete.sh" --manifest docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/task-manifest.json --tasks docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/tasks.md --task T003`; do not hand-edit status.
+  Test seam: share dialog UI behavior
+  Public verification path: Run the share dialog test and observe the copy action through the rendered dialog
+  Allowed mocks: clipboard boundary
   Ready when: T002 已完成，且 review gate 已可补齐
 
 > `[P]` 只表示“依赖满足后有资格并行”，不表示可以无脑同时开发。

package/docs/examples/scripts/check-example-bindings.sh

@@ -35,19 +35,27 @@ assert_contains() {
 }
 
 ROADMAP_VERSION="$(skill_version cc-roadmap)"
+NEXT_VERSION="$(skill_version cc-next)"
+DEV_VERSION="$(skill_version cc-dev)"
 REQ_PLAN_VERSION="$(skill_version cc-plan)"
 INVESTIGATE_VERSION="$(skill_version cc-investigate)"
 REQ_DO_VERSION="$(skill_version cc-do)"
 REQ_REVIEW_VERSION="$(skill_version cc-review)"
+PR_REVIEW_VERSION="$(skill_version cc-pr-review)"
+PR_LAND_VERSION="$(skill_version cc-pr-land)"
 REQ_CHECK_VERSION="$(skill_version cc-check)"
 REQ_ACT_VERSION="$(skill_version cc-act)"
 
 for pair in \
   "cc-roadmap:$ROADMAP_VERSION" \
+  "cc-next:$NEXT_VERSION" \
+  "cc-dev:$DEV_VERSION" \
   "cc-plan:$REQ_PLAN_VERSION" \
   "cc-investigate:$INVESTIGATE_VERSION" \
   "cc-do:$REQ_DO_VERSION" \
   "cc-review:$REQ_REVIEW_VERSION" \
+  "cc-pr-review:$PR_REVIEW_VERSION" \
+  "cc-pr-land:$PR_LAND_VERSION" \
   "cc-check:$REQ_CHECK_VERSION" \
   "cc-act:$REQ_ACT_VERSION"
 do
@@ -93,9 +101,19 @@ while IFS= read -r encoded; do
 
   jq -er --arg roadmap "$ROADMAP_VERSION" --arg reqplan "$REQ_PLAN_VERSION" '
     (.sourceRoadmap.roadmapSkillVersion // $roadmap) == $roadmap and
-    (.planningMeta.reqPlanSkillVersion // $reqplan) == $reqplan
+    (.planningMeta.reqPlanSkillVersion // $reqplan) == $reqplan and
+    .executionProtocol.templateCompliance.required == true and
+    .executionProtocol.completion.manualStatusEdit == "forbidden" and
+    (.executionProtocol.completion.commandTemplate | contains("mark-task-complete.sh")) and
+    all(.tasks[]; (.completion.command | contains("mark-task-complete.sh")) and (.tddPhase | type == "string") and (.testSeam.publicVerificationPath | type == "string"))
   ' "$planning_dir/task-manifest.json" >/dev/null
 
+  assert_contains "$planning_dir/tasks.md" "## Execution Protocol"
+  assert_contains "$planning_dir/tasks.md" "mark-task-complete.sh"
+  assert_contains "$planning_dir/tasks.md" "TDD phase:"
+  assert_contains "$planning_dir/tasks.md" "Completion:"
+  assert_contains "$planning_dir/tasks.md" "Public verification path:"
+
   assert_contains "$readme" "## Example Meta"
   assert_contains "$readme" "\`cc-roadmap@$ROADMAP_VERSION\`"
   assert_contains "$readme" "\`cc-plan@$REQ_PLAN_VERSION\`"

package/docs/guides/getting-started.md

@@ -89,7 +89,7 @@ Typical outputs:
 - `cc-spec-init` writes `devflow/specs/INDEX.md`, capability specs, and `change-meta.json`
 - `cc-plan` writes `planning/design.md`, `planning/tasks.md`, `task-manifest.json`, and `change-meta.json`
 - `cc-investigate` writes `planning/analysis.md`, `planning/tasks.md`, `task-manifest.json`, and `change-meta.json`
-- `cc-review` writes `cc-review-report.md` and optional structured findings for deep plan or implementation review
+- `cc-review` writes `cc-review-plan.md`, `cc-review-ledger.jsonl`, `cc-review-report.md`, optional `cc-review-agent-results.jsonl`, and optional structured findings for deep plan or implementation review
 - `cc-check` writes `report-card.json`
 - `cc-act` writes exactly one final handoff file: `handoff/pr-brief.md`, `handoff/resume-index.md`, or `handoff/release-note.md`
 

package/docs/guides/getting-started.zh-CN.md

@@ -89,7 +89,7 @@ find .codex/skills -mindepth 2 -maxdepth 2 -name SKILL.md | sort
 - `cc-spec-init` 产出 `devflow/specs/INDEX.md`、capability spec 和 `change-meta.json`
 - `cc-plan` 产出 `planning/design.md`、`planning/tasks.md`、`task-manifest.json` 和 `change-meta.json`
 - `cc-investigate` 产出 `planning/analysis.md`、`planning/tasks.md`、`task-manifest.json` 和 `change-meta.json`
-- `cc-review` 产出 `cc-review-report.md`，以及可选的结构化深度 Review findings
+- `cc-review` 产出 `cc-review-plan.md`、`cc-review-ledger.jsonl`、`cc-review-report.md`、可选 `cc-review-agent-results.jsonl`，以及可选的结构化深度 Review findings
 - `cc-check` 产出 `report-card.json`
 - `cc-act` 只产出一个最终 handoff 文件：`handoff/pr-brief.md`、`handoff/resume-index.md` 或 `handoff/release-note.md`
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "cc-devflow",
-    "version": "4.5.7",
+    "version": "4.5.8",
     "description": "Multi-platform CLI and skill pack for agent coding",
     "main": "bin/cc-devflow.js",
     "bin": {
@@ -10,11 +10,16 @@
         "bin/",
         "lib/",
         "config/",
+        "docs/assets/",
         ".claude/skills/cc-roadmap/",
+        ".claude/skills/cc-next/",
+        ".claude/skills/cc-dev/",
         ".claude/skills/cc-plan/",
         ".claude/skills/cc-investigate/",
         ".claude/skills/cc-do/",
         ".claude/skills/cc-review/",
+        ".claude/skills/cc-pr-review/",
+        ".claude/skills/cc-pr-land/",
         ".claude/skills/cc-check/",
         ".claude/skills/cc-act/",
         ".claude/skills/cc-spec-init/",