cc-devflow 4.3.0 → 4.5.0

package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/handoff/status.md

@@ -0,0 +1,29 @@
+# Status Report
+
+## Requirement
+
+- Change ID: `REQ-001`
+- Roadmap item: `RM-001`
+- Current state: verified and ready to ship as `create-pr`
+
+## What Is True Now
+
+- The share dialog exposes a one-click copy action for the existing invite URL
+- The patch stayed inside the approved `tiny-design` boundary
+- Fresh targeted test and lint evidence both passed
+- Review proof is present, so `cc-check` returned `pass`
+
+## Ship Decision
+
+- Recommended mode: `create-pr`
+- Why now: the work is verified, the branch is assumed to be a feature branch, and no open PR exists yet
+- Why not others:
+  - not `update-pr`: there is no existing PR to refresh
+  - not `local-handoff`: the work is ready to move forward
+  - not `post-merge-closeout`: the change is not merged yet
+
+## Docs And Follow-Up
+
+- README / release docs: no public user-facing release note yet
+- Backlog writeback: keep `RM-002` parked as the next UX refinement if support friction remains
+- Next entry point: create the PR using `pr-brief.md` as the truth source

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

@@ -0,0 +1,72 @@
+# DESIGN
+
+## Document Meta
+
+- Requirement version: `REQ-001.v1`
+- Design version: `design.v1`
+- CC-Plan skill version: `3.5.4`
+- 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
+- Approval status: `approved`
+- Source roadmap item: `RM-001`
+- Source roadmap version: `roadmap.v1`
+
+## Source Handoff
+
+- Why now: Stage 1 needs the smallest possible share-flow win
+- Inherited success signal: a user can copy the invite link with one click
+- Inherited kill signal: if the patch requires backend or permission changes, reopen planning
+- Inherited non-goals: no invite role controls, no analytics, no dialog redesign
+- Upstream evidence: repeated support notes and observed manual copying
+
+## Frozen Design Card
+
+- Change: add a `Copy invite link` button beside the existing read-only invite URL in the share dialog
+- Keep out: no new invite generation flow and no fallback redesign for unsupported browsers
+- Touched files:
+  - `src/features/share/ShareDialog.tsx`
+  - `src/features/share/ShareDialog.test.tsx`
+- Contract changes: none; reuse the existing invite link source and existing dialog props
+- Key decisions that `cc-do` must not re-decide:
+  - use `navigator.clipboard.writeText`
+  - keep the current invite URL source of truth
+  - show a lightweight copied-state confirmation inside the current dialog
+- Upgrade trigger to `full-design`: if clipboard support requires new platform fallbacks, or if the patch spills into shared share-service contracts
+
+## Validation
+
+- Primary check: targeted dialog test proves the button renders and copies the current invite URL
+- Secondary checks:
+  - existing share dialog tests remain green
+  - lint stays green for the touched files
+- Evidence to collect:
+  - failing test before implementation
+  - passing targeted test after implementation
+  - fresh gate output for `cc-check`
+
+## Main Risk
+
+- 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
+
+## Review Gate
+
+- Placeholder scan: pass
+- Consistency scan: pass; scope, files, and validation all point to the same tiny patch
+- Scope scan: pass; no backend, no permission work
+- 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
+- Final recommendation: approved as `tiny-design`
+
+## Approval
+
+- User approval status: approved
+- Deferred questions:
+  - if copied-state feedback still feels weak, open a separate requirement for richer UX
+
+## First-Read Test
+
+- This is clearly small because it stays inside one UI surface and one test surface
+- The upgrade path is explicit: any contract or fallback work forces `full-design`
+- `cc-do` should not need to ask where the URL comes from or how the copy action is triggered

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

@@ -0,0 +1,201 @@
+{
+  "changeId": "REQ-001",
+  "goal": "Add a one-click copy action to the existing share dialog without changing backend contracts.",
+  "createdAt": "2026-04-15T10:00:00.000Z",
+  "updatedAt": "2026-04-15T11:10:00.000Z",
+  "status": "verified",
+  "requirementId": "REQ-001",
+  "requirementVersion": "REQ-001.v1",
+  "sourceRoadmap": {
+    "itemId": "RM-001",
+    "roadmapVersion": "roadmap.v1",
+    "roadmapSkillVersion": "4.3.2",
+    "sourceStage": "Stage 1",
+    "successSignal": "Users can copy the invite link with one click",
+    "killSignal": "The patch requires backend or permission changes",
+    "dependencies": [
+      "Existing share dialog stays intact"
+    ],
+    "nonGoals": [
+      "No invite role redesign",
+      "No share analytics"
+    ]
+  },
+  "planningMeta": {
+    "reqPlanSkillVersion": "3.5.4",
+    "designVersion": "design.v1",
+    "approvedAt": "2026-04-15T10:05:00.000Z",
+    "approvedBy": "user",
+    "basedOnOption": "Tiny design card"
+  },
+  "currentTaskId": null,
+  "activePhase": null,
+  "tasks": [
+    {
+      "id": "T001",
+      "title": "[TEST] Add a failing dialog test for the missing copy action",
+      "type": "TEST",
+      "phase": 1,
+      "parallel": false,
+      "dependsOn": [],
+      "touches": [
+        "share-dialog",
+        "tests"
+      ],
+      "files": [
+        "src/features/share/ShareDialog.test.tsx"
+      ],
+      "run": [
+        "npm test -- src/features/share/ShareDialog.test.tsx"
+      ],
+      "checks": [
+        "test fails before implementation"
+      ],
+      "acceptance": [
+        "The missing copy action is reproduced as a failing test"
+      ],
+      "verification": [
+        "npm test -- src/features/share/ShareDialog.test.tsx"
+      ],
+      "evidence": [
+        "Failing test output"
+      ],
+      "context": {
+        "readFiles": [
+          "design.md",
+          "tasks.md",
+          "src/features/share/ShareDialog.tsx"
+        ],
+        "commands": [
+          "npm test -- src/features/share/ShareDialog.test.tsx"
+        ],
+        "notes": [
+          "Do not change share-service contracts in this task"
+        ]
+      },
+      "reviews": {
+        "spec": "pass",
+        "code": "pass"
+      },
+      "status": "passed",
+      "attempts": 1,
+      "maxRetries": 1
+    },
+    {
+      "id": "T002",
+      "title": "[IMPL] Add the copy button and copied-state confirmation",
+      "type": "IMPL",
+      "phase": 1,
+      "parallel": false,
+      "dependsOn": [
+        "T001"
+      ],
+      "touches": [
+        "share-dialog"
+      ],
+      "files": [
+        "src/features/share/ShareDialog.tsx"
+      ],
+      "run": [
+        "npm test -- src/features/share/ShareDialog.test.tsx"
+      ],
+      "checks": [
+        "dialog test passes after implementation"
+      ],
+      "acceptance": [
+        "The dialog exposes a copy button and confirms the copied state"
+      ],
+      "verification": [
+        "npm test -- src/features/share/ShareDialog.test.tsx"
+      ],
+      "evidence": [
+        "Passing targeted test output",
+        "Checkpoint summary"
+      ],
+      "context": {
+        "readFiles": [
+          "design.md",
+          "tasks.md",
+          "src/features/share/ShareDialog.test.tsx"
+        ],
+        "commands": [
+          "npm test -- src/features/share/ShareDialog.test.tsx"
+        ],
+        "notes": [
+          "Keep the patch inside the existing dialog"
+        ]
+      },
+      "reviews": {
+        "spec": "pass",
+        "code": "pass"
+      },
+      "status": "passed",
+      "attempts": 1,
+      "maxRetries": 1
+    },
+    {
+      "id": "T003",
+      "title": "Run targeted checks and collect fresh evidence",
+      "type": "OTHER",
+      "phase": 2,
+      "parallel": false,
+      "dependsOn": [
+        "T002"
+      ],
+      "touches": [
+        "quality-gates"
+      ],
+      "files": [
+        "src/features/share/ShareDialog.tsx",
+        "src/features/share/ShareDialog.test.tsx"
+      ],
+      "run": [
+        "npm test -- src/features/share/ShareDialog.test.tsx",
+        "npm run lint -- src/features/share/ShareDialog.tsx"
+      ],
+      "checks": [
+        "targeted test passes",
+        "lint passes"
+      ],
+      "acceptance": [
+        "Fresh verification evidence is ready for cc-check"
+      ],
+      "verification": [
+        "npm test -- src/features/share/ShareDialog.test.tsx",
+        "npm run lint -- src/features/share/ShareDialog.tsx"
+      ],
+      "evidence": [
+        "Passing targeted test output",
+        "Clean lint output"
+      ],
+      "context": {
+        "readFiles": [
+          "tasks.md",
+          "task-manifest.json"
+        ],
+        "commands": [
+          "npm test -- src/features/share/ShareDialog.test.tsx",
+          "npm run lint -- src/features/share/ShareDialog.tsx"
+        ],
+        "notes": [
+          "Collect only fresh evidence from this run"
+        ]
+      },
+      "reviews": {
+        "spec": "pass",
+        "code": "pass"
+      },
+      "status": "passed",
+      "attempts": 1,
+      "maxRetries": 1
+    }
+  ],
+  "metadata": {
+    "source": "tasks.md",
+    "generatedBy": "docs-example",
+    "planVersion": 1
+  },
+  "deferredQuestions": [
+    "If users still miss the copied-state confirmation, open RM-002 for richer feedback."
+  ]
+}

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

@@ -0,0 +1,73 @@
+# TASKS
+
+## Plan Meta
+
+- Requirement version: `REQ-001.v1`
+- Design version: `design.v1`
+- CC-Plan skill version: `3.5.4`
+- Source roadmap item: `RM-001`
+- Source roadmap version: `roadmap.v1`
+
+## Execution Handoff
+
+- Canonical design: `design.md`
+- Execution mode: `single-path`
+- Frozen decisions:
+  - copy from the existing invite URL source
+  - keep the patch inside the current dialog
+  - leave richer feedback for a future requirement if needed
+- Read first:
+  - `design.md`
+  - `src/features/share/ShareDialog.tsx`
+  - `src/features/share/ShareDialog.test.tsx`
+- Commands to trust:
+  - `npm test -- src/features/share/ShareDialog.test.tsx`
+  - `npm run lint -- src/features/share/ShareDialog.tsx`
+- Do not re-decide:
+  - dialog structure
+  - invite URL source
+  - share-service contracts
+- Parallel boundaries: none; this patch is intentionally serial
+
+> 顶部 handoff 只保留执行者必须知道的现实，不重复讲背景故事。
+
+## 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。
+  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
+  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 不变。
+  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
+  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` 准备本次实现的真实验证证据。
+  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
+  Ready when: T002 已完成，且 review gate 已可补齐
+
+> `[P]` 只表示“依赖满足后有资格并行”，不表示可以无脑同时开发。
+
+## Task Quality Bar
+
+一个好的 task block 至少让执行者立刻知道：
+
+- 现在为什么轮到它做
+- 做完后现实会发生什么变化
+- 用哪条命令证明它完成
+- 要留下什么证据给 `cc-check`

package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/review/report-card.json

@@ -0,0 +1,44 @@
+{
+  "changeId": "REQ-001",
+  "verdict": "pass",
+  "overall": "pass",
+  "summary": "verdict=pass quick=2/2 strict=0/0 review=pass",
+  "quickGates": [
+    {
+      "name": "targeted-tests",
+      "status": "pass",
+      "command": "npm test -- src/features/share/ShareDialog.test.tsx",
+      "summary": "share dialog targeted tests passed"
+    },
+    {
+      "name": "lint",
+      "status": "pass",
+      "command": "npm run lint -- src/features/share/ShareDialog.tsx",
+      "summary": "lint passed for the touched dialog file"
+    }
+  ],
+  "strictGates": [],
+  "review": {
+    "status": "pass",
+    "summary": "Task review proof and requirement-level diff review both passed",
+    "details": "T001-T003 have matching spec/code review proof and the diff stays inside the approved tiny-design boundary.",
+    "taskReviews": {
+      "status": "pass",
+      "required": true,
+      "summary": "All completed tasks carry spec/code proof",
+      "reviewers": [],
+      "findings": []
+    },
+    "diffReview": {
+      "status": "pass",
+      "required": false,
+      "summary": "No blocking requirement-level findings",
+      "reviewers": [],
+      "findings": []
+    },
+    "findings": []
+  },
+  "blockingFindings": [],
+  "reroute": "none",
+  "timestamp": "2026-04-15T11:20:00.000Z"
+}

package/docs/examples/pdca-loop/roadmap-tracking.json

@@ -0,0 +1,114 @@
+{
+  "version": 2,
+  "lastSyncedAt": "2026-04-19",
+  "backlogMeta": {
+    "roadmapVersion": "roadmap.v1",
+    "skillVersion": "4.3.2",
+    "currentFocusStage": "Stage 1"
+  },
+  "dependencyHandoff": {
+    "serialSpine": "RM-001 -> RM-002",
+    "parallelReadyNextWave": "none until RM-001 proves the copy action shape",
+    "notesOnBlockers": "RM-002 should reuse the final interaction contract from RM-001, not race it"
+  },
+  "items": [
+    {
+      "rmId": "RM-001",
+      "item": "Add one-click copy action to the share dialog",
+      "stage": "Stage 1",
+      "priority": "P1",
+      "primaryCapability": "cap-invite-links",
+      "secondaryCapabilities": [],
+      "expectedSpecDelta": "tighten invite-link copy truth",
+      "dependsOn": [],
+      "status": "In review",
+      "req": "REQ-001",
+      "progress": "100%",
+      "backlog": {
+        "capabilityGap": "share dialog exposes invite URL but not direct copy action",
+        "evidence": "repeated support friction",
+        "parallelWith": [],
+        "unknowns": "copied-state feedback shape",
+        "nextDecision": "freeze tiny design and execute",
+        "ready": true,
+        "whyNow": "it removes the first visible collaboration friction in the beta flow",
+        "successSignal": "users can copy the invite link with one click",
+        "entryConstraints": "no backend changes, no share dialog redesign",
+        "openRisks": "clipboard failure copy may still need follow-up UX",
+        "firstPlanningQuestion": "can this stay a tiny-design patch without changing contracts?",
+        "requiredContextToLoad": "current share dialog, current invite URL source, existing tests",
+        "whyReadyNow": "the ask is narrow, the evidence is real, and the dependency surface is already known",
+        "parked": false,
+        "parkedReason": "",
+        "triggerToReopen": "",
+        "missingEvidence": ""
+      }
+    },
+    {
+      "rmId": "RM-002",
+      "item": "Add copied-state feedback to the share dialog",
+      "stage": "Stage 1",
+      "priority": "P2",
+      "primaryCapability": "cap-invite-links",
+      "secondaryCapabilities": [],
+      "expectedSpecDelta": "extend invite-link feedback truth",
+      "dependsOn": [
+        "RM-001"
+      ],
+      "status": "Planned",
+      "req": "",
+      "progress": "0%",
+      "backlog": {
+        "capabilityGap": "invite links lack durable copied-state feedback after action completion",
+        "evidence": "likely useful after RM-001",
+        "parallelWith": [],
+        "unknowns": "toast vs inline state",
+        "nextDecision": "decide after first patch ships",
+        "ready": false,
+        "whyNow": "",
+        "successSignal": "",
+        "entryConstraints": "",
+        "openRisks": "",
+        "firstPlanningQuestion": "",
+        "requiredContextToLoad": "",
+        "whyReadyNow": "",
+        "parked": false,
+        "parkedReason": "",
+        "triggerToReopen": "",
+        "missingEvidence": ""
+      }
+    },
+    {
+      "rmId": "RM-004",
+      "item": "Collaboration analytics follow-up",
+      "stage": "",
+      "priority": "",
+      "primaryCapability": "",
+      "secondaryCapabilities": [],
+      "expectedSpecDelta": "",
+      "dependsOn": [],
+      "status": "",
+      "req": "",
+      "progress": "",
+      "backlog": {
+        "capabilityGap": "",
+        "evidence": "",
+        "parallelWith": [],
+        "unknowns": "",
+        "nextDecision": "",
+        "ready": false,
+        "whyNow": "",
+        "successSignal": "",
+        "entryConstraints": "",
+        "openRisks": "",
+        "firstPlanningQuestion": "",
+        "requiredContextToLoad": "",
+        "whyReadyNow": "",
+        "parked": true,
+        "parkedReason": "collaboration analytics is premature before Stage 1 and 2 prove usage",
+        "triggerToReopen": "repeated invite usage after beta activation",
+        "missingEvidence": "stable collaboration volume"
+      }
+    }
+  ]
+}

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

@@ -0,0 +1,116 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+# ------------------------------------------------------------
+# 校验 examples 与当前 skill 版本链是否仍然对齐
+# ------------------------------------------------------------
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/../../.." && pwd)"
+BINDINGS_FILE="${EXAMPLE_BINDINGS_FILE:-$ROOT_DIR/docs/examples/example-bindings.json}"
+
+if [[ ! -f "$BINDINGS_FILE" ]]; then
+  echo "Missing bindings file: $BINDINGS_FILE" >&2
+  exit 1
+fi
+
+skill_version() {
+  local skill="$1"
+  local file="$ROOT_DIR/.claude/skills/$skill/SKILL.md"
+  if [[ ! -f "$file" ]]; then
+    echo "Missing skill file: $file" >&2
+    exit 1
+  fi
+
+  sed -n 's/^version: //p' "$file" | head -n 1
+}
+
+assert_contains() {
+  local file="$1"
+  local needle="$2"
+  if ! rg -F --quiet -- "$needle" "$file"; then
+    echo "Expected '$needle' in $file" >&2
+    exit 1
+  fi
+}
+
+ROADMAP_VERSION="$(skill_version cc-roadmap)"
+REQ_PLAN_VERSION="$(skill_version cc-plan)"
+INVESTIGATE_VERSION="$(skill_version cc-investigate)"
+REQ_DO_VERSION="$(skill_version cc-do)"
+REQ_CHECK_VERSION="$(skill_version cc-check)"
+REQ_ACT_VERSION="$(skill_version cc-act)"
+
+for pair in \
+  "cc-roadmap:$ROADMAP_VERSION" \
+  "cc-plan:$REQ_PLAN_VERSION" \
+  "cc-investigate:$INVESTIGATE_VERSION" \
+  "cc-do:$REQ_DO_VERSION" \
+  "cc-check:$REQ_CHECK_VERSION" \
+  "cc-act:$REQ_ACT_VERSION"
+do
+  skill="${pair%%:*}"
+  version="${pair##*:}"
+  expected="$(jq -r --arg skill "$skill" '.skills[$skill]' "$BINDINGS_FILE")"
+  if [[ "$expected" != "$version" ]]; then
+    echo "Binding mismatch for $skill: bindings=$expected current=$version" >&2
+    exit 1
+  fi
+done
+
+while IFS= read -r encoded; do
+  example_id="$(jq -r '.id' <<<"$encoded")"
+  readme="$ROOT_DIR/$(jq -r '.readme' <<<"$encoded")"
+  root="$ROOT_DIR/$(jq -r '.root' <<<"$encoded")"
+  change_dir="$ROOT_DIR/$(jq -r '.changeDir' <<<"$encoded")"
+  planning_dir="$change_dir/planning"
+  review_dir="$change_dir/review"
+  handoff_dir="$change_dir/handoff"
+
+  for file in "$readme" "$root/ROADMAP.md" "$root/BACKLOG.md" "$root/roadmap-tracking.json" "$planning_dir/design.md" "$planning_dir/tasks.md" "$planning_dir/task-manifest.json"; do
+    if [[ ! -f "$file" ]]; then
+      echo "Example $example_id is missing required file: $file" >&2
+      exit 1
+    fi
+  done
+
+  assert_contains "$root/ROADMAP.md" "- Skill version: \`$ROADMAP_VERSION\`"
+  assert_contains "$root/ROADMAP.md" "- Tracking source: \`roadmap-tracking.json\`"
+  assert_contains "$root/BACKLOG.md" "- Skill version: \`$ROADMAP_VERSION\`"
+  assert_contains "$root/BACKLOG.md" "- Tracking source: \`roadmap-tracking.json\`"
+  assert_contains "$root/BACKLOG.md" "| RM-ID | Title | Source Stage | Priority | Primary Capability | Secondary Capabilities | Capability Gap | Expected Spec Delta | Evidence | Depends On | Parallel With | Unknowns | Next Decision | Ready |"
+  assert_contains "$root/BACKLOG.md" "## Ready For Req-Plan"
+  assert_contains "$root/BACKLOG.md" "  - Primary Capability:"
+  assert_contains "$root/BACKLOG.md" "  - Expected spec delta:"
+  jq -er '.version == 2 and (.items | length) > 0 and (.backlogMeta | type == "object") and (.dependencyHandoff | type == "object") and any(.items[]; .backlog != null)' "$root/roadmap-tracking.json" >/dev/null
+  assert_contains "$planning_dir/design.md" "- CC-Plan skill version: \`$REQ_PLAN_VERSION\`"
+  assert_contains "$planning_dir/tasks.md" "- CC-Plan skill version: \`$REQ_PLAN_VERSION\`"
+
+  jq -er --arg roadmap "$ROADMAP_VERSION" --arg reqplan "$REQ_PLAN_VERSION" '
+    (.sourceRoadmap.roadmapSkillVersion // $roadmap) == $roadmap and
+    (.planningMeta.reqPlanSkillVersion // $reqplan) == $reqplan
+  ' "$planning_dir/task-manifest.json" >/dev/null
+
+  assert_contains "$readme" "## Example Meta"
+  assert_contains "$readme" "\`cc-roadmap@$ROADMAP_VERSION\`"
+  assert_contains "$readme" "\`cc-plan@$REQ_PLAN_VERSION\`"
+  assert_contains "$readme" "\`cc-do@$REQ_DO_VERSION\`"
+  assert_contains "$readme" "\`cc-check@$REQ_CHECK_VERSION\`"
+
+  if jq -e '.covers | index("cc-act")' <<<"$encoded" >/dev/null; then
+    assert_contains "$readme" "\`cc-act@$REQ_ACT_VERSION\`"
+  fi
+
+  if [[ -f "$review_dir/report-card.json" ]]; then
+    "$ROOT_DIR/.claude/skills/cc-check/scripts/verify-gate.sh" --report "$review_dir/report-card.json" >/dev/null
+  fi
+
+  if jq -e '.covers | index("cc-act")' <<<"$encoded" >/dev/null; then
+    if [[ ! -f "$handoff_dir/pr-brief.md" && ! -f "$handoff_dir/resume-index.md" && ! -f "$handoff_dir/release-note.md" && ! -f "$handoff_dir/status.md" ]]; then
+      echo "Example $example_id is missing a final handoff file under $handoff_dir" >&2
+      exit 1
+    fi
+  fi
+done < <(jq -c '.examples[]' "$BINDINGS_FILE")
+
+echo "Example bindings are in sync with current skill versions"