cc-devflow 4.5.6 → 4.5.8

package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/planning/task-manifest.json

@@ -6,7 +6,7 @@
   "requirementId": "REQ-003",
   "requirementVersion": "REQ-003.v1",
   "planningMeta": {
-    "reqPlanSkillVersion": "3.7.7",
+    "reqPlanSkillVersion": "3.8.2",
     "designVersion": "design.v1",
     "approvedAt": "2026-04-16T13:10:00.000Z",
     "approvedBy": "user",
@@ -14,27 +14,58 @@
     "requirementBrief": {
       "problemStatement": "Admins can review audit summary rows in the UI, but weekly reporting requires manual copying.",
       "solutionSummary": "Add a CSV download action for the currently visible audit summary rows.",
-      "actors": ["workspace admin reviewing weekly activity"],
+      "actors": [
+        "workspace admin reviewing weekly activity"
+      ],
       "userStories": [
         {
           "id": "US-001",
           "actor": "workspace admin",
           "want": "download visible audit summary rows as CSV",
           "benefit": "include them in weekly reporting without manual copying",
-          "acceptance": ["Panel behavior test proves the export action uses current summary rows"]
+          "acceptance": [
+            "Panel behavior test proves the export action uses current summary rows"
+          ]
         }
       ],
       "edgeOrRecoveryStories": [],
-      "implementationDecisions": ["Export only rows already visible in the panel", "Keep CSV as the only output format"],
-      "testingDecisions": ["Test through the admin panel action and visible row data"],
-      "outOfScope": ["JSON export", "scheduled reporting", "shared reporting backend"],
-      "furtherNotes": ["Richer machine-readable exports should become a separate requirement"]
+      "implementationDecisions": [
+        "Export only rows already visible in the panel",
+        "Keep CSV as the only output format"
+      ],
+      "testingDecisions": [
+        "Test through the admin panel action and visible row data"
+      ],
+      "outOfScope": [
+        "JSON export",
+        "scheduled reporting",
+        "shared reporting backend"
+      ],
+      "furtherNotes": [
+        "Richer machine-readable exports should become a separate 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": "the local handoff exports existing visible rows and does not introduce a new reporting standard"
     },
     "decisionQuestions": [
       {
         "questionId": "D1",
         "gate": "approach-approval",
-        "knownEvidence": ["Existing admin panel already owns the visible summary rows", "No reporting backend is needed for the first useful export"],
+        "knownEvidence": [
+          "Existing admin panel already owns the visible summary rows",
+          "No reporting backend is needed for the first useful export"
+        ],
         "recommendation": "Approve the tiny-design CSV export",
         "options": [
           {
@@ -58,7 +89,28 @@
         "impact": "cc-do exports only visible rows from the current panel and avoids new reporting contracts",
         "status": "answered"
       }
-    ]
+    ],
+    "aiLeverageDecisionLens": {
+      "realUserOrOperator": "workspace admin preparing weekly review notes",
+      "statusQuoWorkaround": "manual copy of visible audit rows",
+      "humanTeamEffortForFullScope": "about one day for an engineer to implement, test, and document the local export",
+      "ccAgentEffortForFullScope": "about 30 minutes for visible-row CSV export plus targeted test and lint",
+      "aiCompressionRatio": "roughly 10x for the bounded local export path",
+      "completeLakeBoundary": "visible-row CSV export, panel action, current data source, targeted panel test, and lint",
+      "oceanBoundary": "JSON export, scheduled reporting, shared reporting backend, and cross-panel reporting platform",
+      "scopeRecommendation": "boil-lake",
+      "costModel": {
+        "agentTime": "low",
+        "humanReviewTime": "low",
+        "verificationCost": "targeted panel test plus lint",
+        "maintenanceCost": "low while scoped to visible rows",
+        "failureCost": "admins keep copying rows manually",
+        "reversibility": "reversible UI action"
+      },
+      "verdict": "boil-lake",
+      "missingEvidenceOrPivotReason": "",
+      "impactOnApprovedDirection": "complete the local visible-row export lake while deferring reporting platform work"
+    }
   },
   "currentTaskId": null,
   "activePhase": null,
@@ -70,22 +122,101 @@
       "phase": 1,
       "parallel": false,
       "dependsOn": [],
-      "touches": ["audit-summary", "tests"],
-      "files": ["src/admin/AuditSummaryPanel.test.tsx"],
-      "run": ["npm test -- src/admin/AuditSummaryPanel.test.tsx"],
-      "checks": ["test fails before implementation"],
-      "acceptance": ["the missing download action is reproduced as a failing test"],
-      "verification": ["npm test -- src/admin/AuditSummaryPanel.test.tsx"],
-      "evidence": ["failing test output"],
+      "touches": [
+        "audit-summary",
+        "tests"
+      ],
+      "files": [
+        "src/admin/AuditSummaryPanel.test.tsx"
+      ],
+      "run": [
+        "npm test -- src/admin/AuditSummaryPanel.test.tsx"
+      ],
+      "checks": [
+        "test fails before implementation"
+      ],
+      "acceptance": [
+        "the missing download action is reproduced as a failing test"
+      ],
+      "verification": [
+        "npm test -- src/admin/AuditSummaryPanel.test.tsx"
+      ],
+      "evidence": [
+        "failing test output"
+      ],
       "context": {
-        "readFiles": ["design.md", "tasks.md", "src/admin/AuditSummaryPanel.tsx"],
-        "commands": ["npm test -- src/admin/AuditSummaryPanel.test.tsx"],
-        "notes": ["stay inside the current audit summary panel"]
+        "readFiles": [
+          "design.md",
+          "tasks.md",
+          "src/admin/AuditSummaryPanel.tsx"
+        ],
+        "commands": [
+          "npm test -- src/admin/AuditSummaryPanel.test.tsx"
+        ],
+        "notes": [
+          "stay inside the current audit summary panel"
+        ]
+      },
+      "reviews": {
+        "spec": "pass",
+        "code": "pass"
       },
-      "reviews": { "spec": "pass", "code": "pass" },
       "status": "passed",
       "attempts": 1,
-      "maxRetries": 1
+      "maxRetries": 1,
+      "tddPhase": "red",
+      "verticalSlice": "Slice 1",
+      "testSeam": {
+        "entry": "admin audit panel UI behavior",
+        "behaviorAsserted": "the missing download action is reproduced as a failing test",
+        "specStyleTestName": "the missing download action is reproduced as a failing test",
+        "oneLogicalBehavior": true,
+        "publicVerificationPath": "Run the audit summary panel test and observe CSV export through visible rows",
+        "implementationDetailRisk": "low"
+      },
+      "feedbackLoop": {
+        "type": "automated-test",
+        "determinism": "deterministic",
+        "expectedFailure": "Fails before the behavior exists"
+      },
+      "allowedMocks": [
+        "download / blob 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/local-handoff/changes/REQ-003-audit-log-export/planning/task-manifest.json --tasks docs/examples/local-handoff/changes/REQ-003-audit-log-export/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",
@@ -93,23 +224,104 @@
       "type": "IMPL",
       "phase": 1,
       "parallel": false,
-      "dependsOn": ["T001"],
-      "touches": ["audit-summary"],
-      "files": ["src/admin/AuditSummaryPanel.tsx"],
-      "run": ["npm test -- src/admin/AuditSummaryPanel.test.tsx"],
-      "checks": ["panel test passes"],
-      "acceptance": ["admins can trigger a CSV download from the existing summary panel"],
-      "verification": ["npm test -- src/admin/AuditSummaryPanel.test.tsx"],
-      "evidence": ["passing test output", "checkpoint summary"],
+      "dependsOn": [
+        "T001"
+      ],
+      "touches": [
+        "audit-summary"
+      ],
+      "files": [
+        "src/admin/AuditSummaryPanel.tsx"
+      ],
+      "run": [
+        "npm test -- src/admin/AuditSummaryPanel.test.tsx"
+      ],
+      "checks": [
+        "panel test passes"
+      ],
+      "acceptance": [
+        "admins can trigger a CSV download from the existing summary panel"
+      ],
+      "verification": [
+        "npm test -- src/admin/AuditSummaryPanel.test.tsx"
+      ],
+      "evidence": [
+        "passing test output",
+        "checkpoint summary"
+      ],
       "context": {
-        "readFiles": ["design.md", "tasks.md", "src/admin/AuditSummaryPanel.test.tsx"],
-        "commands": ["npm test -- src/admin/AuditSummaryPanel.test.tsx"],
-        "notes": ["reuse visible summary rows as the export source"]
+        "readFiles": [
+          "design.md",
+          "tasks.md",
+          "src/admin/AuditSummaryPanel.test.tsx"
+        ],
+        "commands": [
+          "npm test -- src/admin/AuditSummaryPanel.test.tsx"
+        ],
+        "notes": [
+          "reuse visible summary rows as the export source"
+        ]
+      },
+      "reviews": {
+        "spec": "pass",
+        "code": "pass"
       },
-      "reviews": { "spec": "pass", "code": "pass" },
       "status": "passed",
       "attempts": 1,
-      "maxRetries": 1
+      "maxRetries": 1,
+      "tddPhase": "green",
+      "verticalSlice": "Slice 2",
+      "testSeam": {
+        "entry": "admin audit panel UI behavior",
+        "behaviorAsserted": "admins can trigger a CSV download from the existing summary panel",
+        "specStyleTestName": "admins can trigger a CSV download from the existing summary panel",
+        "oneLogicalBehavior": true,
+        "publicVerificationPath": "Run the audit summary panel test and observe CSV export through visible rows",
+        "implementationDetailRisk": "low"
+      },
+      "feedbackLoop": {
+        "type": "automated-test",
+        "determinism": "deterministic",
+        "expectedFailure": ""
+      },
+      "allowedMocks": [
+        "download / blob 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/local-handoff/changes/REQ-003-audit-log-export/planning/task-manifest.json --tasks docs/examples/local-handoff/changes/REQ-003-audit-log-export/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",
@@ -117,37 +329,147 @@
       "type": "OTHER",
       "phase": 2,
       "parallel": false,
-      "dependsOn": ["T002"],
-      "touches": ["quality-gates"],
-      "files": ["src/admin/AuditSummaryPanel.tsx", "src/admin/AuditSummaryPanel.test.tsx"],
+      "dependsOn": [
+        "T002"
+      ],
+      "touches": [
+        "quality-gates"
+      ],
+      "files": [
+        "src/admin/AuditSummaryPanel.tsx",
+        "src/admin/AuditSummaryPanel.test.tsx"
+      ],
       "run": [
         "npm test -- src/admin/AuditSummaryPanel.test.tsx",
         "npm run lint -- src/admin/AuditSummaryPanel.tsx"
       ],
-      "checks": ["targeted tests pass", "lint passes"],
-      "acceptance": ["fresh verification evidence exists for local handoff"],
+      "checks": [
+        "targeted tests pass",
+        "lint passes"
+      ],
+      "acceptance": [
+        "fresh verification evidence exists for local handoff"
+      ],
       "verification": [
         "npm test -- src/admin/AuditSummaryPanel.test.tsx",
         "npm run lint -- src/admin/AuditSummaryPanel.tsx"
       ],
-      "evidence": ["passing test output", "clean lint output"],
+      "evidence": [
+        "passing test output",
+        "clean lint output"
+      ],
       "context": {
-        "readFiles": ["tasks.md", "task-manifest.json"],
+        "readFiles": [
+          "tasks.md",
+          "task-manifest.json"
+        ],
         "commands": [
           "npm test -- src/admin/AuditSummaryPanel.test.tsx",
           "npm run lint -- src/admin/AuditSummaryPanel.tsx"
         ],
-        "notes": ["remote push is intentionally out of scope for this example"]
+        "notes": [
+          "remote push is intentionally out of scope for this example"
+        ]
+      },
+      "reviews": {
+        "spec": "pass",
+        "code": "pass"
       },
-      "reviews": { "spec": "pass", "code": "pass" },
       "status": "passed",
       "attempts": 1,
-      "maxRetries": 1
+      "maxRetries": 1,
+      "tddPhase": "evidence",
+      "verticalSlice": "Slice 3",
+      "testSeam": {
+        "entry": "admin audit panel UI behavior",
+        "behaviorAsserted": "fresh verification evidence exists for local handoff",
+        "specStyleTestName": "fresh verification evidence exists for local handoff",
+        "oneLogicalBehavior": true,
+        "publicVerificationPath": "Run the audit summary panel test and observe CSV export through visible rows",
+        "implementationDetailRisk": "low"
+      },
+      "feedbackLoop": {
+        "type": "automated-test",
+        "determinism": "deterministic",
+        "expectedFailure": ""
+      },
+      "allowedMocks": [
+        "download / blob 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/local-handoff/changes/REQ-003-audit-log-export/planning/task-manifest.json --tasks docs/examples/local-handoff/changes/REQ-003-audit-log-export/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": {
     "source": "tasks.md",
     "generatedBy": "docs-example",
     "planVersion": 1
+  },
+  "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/local-handoff/changes/REQ-003-audit-log-export/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/local-handoff/changes/REQ-003-audit-log-export/planning/task-manifest.json --tasks docs/examples/local-handoff/changes/REQ-003-audit-log-export/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/local-handoff/changes/REQ-003-audit-log-export/planning/tasks.md

@@ -4,7 +4,7 @@
 
 - Requirement version: `REQ-003.v1`
 - Design version: `design.v1`
-- CC-Plan skill version: `3.7.7`
+- CC-Plan skill version: `3.8.2`
 - Source roadmap item: `RM-020`
 - Source roadmap version: `roadmap.v3`
 
@@ -22,6 +22,7 @@
   - Implementation decisions: export visible rows only, CSV only
   - Testing decisions: test through admin panel action and visible row data
   - Out of scope: JSON export, scheduled reporting, shared reporting backend
+- AI Leverage Decision Lens: boil-lake; complete visible-row CSV export while keeping reporting-platform work outside the lake
 - Read first:
   - `design.md`
   - `src/admin/AuditSummaryPanel.tsx`
@@ -35,32 +36,66 @@
   - panel placement
 - Parallel boundaries: none
 
+## 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/local-handoff/changes/REQ-003-audit-log-export/planning/task-manifest.json
+bash "$SCRIPT_ROOT/mark-task-complete.sh" --manifest docs/examples/local-handoff/changes/REQ-003-audit-log-export/planning/task-manifest.json --tasks docs/examples/local-handoff/changes/REQ-003-audit-log-export/planning/tasks.md --task <task-id>
+```
+
 ## Phase 1: Foundation
 
 - [x] T001 [TEST] Add a failing test for the missing download action (dependsOn:none) `src/admin/AuditSummaryPanel.test.tsx`
   Goal: 证明现在还没有可下载的 summary export。
+  TDD phase: red
   Files: `src/admin/AuditSummaryPanel.test.tsx`
   Read first: `design.md`, `src/admin/AuditSummaryPanel.tsx`
   Verification: `npm test -- src/admin/AuditSummaryPanel.test.tsx`
   Evidence: failing 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/local-handoff/changes/REQ-003-audit-log-export/planning/task-manifest.json --tasks docs/examples/local-handoff/changes/REQ-003-audit-log-export/planning/tasks.md --task T001`; do not hand-edit status.
+  Test seam: admin audit panel UI behavior
+  Public verification path: Run the audit summary panel test and observe CSV export through visible rows
+  Allowed mocks: download / blob boundary
   Ready when: 当前 audit summary test 已可运行
 
 - [x] T002 [IMPL] Add the download summary action (dependsOn:T001) `src/admin/AuditSummaryPanel.tsx`
   Goal: 用最小实现让 summary export 真的可用。
+  TDD phase: green
   Files: `src/admin/AuditSummaryPanel.tsx`
   Read first: `design.md`, `src/admin/AuditSummaryPanel.test.tsx`
   Verification: `npm test -- src/admin/AuditSummaryPanel.test.tsx`
   Evidence: passing output + checkpoint
+  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/local-handoff/changes/REQ-003-audit-log-export/planning/task-manifest.json --tasks docs/examples/local-handoff/changes/REQ-003-audit-log-export/planning/tasks.md --task T002`; do not hand-edit status.
+  Test seam: admin audit panel UI behavior
+  Public verification path: Run the audit summary panel test and observe CSV export through visible rows
+  Allowed mocks: download / blob boundary
   Ready when: T001 已见红
 
 ## Phase 2: Verify
 
 - [x] T003 Run targeted checks and collect handoff evidence (dependsOn:T002) `audit summary quality gates`
   Goal: 为 `cc-check` 和 `cc-act` 留下这次导出改动的真实证据。
+  TDD phase: evidence
   Files: `src/admin/AuditSummaryPanel.tsx`, `src/admin/AuditSummaryPanel.test.tsx`
   Read first: `tasks.md`, `task-manifest.json`
   Verification:
   - `npm test -- src/admin/AuditSummaryPanel.test.tsx`
   - `npm run lint -- src/admin/AuditSummaryPanel.tsx`
   Evidence: passing 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/local-handoff/changes/REQ-003-audit-log-export/planning/task-manifest.json --tasks docs/examples/local-handoff/changes/REQ-003-audit-log-export/planning/tasks.md --task T003`; do not hand-edit status.
+  Test seam: admin audit panel UI behavior
+  Public verification path: Run the audit summary panel test and observe CSV export through visible rows
+  Allowed mocks: download / blob boundary
   Ready when: T002 已完成

package/docs/examples/local-handoff/roadmap.json

@@ -5,7 +5,7 @@
   },
   "meta": {
     "roadmapVersion": "roadmap.v2",
-    "skillVersion": "5.0.0",
+    "skillVersion": "5.2.0",
     "status": "active",
     "lastUpdated": "2026-04-19",
     "currentFocusStage": "Stage 2"
@@ -14,7 +14,21 @@
     "planningPosture": "",
     "evidenceMaturity": "",
     "canonicalTerms": [],
-    "durableDecisionSources": []
+    "durableDecisionSources": [],
+    "aiLeverageRouteLens": {
+      "realUserOrOperator": "workspace admin preparing weekly activity review notes",
+      "statusQuoWorkaround": "manual copy of visible audit rows into an internal note",
+      "humanTeamEffortForFullScope": "about one day for an engineer to implement, test, and document the local export",
+      "ccAgentEffortForFullScope": "about 30 minutes for visible-row CSV export plus targeted test and lint",
+      "aiCompressionRatio": "roughly 10x for the bounded local export path",
+      "completeLakeBoundary": "visible-row CSV export, panel action, current data source, targeted panel test, and lint",
+      "oceanBoundary": "JSON export, scheduled reporting, shared reporting backend, and cross-panel reporting platform",
+      "scopeRecommendation": "boil-lake",
+      "firstSuccessSignal": "admins finish weekly review without manual row copying",
+      "killSignal": "implementation requires shared reporting pipeline redesign",
+      "verdict": "boil-lake",
+      "missingEvidence": []
+    }
   },
   "evidence": [],
   "route": {

package/docs/examples/pdca-loop/BACKLOG.md

@@ -5,7 +5,7 @@
 ## Backlog Meta
 
 - Roadmap version: `roadmap.v1`
-- Skill version: `5.0.0`
+- Skill version: `5.2.0`
 - Last synced: `2026-04-19`
 - Current focus stage: `Stage 1`
 - Roadmap state source: `roadmap.json`

package/docs/examples/pdca-loop/README.md

@@ -4,7 +4,7 @@
 
 - Example version: `1.0.0`
 - Last reviewed: `2026-04-17`
-- Bound skills: `cc-roadmap@5.0.0`, `cc-plan@3.7.7`, `cc-do@1.6.2`, `cc-check@1.10.1`, `cc-act@1.8.2`
+- Bound skills: `cc-roadmap@5.2.0`, `cc-plan@3.8.2`, `cc-do@1.6.3`, `cc-check@1.10.1`, `cc-act@1.8.3`
 
 This folder shows one minimal but complete `cc-roadmap -> cc-plan -> cc-do -> cc-check -> cc-act` loop.
 

package/docs/examples/pdca-loop/ROADMAP.md

@@ -3,7 +3,7 @@
 ## Roadmap Meta
 
 - Roadmap version: `roadmap.v1`
-- Skill version: `5.0.0`
+- Skill version: `5.2.0`
 - Status: `active`
 - Last updated: `2026-04-15`
 - Owner / decider: `product-owner`
@@ -36,6 +36,21 @@
 | Feasibility | Existing dialog already renders the URL and clipboard API is available | High | current UI behavior | This is a tiny patch, not a redesign |
 | Distribution | Successful sharing unlocks more beta seats | Med | product notes | A smoother invite loop increases activation |
 
+## AI Leverage Route Lens
+
+- Real user / operator: workspace member sharing an invite during beta onboarding
+- Status quo workaround: manually select and copy 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: backend invite generation, permissions, analytics, and clipboard fallback redesign
+- Scope recommendation: `boil-lake`
+- First success signal: users copy the invite link without asking support
+- Kill signal: implementation requires backend or permission changes
+- Verdict: `boil-lake`
+- Missing evidence before ready-for-cc-plan: none
+
 ## Route Options
 
 | Shape | Why this could work | Why this may fail | Decision |