cc-devflow 4.5.6 → 4.5.8

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

@@ -4,7 +4,7 @@
 
 - Requirement version: `REQ-001.v1`
 - Design version: `design.v1`
-- CC-Plan skill version: `3.7.7`
+- CC-Plan skill version: `3.8.2`
 - Requirement ID: `REQ-001`
 - Design mode: `tiny-design`
 - Why this stays `tiny-design`: the patch is limited to an existing dialog and test file, with no API or data model changes
@@ -67,6 +67,30 @@
 - Risk: copied-state feedback may be too subtle for users
 - Mitigation: keep the first patch minimal and log a follow-up roadmap item if support friction remains
 
+## AI Leverage Decision Lens
+
+- Real user / operator: workspace member sharing an invite
+- Status quo workaround: manually select the visible invite URL
+- Human-team effort for full scope: about half a day for one engineer including test and review
+- CC / agent effort for full scope: about 20 minutes for a targeted UI patch plus test update
+- AI compression ratio: roughly 10x for this bounded UI slice
+- Complete-lake boundary: copy action, current invite URL source, copied-state feedback, and dialog behavior test
+- Ocean boundary: invite generation, permissions, analytics, and clipboard fallback redesign
+- Scope recommendation: `boil-lake`
+- Cost model: low agent time, low human review time, targeted dialog test, no backend maintenance cost, reversible UI patch
+- Verdict: `boil-lake`
+- Missing evidence or pivot reason: none
+
+## External Best-Practice Validation
+
+- Needed: No
+- Decision status: not-needed
+- Generalized search terms:
+- Sources checked:
+- Repo-fit verdict: skipped
+- Changes to frozen design:
+- Skipped reason: existing share-dialog behavior and repo tests are sufficient for the tiny design
+
 ## Review Gate
 
 - Placeholder scan: pass
@@ -75,6 +99,8 @@
 - Ambiguity scan: pass; execution does not need to re-decide button placement or clipboard source
 - Feasibility scan: pass; existing dialog and tests already cover the target surface
 - PRD brief scan: pass; problem, story, implementation decision, testing decision, and out-of-scope are durable
+- AI Leverage Decision Lens scan: pass; bounded same-dialog lake is cheap enough to complete, not just render a happy-path button
+- External best-practice scan: pass; not needed for a repo-local tiny design
 - Decision question scan: pass; `D1` approved the tiny-design copy-action boundary
 - Final recommendation: approved as `tiny-design`
 

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

@@ -9,7 +9,7 @@
   "sourceRoadmap": {
     "itemId": "RM-001",
     "roadmapVersion": "roadmap.v1",
-    "roadmapSkillVersion": "5.0.0",
+    "roadmapSkillVersion": "5.2.0",
     "sourceStage": "Stage 1",
     "successSignal": "Users can copy the invite link with one click",
     "killSignal": "The patch requires backend or permission changes",
@@ -22,7 +22,7 @@
     ]
   },
   "planningMeta": {
-    "reqPlanSkillVersion": "3.7.7",
+    "reqPlanSkillVersion": "3.8.2",
     "designVersion": "design.v1",
     "approvedAt": "2026-04-15T10:05:00.000Z",
     "approvedBy": "user",
@@ -30,27 +30,58 @@
     "requirementBrief": {
       "problemStatement": "Users can see the invite URL, but copying it still requires manual selection.",
       "solutionSummary": "Add a one-click copy action with lightweight confirmation inside the existing share dialog.",
-      "actors": ["workspace member sharing an invite"],
+      "actors": [
+        "workspace member sharing an invite"
+      ],
       "userStories": [
         {
           "id": "US-001",
           "actor": "workspace member",
           "want": "copy the invite link with one click",
           "benefit": "share it without manually selecting text",
-          "acceptance": ["Dialog behavior test proves the current invite URL is copied"]
+          "acceptance": [
+            "Dialog behavior test proves the current invite URL is copied"
+          ]
         }
       ],
       "edgeOrRecoveryStories": [],
-      "implementationDecisions": ["Reuse the existing invite URL source and dialog props"],
-      "testingDecisions": ["Test through the share dialog behavior, not an internal helper"],
-      "outOfScope": ["invite generation", "role controls", "analytics", "clipboard fallback redesign"],
-      "furtherNotes": ["Richer copied-state feedback is a separate UX requirement"]
+      "implementationDecisions": [
+        "Reuse the existing invite URL source and dialog props"
+      ],
+      "testingDecisions": [
+        "Test through the share dialog behavior, not an internal helper"
+      ],
+      "outOfScope": [
+        "invite generation",
+        "role controls",
+        "analytics",
+        "clipboard fallback redesign"
+      ],
+      "furtherNotes": [
+        "Richer copied-state feedback is a separate UX requirement"
+      ]
+    },
+    "externalBestPractice": {
+      "needed": false,
+      "decisionStatus": "not-needed",
+      "decisionQuestionId": "",
+      "privacyGuard": "generalized terms only; no project names, private requirements, customer names, secrets, logs, or proprietary concepts",
+      "generalizedSearchTerms": [],
+      "sourcesChecked": [],
+      "conventionalWisdom": "",
+      "currentDiscourse": "",
+      "repoFitVerdict": "skipped",
+      "designImpacts": [],
+      "skippedReason": "existing share-dialog behavior and repo tests are sufficient for the tiny design"
     },
     "decisionQuestions": [
       {
         "questionId": "D1",
         "gate": "approach-approval",
-        "knownEvidence": ["Existing dialog already renders the invite URL", "The patch stays inside one UI/test surface"],
+        "knownEvidence": [
+          "Existing dialog already renders the invite URL",
+          "The patch stays inside one UI/test surface"
+        ],
         "recommendation": "Approve the tiny-design copy action",
         "options": [
           {
@@ -74,7 +105,28 @@
         "impact": "cc-do keeps implementation inside the share dialog and avoids backend or permission work",
         "status": "answered"
       }
-    ]
+    ],
+    "aiLeverageDecisionLens": {
+      "realUserOrOperator": "workspace member sharing an invite",
+      "statusQuoWorkaround": "manual selection and copy of the visible invite URL",
+      "humanTeamEffortForFullScope": "about half a day for one engineer including test and review",
+      "ccAgentEffortForFullScope": "about 20 minutes for a targeted UI patch plus test update",
+      "aiCompressionRatio": "roughly 10x for this bounded UI slice",
+      "completeLakeBoundary": "copy action, current invite URL source, copied-state feedback, and dialog behavior test",
+      "oceanBoundary": "invite generation, permissions, analytics, or clipboard fallback redesign",
+      "scopeRecommendation": "boil-lake",
+      "costModel": {
+        "agentTime": "low",
+        "humanReviewTime": "low",
+        "verificationCost": "targeted dialog test",
+        "maintenanceCost": "low while scoped to the dialog",
+        "failureCost": "sharing friction remains",
+        "reversibility": "reversible UI patch"
+      },
+      "verdict": "boil-lake",
+      "missingEvidenceOrPivotReason": "",
+      "impactOnApprovedDirection": "cover the full same-dialog copy lake instead of only a happy-path button render"
+    }
   },
   "currentTaskId": null,
   "activePhase": null,
@@ -127,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",
@@ -179,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",
@@ -235,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": {
@@ -245,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.7.7`
+- CC-Plan skill version: `3.8.2`
 - Source roadmap item: `RM-001`
 - Source roadmap version: `roadmap.v1`
 
@@ -23,6 +23,7 @@
   - Implementation decisions: reuse existing invite URL source and dialog props
   - Testing decisions: test through share dialog behavior
   - Out of scope: invite generation, role controls, analytics, clipboard fallback redesign
+- AI Leverage Decision Lens: boil-lake; complete the bounded same-dialog copy lake instead of stopping at a happy-path button
 - Read first:
   - `design.md`
   - `src/features/share/ShareDialog.tsx`
@@ -38,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/pdca-loop/roadmap.json

@@ -5,7 +5,7 @@
   },
   "meta": {
     "roadmapVersion": "roadmap.v1",
-    "skillVersion": "5.0.0",
+    "skillVersion": "5.2.0",
     "status": "active",
     "lastUpdated": "2026-04-19",
     "currentFocusStage": "Stage 1"
@@ -14,7 +14,21 @@
     "planningPosture": "",
     "evidenceMaturity": "",
     "canonicalTerms": [],
-    "durableDecisionSources": []
+    "durableDecisionSources": [],
+    "aiLeverageRouteLens": {
+      "realUserOrOperator": "workspace member sharing an invite during beta onboarding",
+      "statusQuoWorkaround": "manual selection and copy of the visible invite URL",
+      "humanTeamEffortForFullScope": "about half a day for one engineer including test and review",
+      "ccAgentEffortForFullScope": "about 20 minutes for a targeted UI patch plus test update",
+      "aiCompressionRatio": "roughly 10x for this bounded UI slice",
+      "completeLakeBoundary": "copy action, current invite URL source, copied-state feedback, and dialog behavior test",
+      "oceanBoundary": "backend invite generation, permissions, analytics, and clipboard fallback redesign",
+      "scopeRecommendation": "boil-lake",
+      "firstSuccessSignal": "users copy the invite link without asking support",
+      "killSignal": "implementation requires backend or permission changes",
+      "verdict": "boil-lake",
+      "missingEvidence": []
+    }
   },
   "evidence": [],
   "route": {

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

@@ -35,17 +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
@@ -91,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

@@ -11,13 +11,13 @@ CC-DevFlow has two entry paths:
 - `cc-devflow init`: install the whole `.claude` pack into your project
 - `cc-devflow adapt`: generate platform outputs such as Codex rules
 
-The workflow itself is driven by six visible skills:
+The core workflow is driven by six visible skills, with `cc-review` available as an optional deep review pass:
 
 ```text
 cc-roadmap
 
-PDCA: cc-plan -> cc-do -> cc-check -> cc-act
-IDCA: cc-investigate -> cc-do -> cc-check -> cc-act
+PDCA: cc-plan -> [cc-review] -> cc-do -> [cc-review] -> cc-check -> cc-act
+IDCA: cc-investigate -> [cc-review] -> cc-do -> [cc-review] -> cc-check -> cc-act
 ```
 
 The public skills are the visible harness. Each distributed `SKILL.md` now carries structured frontmatter plus a `Harness Contract`, and each `PLAYBOOK.md` carries the stage transition rules in a `Visible State Machine` section.
@@ -36,7 +36,7 @@ The public skills are the visible harness. Each distributed `SKILL.md` now carri
 npx cc-devflow init --dir /path/to/your/project
 ```
 
-The whole-pack install includes the six visible workflow skills plus `cc-spec-init` and `cc-simplify` as maintenance helpers.
+The whole-pack install includes the six core workflow skills, optional `cc-review`, plus `cc-spec-init` and `cc-simplify` as maintenance helpers.
 
 ### Single Skill Install
 
@@ -75,10 +75,12 @@ Use the skills in this order:
 ```text
 1. cc-roadmap
 2. choose cc-plan or cc-investigate
-3. cc-do
-4. cc-check
-5. cc-act
-6. repeat
+3. optional cc-review for complex frozen plans or investigations
+4. cc-do
+5. optional cc-review for complex implementations
+6. cc-check
+7. cc-act
+8. repeat
 ```
 
 Typical outputs:
@@ -87,6 +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-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`
 
@@ -151,7 +154,7 @@ npx cc-devflow adapt --cwd /path/to/your/project --platform codex
 
 If your project has no optional `.claude/commands/` input, this is expected: the compiler will still generate the skills registry and mirror the distributed skill set for Codex.
 
-Codex mirrors the distributed skills from `.claude/skills/<skill>/` into `.codex/skills/<skill>/`. That set includes the six public workflow skills plus `cc-spec-init` and `cc-simplify`, and the mirror is additive-only: existing project-owned Codex skills are preserved instead of being deleted.
+Codex mirrors the distributed skills from `.claude/skills/<skill>/` into `.codex/skills/<skill>/`. That set includes the six core workflow skills, optional `cc-review`, `cc-spec-init`, and `cc-simplify`, and the mirror is additive-only: existing project-owned Codex skills are preserved instead of being deleted.
 
 ### Keep skills and examples in sync