cc-devflow 4.2.0 → 4.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (559) hide show
  1. package/.claude/skills/cc-act/CHANGELOG.md +64 -0
  2. package/.claude/skills/cc-act/PLAYBOOK.md +212 -0
  3. package/.claude/skills/cc-act/SKILL.md +322 -0
  4. package/.claude/skills/cc-act/assets/PR_BRIEF_TEMPLATE.md +64 -0
  5. package/.claude/skills/cc-act/assets/RELEASE_NOTE_TEMPLATE.md +25 -0
  6. package/.claude/skills/cc-act/references/closure-contract.md +49 -0
  7. package/.claude/skills/cc-act/references/git-commit-guidelines.md +83 -0
  8. package/.claude/skills/cc-act/scripts/archive-requirement.sh +49 -0
  9. package/.claude/skills/cc-act/scripts/cc-act-common.sh +240 -0
  10. package/.claude/skills/cc-act/scripts/detect-ship-target.sh +82 -0
  11. package/.claude/skills/cc-act/scripts/generate-status-report.sh +83 -0
  12. package/.claude/skills/cc-act/scripts/render-pr-brief.sh +195 -0
  13. package/.claude/skills/cc-act/scripts/sync-act-docs.sh +315 -0
  14. package/.claude/skills/cc-act/scripts/verify-act-gate.sh +63 -0
  15. package/.claude/skills/cc-check/CHANGELOG.md +73 -0
  16. package/.claude/skills/cc-check/PLAYBOOK.md +153 -0
  17. package/.claude/skills/cc-check/SKILL.md +345 -0
  18. package/.claude/skills/cc-check/assets/REPORT_CARD_TEMPLATE.json +50 -0
  19. package/.claude/skills/cc-check/references/gate-contract.md +29 -0
  20. package/.claude/skills/cc-check/references/review-contract.md +45 -0
  21. package/.claude/skills/cc-check/scripts/render-report-card.js +229 -0
  22. package/.claude/skills/cc-check/scripts/run-quality-gates.sh +86 -0
  23. package/.claude/skills/cc-check/scripts/verify-gate.sh +57 -0
  24. package/.claude/skills/cc-do/CHANGELOG.md +49 -0
  25. package/.claude/skills/cc-do/PLAYBOOK.md +119 -0
  26. package/.claude/skills/cc-do/SKILL.md +216 -0
  27. package/.claude/skills/cc-do/references/execution-recovery.md +86 -0
  28. package/.claude/skills/cc-do/references/parallel-dispatch.md +80 -0
  29. package/.claude/skills/cc-do/scripts/build-task-context.sh +184 -0
  30. package/.claude/skills/cc-do/scripts/cc-do-common.sh +79 -0
  31. package/.claude/skills/cc-do/scripts/check-task-status.sh +92 -0
  32. package/.claude/skills/cc-do/scripts/detect-file-conflicts.sh +87 -0
  33. package/.claude/skills/cc-do/scripts/mark-task-complete.sh +119 -0
  34. package/.claude/skills/cc-do/scripts/record-review-decision.sh +89 -0
  35. package/.claude/skills/cc-do/scripts/recover-workflow.sh +84 -0
  36. package/.claude/skills/cc-do/scripts/run-problem-analysis.sh +70 -0
  37. package/.claude/skills/cc-do/scripts/select-ready-tasks.sh +135 -0
  38. package/.claude/skills/cc-do/scripts/verify-task-gates.sh +94 -0
  39. package/.claude/skills/cc-do/scripts/write-task-checkpoint.sh +102 -0
  40. package/.claude/skills/cc-investigate/CHANGELOG.md +26 -0
  41. package/.claude/skills/cc-investigate/PLAYBOOK.md +49 -0
  42. package/.claude/skills/cc-investigate/SKILL.md +221 -0
  43. package/.claude/skills/cc-investigate/assets/ANALYSIS_TEMPLATE.md +55 -0
  44. package/.claude/skills/cc-investigate/assets/TASKS_TEMPLATE.md +52 -0
  45. package/.claude/skills/cc-investigate/assets/TASK_MANIFEST_TEMPLATE.json +103 -0
  46. package/.claude/skills/cc-investigate/references/investigation-contract.md +28 -0
  47. package/.claude/skills/cc-investigate/scripts/bootstrap-analysis.sh +38 -0
  48. package/.claude/skills/cc-plan/CHANGELOG.md +99 -0
  49. package/.claude/skills/cc-plan/PLAYBOOK.md +106 -0
  50. package/.claude/skills/cc-plan/SKILL.md +325 -0
  51. package/.claude/skills/cc-plan/assets/DESIGN_TEMPLATE.md +155 -0
  52. package/.claude/skills/cc-plan/assets/TASKS_TEMPLATE.md +98 -0
  53. package/.claude/skills/cc-plan/assets/TASK_MANIFEST_TEMPLATE.json +108 -0
  54. package/.claude/skills/cc-plan/assets/TINY_DESIGN_TEMPLATE.md +79 -0
  55. package/.claude/skills/cc-plan/references/planning-contract.md +82 -0
  56. package/.claude/skills/cc-plan/scripts/bump-skill-version.sh +103 -0
  57. package/.claude/skills/cc-plan/scripts/parse-task-dependencies.js +75 -0
  58. package/.claude/skills/cc-plan/scripts/validate-scope.sh +78 -0
  59. package/.claude/skills/cc-roadmap/CHANGELOG.md +114 -0
  60. package/.claude/skills/cc-roadmap/PLAYBOOK.md +136 -0
  61. package/.claude/skills/cc-roadmap/SKILL.md +259 -0
  62. package/.claude/skills/cc-roadmap/assets/BACKLOG_TEMPLATE.md +45 -0
  63. package/.claude/skills/cc-roadmap/assets/ROADMAP_TEMPLATE.md +153 -0
  64. package/.claude/skills/cc-roadmap/assets/TRACKING_TEMPLATE.json +48 -0
  65. package/.claude/skills/cc-roadmap/references/roadmap-dialogue.md +37 -0
  66. package/.claude/skills/cc-roadmap/scripts/bump-skill-version.sh +103 -0
  67. package/.claude/skills/cc-roadmap/scripts/lib/roadmap-tracking/markdown.js +604 -0
  68. package/.claude/skills/cc-roadmap/scripts/lib/roadmap-tracking/query.js +63 -0
  69. package/.claude/skills/cc-roadmap/scripts/lib/roadmap-tracking/schema.js +245 -0
  70. package/.claude/skills/cc-roadmap/scripts/lib/roadmap-tracking/store.js +139 -0
  71. package/.claude/skills/cc-roadmap/scripts/locate-roadmap-item.sh +109 -0
  72. package/.claude/skills/cc-roadmap/scripts/roadmap-tracking.js +153 -0
  73. package/.claude/skills/cc-roadmap/scripts/sync-roadmap-progress.sh +100 -0
  74. package/.claude/skills/cc-simplify/CHANGELOG.md +10 -0
  75. package/.claude/skills/cc-simplify/SKILL.md +55 -0
  76. package/.claude/skills/cc-spec-init/CHANGELOG.md +7 -0
  77. package/.claude/skills/cc-spec-init/PLAYBOOK.md +55 -0
  78. package/.claude/skills/cc-spec-init/SKILL.md +127 -0
  79. package/.claude/skills/cc-spec-init/assets/CAPABILITY_TEMPLATE.md +63 -0
  80. package/.claude/skills/cc-spec-init/assets/CHANGE_META_TEMPLATE.json +25 -0
  81. package/.claude/skills/cc-spec-init/assets/INDEX_TEMPLATE.md +34 -0
  82. package/.claude/skills/cc-spec-init/references/spec-contract.md +22 -0
  83. package/.claude/skills/cc-spec-init/scripts/bootstrap-specs.sh +31 -0
  84. package/.claude/skills/cc-spec-init/scripts/validate-spec-links.sh +45 -0
  85. package/CHANGELOG.md +101 -4
  86. package/README.md +120 -755
  87. package/README.zh-CN.md +119 -755
  88. package/bin/adapt.js +2 -6
  89. package/bin/cc-devflow-cli.js +72 -177
  90. package/config/distributable-skills.json +24 -0
  91. package/docs/CLAUDE.md +10 -6
  92. package/docs/commands/README.md +19 -46
  93. package/docs/commands/README.zh-CN.md +25 -48
  94. package/docs/examples/BY-ARTIFACT.md +7 -0
  95. package/docs/examples/README.md +38 -0
  96. package/docs/examples/START-HERE.md +149 -0
  97. package/docs/examples/example-bindings.json +38 -0
  98. package/docs/examples/full-design-blocked/BACKLOG.md +45 -0
  99. package/docs/examples/full-design-blocked/README.md +55 -0
  100. package/docs/examples/full-design-blocked/ROADMAP.md +53 -0
  101. package/docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/planning/design.md +154 -0
  102. package/docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/planning/task-manifest.json +146 -0
  103. package/docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/planning/tasks.md +78 -0
  104. package/docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/review/report-card.json +52 -0
  105. package/docs/examples/full-design-blocked/roadmap-tracking.json +50 -0
  106. package/docs/examples/local-handoff/BACKLOG.md +45 -0
  107. package/docs/examples/local-handoff/README.md +56 -0
  108. package/docs/examples/local-handoff/ROADMAP.md +45 -0
  109. package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/handoff/resume-index.md +39 -0
  110. package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/handoff/status.md +29 -0
  111. package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/planning/design.md +71 -0
  112. package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/planning/task-manifest.json +98 -0
  113. package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/planning/tasks.md +59 -0
  114. package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/review/report-card.json +44 -0
  115. package/docs/examples/local-handoff/roadmap-tracking.json +48 -0
  116. package/docs/examples/pdca-loop/BACKLOG.md +46 -0
  117. package/docs/examples/pdca-loop/README.md +58 -0
  118. package/docs/examples/pdca-loop/ROADMAP.md +133 -0
  119. package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/handoff/pr-brief.md +72 -0
  120. package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/handoff/status.md +29 -0
  121. package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/design.md +72 -0
  122. package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/task-manifest.json +201 -0
  123. package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/tasks.md +73 -0
  124. package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/review/report-card.json +44 -0
  125. package/docs/examples/pdca-loop/roadmap-tracking.json +114 -0
  126. package/docs/examples/scripts/check-example-bindings.sh +116 -0
  127. package/docs/guides/getting-started.md +94 -129
  128. package/docs/guides/getting-started.zh-CN.md +103 -84
  129. package/docs/skill-runtime-migration.md +46 -0
  130. package/docs/v4.3.0-migration-guide.md +111 -0
  131. package/lib/compiler/CLAUDE.md +55 -84
  132. package/lib/compiler/__tests__/drift.test.js +1 -1
  133. package/lib/compiler/__tests__/errors.test.js +0 -1
  134. package/lib/compiler/__tests__/integration.test.js +49 -3
  135. package/lib/compiler/__tests__/manifest.test.js +0 -156
  136. package/lib/compiler/__tests__/parser.test.js +33 -104
  137. package/lib/compiler/__tests__/schemas.test.js +30 -34
  138. package/lib/compiler/__tests__/skills-registry.test.js +114 -0
  139. package/lib/compiler/__tests__/transformer.test.js +5 -9
  140. package/lib/compiler/emitters/antigravity-emitter.js +5 -213
  141. package/lib/compiler/emitters/base-emitter.js +3 -298
  142. package/lib/compiler/emitters/codex-emitter.js +4 -202
  143. package/lib/compiler/emitters/cursor-emitter.js +3 -287
  144. package/lib/compiler/emitters/qwen-emitter.js +4 -176
  145. package/lib/compiler/index.js +65 -345
  146. package/lib/compiler/manifest.js +6 -68
  147. package/lib/compiler/parser.js +31 -63
  148. package/lib/compiler/platforms.js +32 -277
  149. package/lib/compiler/resource-copier.js +176 -6
  150. package/lib/compiler/rules-emitters/__tests__/antigravity-rules-emitter.test.js +3 -3
  151. package/lib/compiler/rules-emitters/__tests__/cursor-rules-emitter.test.js +14 -4
  152. package/lib/compiler/rules-emitters/__tests__/qwen-rules-emitter.test.js +16 -7
  153. package/lib/compiler/rules-emitters/antigravity-rules-emitter.js +10 -15
  154. package/lib/compiler/rules-emitters/base-rules-emitter.js +5 -5
  155. package/lib/compiler/rules-emitters/cursor-rules-emitter.js +7 -12
  156. package/lib/compiler/rules-emitters/index.js +6 -3
  157. package/lib/compiler/rules-emitters/qwen-rules-emitter.js +7 -7
  158. package/lib/compiler/schemas.js +8 -4
  159. package/lib/compiler/skills-registry.js +213 -15
  160. package/lib/compiler/transformer.js +1 -1
  161. package/lib/skill-runtime/CLAUDE.md +19 -0
  162. package/lib/skill-runtime/__tests__/autopilot.test.js +210 -0
  163. package/lib/skill-runtime/__tests__/cli-bootstrap.integration.test.js +181 -0
  164. package/lib/skill-runtime/__tests__/delegation.test.js +97 -0
  165. package/lib/skill-runtime/__tests__/dispatch.test.js +267 -0
  166. package/lib/skill-runtime/__tests__/intent.test.js +219 -0
  167. package/lib/skill-runtime/__tests__/lifecycle.test.js +169 -0
  168. package/lib/skill-runtime/__tests__/paths.test.js +42 -0
  169. package/lib/skill-runtime/__tests__/planner.tdd.test.js +250 -0
  170. package/lib/skill-runtime/__tests__/prepare-pr.test.js +139 -0
  171. package/lib/skill-runtime/__tests__/query.test.js +284 -0
  172. package/lib/skill-runtime/__tests__/runtime.integration.test.js +279 -0
  173. package/lib/skill-runtime/__tests__/schemas.test.js +207 -0
  174. package/lib/skill-runtime/__tests__/team-state.test.js +51 -0
  175. package/lib/skill-runtime/__tests__/worker-run.test.js +253 -0
  176. package/lib/skill-runtime/__tests__/worker.test.js +56 -0
  177. package/lib/skill-runtime/artifacts.js +93 -0
  178. package/lib/skill-runtime/delegation.js +533 -0
  179. package/lib/skill-runtime/index.js +34 -0
  180. package/lib/skill-runtime/intent.js +333 -0
  181. package/lib/skill-runtime/lifecycle.js +294 -0
  182. package/lib/skill-runtime/operations/CLAUDE.md +19 -0
  183. package/lib/skill-runtime/operations/approve.js +66 -0
  184. package/lib/skill-runtime/operations/autopilot-core.js +337 -0
  185. package/lib/skill-runtime/operations/autopilot-execution.js +307 -0
  186. package/lib/skill-runtime/operations/autopilot-shared.js +48 -0
  187. package/lib/skill-runtime/operations/autopilot.js +163 -0
  188. package/lib/skill-runtime/operations/dispatch.js +454 -0
  189. package/lib/skill-runtime/operations/init.js +64 -0
  190. package/lib/{harness → skill-runtime}/operations/janitor.js +9 -6
  191. package/lib/skill-runtime/operations/plan.js +59 -0
  192. package/lib/skill-runtime/operations/prepare-pr.js +25 -0
  193. package/lib/{harness → skill-runtime}/operations/release.js +18 -5
  194. package/lib/skill-runtime/operations/resume.js +143 -0
  195. package/lib/skill-runtime/operations/snapshot.js +45 -0
  196. package/lib/skill-runtime/operations/verify.js +170 -0
  197. package/lib/skill-runtime/operations/worker-run.js +529 -0
  198. package/lib/skill-runtime/operations/worker.js +33 -0
  199. package/lib/skill-runtime/paths.js +213 -0
  200. package/lib/skill-runtime/planner.js +519 -0
  201. package/lib/skill-runtime/query.js +157 -0
  202. package/lib/skill-runtime/review.js +557 -0
  203. package/lib/skill-runtime/schemas.js +400 -0
  204. package/lib/{harness → skill-runtime}/store.js +45 -30
  205. package/lib/skill-runtime/team-state.js +122 -0
  206. package/package.json +13 -11
  207. package/.claude/CLAUDE.md +0 -125
  208. package/.claude/agents/architecture-designer.md +0 -443
  209. package/.claude/agents/bug-analyzer.md +0 -381
  210. package/.claude/agents/checklist-agent.md +0 -175
  211. package/.claude/agents/clarify-analyst.md +0 -50
  212. package/.claude/agents/code-quality-reviewer.md +0 -205
  213. package/.claude/agents/code-reviewer.md +0 -71
  214. package/.claude/agents/codex-analyzer.md +0 -39
  215. package/.claude/agents/compatibility-checker.md +0 -579
  216. package/.claude/agents/consistency-checker.md +0 -532
  217. package/.claude/agents/dev-implementer.md +0 -195
  218. package/.claude/agents/flow-researcher.md +0 -132
  219. package/.claude/agents/impact-analyzer.md +0 -440
  220. package/.claude/agents/planner.md +0 -230
  221. package/.claude/agents/prd-writer.md +0 -320
  222. package/.claude/agents/project-guidelines-generator.md +0 -1329
  223. package/.claude/agents/qa-tester.md +0 -313
  224. package/.claude/agents/release-manager.md +0 -295
  225. package/.claude/agents/security-reviewer.md +0 -314
  226. package/.claude/agents/spec-reviewer.md +0 -221
  227. package/.claude/agents/style-guide-generator.md +0 -458
  228. package/.claude/agents/tech-architect.md +0 -516
  229. package/.claude/agents/ui-designer.md +0 -485
  230. package/.claude/commands/core/architecture.md +0 -459
  231. package/.claude/commands/core/guidelines.md +0 -511
  232. package/.claude/commands/core/roadmap.md +0 -468
  233. package/.claude/commands/core/style.md +0 -83
  234. package/.claude/commands/flow/CLAUDE.md +0 -28
  235. package/.claude/commands/flow/archive.md +0 -280
  236. package/.claude/commands/flow/checklist.md +0 -18
  237. package/.claude/commands/flow/clarify.md +0 -18
  238. package/.claude/commands/flow/constitution.md +0 -82
  239. package/.claude/commands/flow/context.md +0 -150
  240. package/.claude/commands/flow/delta.md +0 -245
  241. package/.claude/commands/flow/dev.md +0 -40
  242. package/.claude/commands/flow/fix.md +0 -217
  243. package/.claude/commands/flow/ideate.md +0 -214
  244. package/.claude/commands/flow/init.md +0 -38
  245. package/.claude/commands/flow/new.md +0 -23
  246. package/.claude/commands/flow/quality.md +0 -21
  247. package/.claude/commands/flow/release.md +0 -36
  248. package/.claude/commands/flow/restart.md +0 -97
  249. package/.claude/commands/flow/spec.md +0 -36
  250. package/.claude/commands/flow/status.md +0 -64
  251. package/.claude/commands/flow/update.md +0 -111
  252. package/.claude/commands/flow/upgrade.md +0 -115
  253. package/.claude/commands/flow/verify.md +0 -37
  254. package/.claude/commands/flow/workspace.md +0 -155
  255. package/.claude/commands/util/cancel-ralph.md +0 -60
  256. package/.claude/commands/util/code-review.md +0 -58
  257. package/.claude/commands/util/git-commit.md +0 -422
  258. package/.claude/commands/util/problem-analyzer.md +0 -60
  259. package/.claude/config/quality-gates.yml +0 -305
  260. package/.claude/config/quality-rules.yml +0 -161
  261. package/.claude/docs/SPEC_KIT_CONSTITUTION_ANALYSIS.md +0 -426
  262. package/.claude/docs/design/consistency-conflict-detection-algorithms.md +0 -658
  263. package/.claude/docs/design/intent-driven-input-design.md +0 -380
  264. package/.claude/docs/design/prd-version-management-design.md +0 -437
  265. package/.claude/docs/guides/INIT_TROUBLESHOOTING.md +0 -117
  266. package/.claude/docs/guides/NEW_TROUBLESHOOTING.md +0 -99
  267. package/.claude/docs/guides/ROADMAP_TROUBLESHOOTING.md +0 -188
  268. package/.claude/docs/guides/TASK_COMPLETION_MARKING.md +0 -338
  269. package/.claude/docs/guides/TEAM_MODE_GUIDE.md +0 -312
  270. package/.claude/docs/templates/ARCHITECTURE_TEMPLATE.md +0 -633
  271. package/.claude/docs/templates/ATTEMPT_TEMPLATE.md +0 -156
  272. package/.claude/docs/templates/BACKLOG_TEMPLATE.md +0 -261
  273. package/.claude/docs/templates/BRAINSTORM_TEMPLATE.md +0 -148
  274. package/.claude/docs/templates/CHECKLIST_TEMPLATE.md +0 -52
  275. package/.claude/docs/templates/CLARIFICATION_REPORT_TEMPLATE.md +0 -206
  276. package/.claude/docs/templates/CODE_REVIEW_TEMPLATE.md +0 -71
  277. package/.claude/docs/templates/DELTA_SPEC_TEMPLATE.md +0 -91
  278. package/.claude/docs/templates/DESIGN_DECISIONS_TEMPLATE.md +0 -151
  279. package/.claude/docs/templates/EPIC_TEMPLATE.md +0 -805
  280. package/.claude/docs/templates/ERROR_LOG_TEMPLATE.md +0 -80
  281. package/.claude/docs/templates/INIT_FLOW_TEMPLATE.md +0 -198
  282. package/.claude/docs/templates/INTENT_CLARIFICATION_TEMPLATE.md +0 -57
  283. package/.claude/docs/templates/JOURNAL_TEMPLATE.md +0 -75
  284. package/.claude/docs/templates/NEW_ORCHESTRATION_TEMPLATE.md +0 -76
  285. package/.claude/docs/templates/PRD_TEMPLATE.md +0 -562
  286. package/.claude/docs/templates/RESEARCH_TEMPLATE.md +0 -276
  287. package/.claude/docs/templates/REVIEW-HIGH.md +0 -57
  288. package/.claude/docs/templates/ROADMAP_DIALOGUE_TEMPLATE.md +0 -198
  289. package/.claude/docs/templates/ROADMAP_TEMPLATE.md +0 -310
  290. package/.claude/docs/templates/STYLE_TEMPLATE.md +0 -1266
  291. package/.claude/docs/templates/TASKS_TEMPLATE.md +0 -523
  292. package/.claude/docs/templates/TECH_DESIGN_TEMPLATE.md +0 -1019
  293. package/.claude/docs/templates/UI_PROTOTYPE_TEMPLATE.md +0 -1435
  294. package/.claude/docs/templates/_shared/CLAUDE.md +0 -36
  295. package/.claude/docs/templates/_shared/CONSTITUTION_CHECK.md +0 -125
  296. package/.claude/docs/templates/_shared/VALIDATION_CHECKLIST.md +0 -187
  297. package/.claude/docs/templates/_shared/YAML_FRONTMATTER.md +0 -164
  298. package/.claude/docs/templates/context/dev.jsonl.template +0 -6
  299. package/.claude/docs/templates/context/epic.jsonl.template +0 -5
  300. package/.claude/docs/templates/context/prd.jsonl.template +0 -4
  301. package/.claude/docs/templates/context/research.jsonl.template +0 -4
  302. package/.claude/docs/templates/context/review.jsonl.template +0 -5
  303. package/.claude/docs/templates/context/tech.jsonl.template +0 -5
  304. package/.claude/guides/agent-guides/agent-coordination-guide.md +0 -459
  305. package/.claude/guides/project-guidelines-system.md +0 -463
  306. package/.claude/guides/technical-guides/datetime-handling-guide.md +0 -563
  307. package/.claude/guides/technical-guides/git-github-guide.md +0 -642
  308. package/.claude/guides/technical-guides/test-execution-guide.md +0 -618
  309. package/.claude/guides/workflow-guides/bug-fix-orchestrator.md +0 -217
  310. package/.claude/guides/workflow-guides/flow-orchestrator.md +0 -48
  311. package/.claude/hooks/CLAUDE.md +0 -342
  312. package/.claude/hooks/checklist-gate.js +0 -397
  313. package/.claude/hooks/error-handling-reminder.sh +0 -12
  314. package/.claude/hooks/error-handling-reminder.ts +0 -459
  315. package/.claude/hooks/hooks.json +0 -15
  316. package/.claude/hooks/inject-agent-context.ts +0 -480
  317. package/.claude/hooks/inject-skill-context.ts +0 -359
  318. package/.claude/hooks/post-tool-use-tracker.sh +0 -280
  319. package/.claude/hooks/pre-tool-use-guardrail.sh +0 -36
  320. package/.claude/hooks/pre-tool-use-guardrail.ts +0 -342
  321. package/.claude/hooks/ralph-loop.ts +0 -931
  322. package/.claude/hooks/ralph-stop-hook.sh +0 -190
  323. package/.claude/hooks/skill-activation-prompt.sh +0 -36
  324. package/.claude/hooks/skill-activation-prompt.ts +0 -214
  325. package/.claude/hooks/state/skills-used-test-guard.json +0 -3
  326. package/.claude/hooks/task-completed-hook.ts +0 -593
  327. package/.claude/hooks/teammate-idle-hook.ts +0 -690
  328. package/.claude/hooks/types/team-types.d.ts +0 -238
  329. package/.claude/rules/devflow-conventions.md +0 -286
  330. package/.claude/rules/project-constitution.md +0 -1002
  331. package/.claude/rules/rationalization-library.md +0 -282
  332. package/.claude/schemas/constitution.schema.json +0 -43
  333. package/.claude/scripts/CLAUDE.md +0 -76
  334. package/.claude/scripts/analyze-upgrade-impact.sh +0 -200
  335. package/.claude/scripts/archive-requirement.sh +0 -394
  336. package/.claude/scripts/calculate-checklist-completion.sh +0 -243
  337. package/.claude/scripts/calculate-quarter.sh +0 -206
  338. package/.claude/scripts/check-dependencies.sh +0 -409
  339. package/.claude/scripts/check-prerequisites.sh +0 -232
  340. package/.claude/scripts/check-task-status.sh +0 -288
  341. package/.claude/scripts/checklist-errors.sh +0 -131
  342. package/.claude/scripts/common.sh +0 -1102
  343. package/.claude/scripts/consolidate-research.sh +0 -182
  344. package/.claude/scripts/create-requirement.sh +0 -451
  345. package/.claude/scripts/delta-parser.ts +0 -527
  346. package/.claude/scripts/detect-file-conflicts.sh +0 -151
  347. package/.claude/scripts/export-contracts.sh +0 -117
  348. package/.claude/scripts/extract-data-model.sh +0 -78
  349. package/.claude/scripts/flow-context-add.sh +0 -134
  350. package/.claude/scripts/flow-context-init.sh +0 -133
  351. package/.claude/scripts/flow-context-validate.sh +0 -144
  352. package/.claude/scripts/flow-delta-apply.sh +0 -297
  353. package/.claude/scripts/flow-delta-archive.sh +0 -71
  354. package/.claude/scripts/flow-delta-create.sh +0 -202
  355. package/.claude/scripts/flow-delta-list.sh +0 -142
  356. package/.claude/scripts/flow-delta-status.sh +0 -235
  357. package/.claude/scripts/flow-quality-full.sh +0 -215
  358. package/.claude/scripts/flow-quality-quick.sh +0 -119
  359. package/.claude/scripts/flow-workspace-init.sh +0 -117
  360. package/.claude/scripts/flow-workspace-record.sh +0 -164
  361. package/.claude/scripts/generate-clarification-questions.sh +0 -377
  362. package/.claude/scripts/generate-clarification-report.sh +0 -463
  363. package/.claude/scripts/generate-quickstart.sh +0 -146
  364. package/.claude/scripts/generate-research-tasks.sh +0 -157
  365. package/.claude/scripts/generate-status-report.sh +0 -523
  366. package/.claude/scripts/generate-tech-analysis.sh +0 -46
  367. package/.claude/scripts/get-workflow-status.sh +0 -415
  368. package/.claude/scripts/locate-requirement-in-roadmap.sh +0 -233
  369. package/.claude/scripts/manage-constitution.sh +0 -602
  370. package/.claude/scripts/mark-task-complete.sh +0 -198
  371. package/.claude/scripts/parse-task-dependencies.js +0 -334
  372. package/.claude/scripts/populate-research-tasks.sh +0 -284
  373. package/.claude/scripts/record-quality-error.sh +0 -165
  374. package/.claude/scripts/recover-workflow.sh +0 -463
  375. package/.claude/scripts/run-clarify-scan.sh +0 -601
  376. package/.claude/scripts/run-high-review.sh +0 -62
  377. package/.claude/scripts/run-problem-analysis.sh +0 -68
  378. package/.claude/scripts/run-quality-gates.sh +0 -242
  379. package/.claude/scripts/setup-epic.sh +0 -173
  380. package/.claude/scripts/setup-ralph-loop.sh +0 -155
  381. package/.claude/scripts/sync-roadmap-progress.sh +0 -300
  382. package/.claude/scripts/sync-task-marks.sh +0 -199
  383. package/.claude/scripts/team-dev-init.sh +0 -319
  384. package/.claude/scripts/team-state-recovery.sh +0 -229
  385. package/.claude/scripts/test-clarify-scan.sh +0 -515
  386. package/.claude/scripts/update-agent-context.sh +0 -806
  387. package/.claude/scripts/validate-constitution.sh +0 -567
  388. package/.claude/scripts/validate-hooks.sh +0 -487
  389. package/.claude/scripts/validate-research.sh +0 -332
  390. package/.claude/scripts/validate-scope-boundary.sh +0 -493
  391. package/.claude/scripts/verify-gate.sh +0 -269
  392. package/.claude/scripts/verify-setup.sh +0 -37
  393. package/.claude/scripts/workflow-status.ts +0 -433
  394. package/.claude/settings.json +0 -95
  395. package/.claude/skills/_reference-implementations/README.md +0 -96
  396. package/.claude/skills/_reference-implementations/backend-express-prisma/SKILL.md +0 -302
  397. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/architecture-overview.md +0 -451
  398. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/async-and-errors.md +0 -307
  399. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/complete-examples.md +0 -638
  400. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/configuration.md +0 -275
  401. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/database-patterns.md +0 -224
  402. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/middleware-guide.md +0 -213
  403. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/routing-and-controllers.md +0 -756
  404. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/sentry-and-monitoring.md +0 -336
  405. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/services-and-repositories.md +0 -789
  406. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/testing-guide.md +0 -235
  407. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/validation-patterns.md +0 -754
  408. package/.claude/skills/_reference-implementations/frontend-react-mui/SKILL.md +0 -399
  409. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/common-patterns.md +0 -331
  410. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/complete-examples.md +0 -872
  411. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/component-patterns.md +0 -502
  412. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/data-fetching.md +0 -767
  413. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/file-organization.md +0 -502
  414. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/loading-and-error-states.md +0 -501
  415. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/performance.md +0 -406
  416. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/routing-guide.md +0 -364
  417. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/styling-guide.md +0 -428
  418. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/typescript-standards.md +0 -418
  419. package/.claude/skills/cc-devflow-orchestrator/SKILL.md +0 -169
  420. package/.claude/skills/domain/attention-refresh/SKILL.md +0 -170
  421. package/.claude/skills/domain/brainstorming/SKILL.md +0 -161
  422. package/.claude/skills/domain/debugging/SKILL.md +0 -221
  423. package/.claude/skills/domain/finishing-branch/SKILL.md +0 -189
  424. package/.claude/skills/domain/receiving-review/SKILL.md +0 -153
  425. package/.claude/skills/domain/tdd/SKILL.md +0 -218
  426. package/.claude/skills/domain/verification/SKILL.md +0 -158
  427. package/.claude/skills/guardrail/constitution-guardian/SKILL.md +0 -306
  428. package/.claude/skills/guardrail/tdd-enforcer/SKILL.md +0 -192
  429. package/.claude/skills/skill-rules.json +0 -359
  430. package/.claude/skills/utility/constitution-quick-ref/SKILL.md +0 -374
  431. package/.claude/skills/utility/file-standards/SKILL.md +0 -353
  432. package/.claude/skills/utility/fractal-docs/SKILL.md +0 -45
  433. package/.claude/skills/utility/journey-checker/SKILL.md +0 -199
  434. package/.claude/skills/utility/journey-checker/pressure-scenarios.md +0 -164
  435. package/.claude/skills/utility/npm-release/SKILL.md +0 -314
  436. package/.claude/skills/utility/skill-creator/LICENSE.txt +0 -202
  437. package/.claude/skills/utility/skill-creator/SKILL.md +0 -356
  438. package/.claude/skills/utility/skill-creator/references/output-patterns.md +0 -82
  439. package/.claude/skills/utility/skill-creator/references/workflows.md +0 -28
  440. package/.claude/skills/utility/skill-creator/scripts/init_skill.py +0 -303
  441. package/.claude/skills/utility/skill-creator/scripts/package_skill.py +0 -110
  442. package/.claude/skills/utility/skill-creator/scripts/quick_validate.py +0 -95
  443. package/.claude/skills/workflow/CLAUDE.md +0 -24
  444. package/.claude/skills/workflow/flow-dev/CLAUDE.md +0 -16
  445. package/.claude/skills/workflow/flow-dev/SKILL.md +0 -94
  446. package/.claude/skills/workflow/flow-dev/assets/IMPLEMENTATION_PLAN_TEMPLATE.md +0 -71
  447. package/.claude/skills/workflow/flow-dev/context.jsonl +0 -4
  448. package/.claude/skills/workflow/flow-dev/dev-implementer.jsonl +0 -8
  449. package/.claude/skills/workflow/flow-dev/scripts/entry-gate.sh +0 -116
  450. package/.claude/skills/workflow/flow-dev/scripts/exit-gate.sh +0 -101
  451. package/.claude/skills/workflow/flow-dev/scripts/task-orchestrator.sh +0 -106
  452. package/.claude/skills/workflow/flow-fix/SKILL.md +0 -105
  453. package/.claude/skills/workflow/flow-fix/context.jsonl +0 -6
  454. package/.claude/skills/workflow/flow-fix/references/bug-analyzer.md +0 -381
  455. package/.claude/skills/workflow/flow-init/SKILL.md +0 -84
  456. package/.claude/skills/workflow/flow-init/assets/BRAINSTORM_TEMPLATE.md +0 -148
  457. package/.claude/skills/workflow/flow-init/assets/INIT_FLOW_TEMPLATE.md +0 -198
  458. package/.claude/skills/workflow/flow-init/assets/RESEARCH_TEMPLATE.md +0 -276
  459. package/.claude/skills/workflow/flow-init/context.jsonl +0 -5
  460. package/.claude/skills/workflow/flow-init/references/flow-researcher.md +0 -132
  461. package/.claude/skills/workflow/flow-init/scripts/check-prerequisites.sh +0 -240
  462. package/.claude/skills/workflow/flow-init/scripts/consolidate-research.sh +0 -182
  463. package/.claude/skills/workflow/flow-init/scripts/create-requirement.sh +0 -404
  464. package/.claude/skills/workflow/flow-init/scripts/generate-research-tasks.sh +0 -157
  465. package/.claude/skills/workflow/flow-init/scripts/populate-research-tasks.sh +0 -284
  466. package/.claude/skills/workflow/flow-init/scripts/validate-research.sh +0 -340
  467. package/.claude/skills/workflow/flow-quality/SKILL.md +0 -98
  468. package/.claude/skills/workflow/flow-quality/context.jsonl +0 -6
  469. package/.claude/skills/workflow/flow-quality/references/code-quality-reviewer.md +0 -205
  470. package/.claude/skills/workflow/flow-quality/references/qa-tester.md +0 -313
  471. package/.claude/skills/workflow/flow-quality/references/security-reviewer.md +0 -314
  472. package/.claude/skills/workflow/flow-quality/references/spec-reviewer.md +0 -221
  473. package/.claude/skills/workflow/flow-release/SKILL.md +0 -49
  474. package/.claude/skills/workflow/flow-release/context.jsonl +0 -5
  475. package/.claude/skills/workflow/flow-release/references/release-manager.md +0 -295
  476. package/.claude/skills/workflow/flow-spec/CLAUDE.md +0 -17
  477. package/.claude/skills/workflow/flow-spec/SKILL.md +0 -74
  478. package/.claude/skills/workflow/flow-spec/context.jsonl +0 -5
  479. package/.claude/skills/workflow/flow-spec/scripts/entry-gate.sh +0 -194
  480. package/.claude/skills/workflow/flow-spec/scripts/exit-gate.sh +0 -244
  481. package/.claude/skills/workflow/flow-spec/scripts/parallel-orchestrator.sh +0 -205
  482. package/.claude/skills/workflow/flow-spec/scripts/team-communication.sh +0 -353
  483. package/.claude/skills/workflow/flow-spec/scripts/team-init.sh +0 -195
  484. package/.claude/skills/workflow/flow-spec/scripts/test-team-mode.sh +0 -496
  485. package/.claude/skills/workflow/flow-spec/team-config.json +0 -165
  486. package/.claude/skills/workflow/flow-verify/CLAUDE.md +0 -10
  487. package/.claude/skills/workflow/flow-verify/SKILL.md +0 -53
  488. package/.claude/skills/workflow/flow-verify/context.jsonl +0 -5
  489. package/.claude/skills/workflow.yaml +0 -219
  490. package/.claude/tests/README.md +0 -300
  491. package/.claude/tests/TODO.md +0 -69
  492. package/.claude/tests/__pycache__/test_analyze_upgrade_impact.cpython-311-pytest-7.2.2.pyc +0 -0
  493. package/.claude/tests/__pycache__/test_consolidate_research.cpython-311-pytest-7.2.2.pyc +0 -0
  494. package/.claude/tests/__pycache__/test_export_contracts.cpython-311-pytest-7.2.2.pyc +0 -0
  495. package/.claude/tests/__pycache__/test_extract_data_model.cpython-311-pytest-7.2.2.pyc +0 -0
  496. package/.claude/tests/__pycache__/test_generate_quickstart.cpython-311-pytest-7.2.2.pyc +0 -0
  497. package/.claude/tests/__pycache__/test_generate_research_tasks.cpython-311-pytest-7.2.2.pyc +0 -0
  498. package/.claude/tests/constitution/run_all_constitution_tests.sh +0 -111
  499. package/.claude/tests/constitution/test_agent_assignment.sh +0 -207
  500. package/.claude/tests/constitution/test_article_coverage.sh +0 -201
  501. package/.claude/tests/constitution/test_template_completeness.sh +0 -150
  502. package/.claude/tests/constitution/test_version_consistency.sh +0 -120
  503. package/.claude/tests/fixtures/spec_delta_full.md +0 -16
  504. package/.claude/tests/fixtures/tasks_progress_sample.md +0 -5
  505. package/.claude/tests/run-all-tests.sh +0 -229
  506. package/.claude/tests/scripts/run.sh +0 -30
  507. package/.claude/tests/scripts/test-framework.sh +0 -128
  508. package/.claude/tests/scripts/test_check_prerequisites.sh +0 -511
  509. package/.claude/tests/scripts/test_check_prerequisites.sh.bak +0 -504
  510. package/.claude/tests/scripts/test_check_prerequisites.sh.bak2 +0 -505
  511. package/.claude/tests/scripts/test_check_prerequisites.sh.bak3 +0 -506
  512. package/.claude/tests/scripts/test_check_prerequisites.sh.bak4 +0 -507
  513. package/.claude/tests/scripts/test_check_prerequisites.sh.bak5 +0 -508
  514. package/.claude/tests/scripts/test_check_task_status.sh +0 -499
  515. package/.claude/tests/scripts/test_common.sh +0 -244
  516. package/.claude/tests/scripts/test_generate_status_report.sh +0 -71
  517. package/.claude/tests/scripts/test_mark_task_complete.sh +0 -441
  518. package/.claude/tests/scripts/test_mark_task_complete.sh.backup +0 -410
  519. package/.claude/tests/scripts/test_recover_workflow.sh +0 -304
  520. package/.claude/tests/scripts/test_setup_epic.sh +0 -437
  521. package/.claude/tests/scripts/test_sync_task_marks.sh +0 -196
  522. package/.claude/tests/scripts/test_validate_constitution.sh +0 -74
  523. package/.claude/tests/scripts/test_validate_research.sh +0 -462
  524. package/.claude/tests/slugify.bats +0 -82
  525. package/.claude/tests/test-framework.sh +0 -732
  526. package/.claude/tests/test_analyze_upgrade_impact.py +0 -34
  527. package/.claude/tests/test_consolidate_research.py +0 -48
  528. package/.claude/tests/test_export_contracts.py +0 -43
  529. package/.claude/tests/test_extract_data_model.py +0 -33
  530. package/.claude/tests/test_generate_quickstart.py +0 -50
  531. package/.claude/tests/test_generate_research_tasks.py +0 -52
  532. package/bin/harness.js +0 -22
  533. package/docs/commands/core-roadmap.md +0 -106
  534. package/docs/commands/core-roadmap.zh-CN.md +0 -102
  535. package/docs/commands/core-style.md +0 -53
  536. package/docs/commands/core-style.zh-CN.md +0 -53
  537. package/docs/commands/flow-init.md +0 -140
  538. package/docs/commands/flow-init.zh-CN.md +0 -169
  539. package/docs/commands/flow-new.md +0 -39
  540. package/docs/commands/flow-new.zh-CN.md +0 -39
  541. package/lib/compiler/__tests__/compile-regression.test.js +0 -103
  542. package/lib/compiler/__tests__/multi-module-emitters.test.js +0 -534
  543. package/lib/compiler/__tests__/resource-copier.test.js +0 -26
  544. package/lib/compiler/__tests__/skill-discovery.test.js +0 -72
  545. package/lib/compiler/context-expander.js +0 -179
  546. package/lib/compiler/rules-emitters/__tests__/codex-rules-emitter.test.js +0 -109
  547. package/lib/compiler/rules-emitters/codex-rules-emitter.js +0 -116
  548. package/lib/compiler/skill-discovery.js +0 -68
  549. package/lib/harness/CLAUDE.md +0 -21
  550. package/lib/harness/cli.js +0 -208
  551. package/lib/harness/index.js +0 -16
  552. package/lib/harness/operations/dispatch.js +0 -285
  553. package/lib/harness/operations/init.js +0 -48
  554. package/lib/harness/operations/pack.js +0 -100
  555. package/lib/harness/operations/plan.js +0 -29
  556. package/lib/harness/operations/resume.js +0 -44
  557. package/lib/harness/operations/verify.js +0 -163
  558. package/lib/harness/planner.js +0 -141
  559. package/lib/harness/schemas.js +0 -108
@@ -1,523 +0,0 @@
1
- # Tasks: {{REQ_ID}} - {{TITLE}}
2
-
3
- **Input**: PRD.md, EPIC.md from `devflow/requirements/{{REQ_ID}}/`
4
- **Prerequisites**: PRD.md (required), EPIC.md (required), research/ (optional)
5
-
6
- ## Execution Flow (任务生成主流程)
7
- ```
8
- 1. Load PRD.md and EPIC.md from requirement directory
9
- → If PRD not found: ERROR "Run prd-writer first"
10
- → If EPIC not found: ERROR "Run planner first"
11
- → Extract: user stories with priorities (P1, P2, P3), technical components, data entities
12
-
13
- 2. Load optional design documents:
14
- → research/: Extract technology decisions → setup tasks
15
- → data-model section in EPIC: Extract entities → map to user stories
16
- → API contracts in EPIC: Each endpoint → map to user stories
17
- → UI_PROTOTYPE.html (if exists): Extract pages/components → map to user stories
18
- • Check for UI_PROTOTYPE.html existence
19
- • If exists: Extract page list, component inventory, design system
20
- • Map each page to corresponding user story
21
- • Generate frontend implementation tasks with UI prototype references
22
-
23
- 3. Generate tasks organized by USER STORY (NEW STRUCTURE):
24
- → Phase 1 Setup: shared infrastructure needed by ALL stories
25
- → Phase 2 Foundational: blocking prerequisites (必须完成后才能开始任何用户故事)
26
- → Phase 3+: One phase PER USER STORY (P1, P2, P3... order)
27
- - Each phase includes: story goal, independent test, tests, implementation
28
- - Clear [US#] labels for each task
29
- - [P] markers for parallelizable tasks within story
30
- - Checkpoint after each story phase
31
- - **新增**: 在每个阶段末尾插入 Code Review Checkpoint,指派 `/code-reviewer` 子代理生成审查报告
32
- - **审查聚焦**: 所有 Code Review 必须对照 PRD.md 与 EPIC.md,禁止扩展需求,发现偏离需退回整改
33
- → Final Phase: Polish & cross-cutting concerns
34
-
35
- 4. Apply task rules:
36
- → Different files = mark [P] for parallel execution
37
- → Same file = sequential (no [P])
38
- → Tests (if requested) ALWAYS before implementation (TDD principle)
39
- → Mark test verification checkpoint before implementation
40
- → 确保每个阶段都包含唯一的 Code Review 任务,输出路径使用 `reviews/phase-*-*_code_review.md`
41
-
42
- 5. Number tasks sequentially (T001, T002, T003...)
43
-
44
- 6. Generate dependency graph showing user story completion order
45
-
46
- 7. Create parallel execution examples per story
47
-
48
- 8. Validate task completeness:
49
- → Each user story has all needed tasks?
50
- → Each story independently testable?
51
- → All tests come before implementation?
52
- → If validation fails: ERROR "Fix task breakdown"
53
-
54
- 9. Update Constitution Check section
55
-
56
- 10. Return: SUCCESS (tasks.md ready for execution)
57
- ```
58
-
59
- **重要**: 这是一个自执行模板。Planner agent 应该按照 Execution Flow 生成完整的 tasks.md 文件。
60
-
61
- ## Format: `[ID] [P?] [Story] Description`
62
- - **[P]**: Can run in parallel (different files, no dependencies)
63
- - **[Story]**: Which user story this task belongs to (US1, US2, US3...)
64
- - **ID**: T001, T002, T003... (sequential numbering)
65
- - Include exact file paths in task descriptions
66
-
67
- ## Path Conventions
68
- 根据项目类型调整路径:
69
- - **单体项目**: `src/`, `tests/` 在仓库根目录
70
- - **Web 应用**: `backend/src/`, `frontend/src/`
71
- - **移动应用**: `api/src/`, `ios/src/` 或 `android/src/`
72
-
73
- ---
74
-
75
- ## Phase 1: Setup (共享基础设施)
76
-
77
- **Purpose**: 项目初始化和所有用户故事共用的基础结构
78
-
79
- ### 任务清单
80
- - [ ] **T001** 创建项目结构按照 EPIC 中定义的架构
81
- - [ ] **T002** 初始化 {{LANGUAGE}} 项目并安装 {{FRAMEWORK}} 依赖
82
- - [ ] **T003** [P] 配置代码检查工具(linting, formatting)
83
-
84
- ### Constitution Check (Phase 1)
85
- - [ ] **Article VII - Simplicity Gate**: 只安装必需的依赖,≤3个主要项目/模块
86
- - [ ] **Article VIII - Anti-Abstraction**: 避免不必要的抽象和封装
87
- - [ ] **Article II - Architectural Consistency**: 遵循项目现有的结构模式和命名约定
88
-
89
- ### Code Review Checkpoint (Phase 1)
90
- - [ ] **T004** 触发 `/code-reviewer` 子代理生成 `reviews/phase-1-setup_code_review.md`(报告需返回 `Phase Gate Result: Pass` 且 `decision` ∈ {approve, comment} 方可进入下一阶段)
91
-
92
- ---
93
-
94
- ## Phase 2: Foundational (阻塞性前置条件)
95
-
96
- **Purpose**: 所有用户故事的必需前置条件,必须完成后才能开始任何用户故事
97
-
98
- **⚠️ CRITICAL**: No user story work can begin until this phase is complete
99
-
100
- **Foundational 任务示例**(根据项目实际情况调整):
101
- - [ ] **T005** Setup database schema and migrations framework
102
- - [ ] **T006** [P] Implement authentication/authorization framework
103
- - [ ] **T007** [P] Setup API routing and middleware structure
104
- - [ ] **T008** Create base models/entities that all stories depend on
105
- - [ ] **T009** Configure error handling and logging infrastructure
106
- - [ ] **T010** Setup environment configuration management
107
-
108
- **Checkpoint**: Foundation ready - user story implementation can now begin in parallel
109
-
110
- ### Code Review Checkpoint (Phase 2)
111
- - [ ] **T011** 触发 `/code-reviewer` 子代理生成 `reviews/phase-2-foundational_code_review.md`(若 `Phase Gate Result: Fail` → 必须整改并重跑审查)
112
-
113
- ---
114
-
115
- ## Phase 3: User Story 1 - {{STORY_1_TITLE}} (Priority: P1) 🎯 MVP
116
-
117
- **Goal**: {{STORY_1_GOAL}}
118
- <!-- 示例: Enable users to register and log in -->
119
-
120
- **Independent Test**: {{STORY_1_INDEPENDENT_TEST}}
121
- <!-- 示例: User can register with email/password and log in successfully -->
122
-
123
- ### Tests for User Story 1 (OPTIONAL - only if tests requested) ⚠️
124
-
125
- **NOTE: Write these tests FIRST, ensure they FAIL before implementation**
126
-
127
- - [ ] **T012** [P] [US1] Contract test for {{ENDPOINT_1}} in `tests/contract/test_{{NAME}}.{{EXT}}`
128
- - [ ] **T013** [P] [US1] Contract test for {{ENDPOINT_2}} in `tests/contract/test_{{NAME}}.{{EXT}}`
129
- - [ ] **T014** [P] [US1] Integration test for {{USER_JOURNEY}} in `tests/integration/test_{{NAME}}.{{EXT}}`
130
-
131
- ### Implementation for User Story 1
132
-
133
- - [ ] **T015** [P] [US1] Create {{Entity1}} model in `src/models/{{entity1}}.{{EXT}}`
134
- - [ ] **T016** [P] [US1] Create {{Entity2}} model in `src/models/{{entity2}}.{{EXT}}`
135
- - [ ] **T017** [US1] Implement {{Service}} in `src/services/{{service}}.{{EXT}}` (depends on T015, T016)
136
- - [ ] **T018** [US1] Implement {{endpoint/feature}} in `src/{{location}}/{{file}}.{{EXT}}`
137
- - [ ] **T019** [US1] Add validation and error handling
138
- - [ ] **T020** [US1] Add logging for user story 1 operations
139
-
140
- **Checkpoint**: At this point, User Story 1 should be fully functional and testable independently
141
-
142
- ### Code Review Checkpoint (Phase 3)
143
- - [ ] **T021** 触发 `/code-reviewer` 子代理生成 `reviews/phase-3-user-story-1_code_review.md`(任何整改项未关闭不得启动下一用户故事)
144
-
145
- ---
146
-
147
- ## Phase 4: User Story 2 - {{STORY_2_TITLE}} (Priority: P2)
148
-
149
- **Goal**: {{STORY_2_GOAL}}
150
-
151
- **Independent Test**: {{STORY_2_INDEPENDENT_TEST}}
152
-
153
- ### Tests for User Story 2 (OPTIONAL - only if tests requested) ⚠️
154
-
155
- - [ ] **T022** [P] [US2] Contract test for {{ENDPOINT}} in `tests/contract/test_{{NAME}}.{{EXT}}`
156
- - [ ] **T023** [P] [US2] Integration test for {{USER_JOURNEY}} in `tests/integration/test_{{NAME}}.{{EXT}}`
157
-
158
- ### Implementation for User Story 2
159
-
160
- - [ ] **T024** [P] [US2] Create {{Entity}} model in `src/models/{{entity}}.{{EXT}}`
161
- - [ ] **T025** [US2] Implement {{Service}} in `src/services/{{service}}.{{EXT}}`
162
- - [ ] **T026** [US2] Implement {{endpoint/feature}} in `src/{{location}}/{{file}}.{{EXT}}`
163
- - [ ] **T027** [US2] Integrate with User Story 1 components (if needed)
164
-
165
- **Checkpoint**: At this point, User Stories 1 AND 2 should both work independently
166
-
167
- ### Code Review Checkpoint (Phase 4)
168
- - [ ] **T028** 触发 `/code-reviewer` 子代理生成 `reviews/phase-4-user-story-2_code_review.md`(确保审查结果在 PRD/EPIC 范围内全部通过)
169
-
170
- ---
171
-
172
- ## Phase 5: User Story X - {{STORY_UI_TITLE}} (Priority: PX) - Frontend UI Implementation ⚡️
173
-
174
- **Note**: 此阶段仅在存在 UI_PROTOTYPE.html 时生成
175
-
176
- **Goal**: {{STORY_UI_GOAL}}
177
- <!-- 示例: Display order list and details with responsive design -->
178
-
179
- **Independent Test**: {{STORY_UI_INDEPENDENT_TEST}}
180
- <!-- 示例: User can view orders on mobile/tablet/desktop with consistent styling -->
181
-
182
- **UI Prototype Reference**: `devflow/requirements/{{REQ_ID}}/UI_PROTOTYPE.html`
183
-
184
- ### Implementation for User Story X (Frontend UI)
185
-
186
- **Phase 3 任务前置条件**:
187
- - [ ] 确认 UI_PROTOTYPE.html 存在
188
- - [ ] 读取 UI_PROTOTYPE.html 提取设计系统和页面结构
189
-
190
- #### Frontend Setup (如需要)
191
- - [ ] **TXXX** [P] [USX] Setup frontend framework ({{React|Vue|Vanilla}}) in `frontend/`
192
- - [ ] **TXXX** [P] [USX] Configure CSS solution ({{CSS Modules|Styled Components|Tailwind}})
193
- - [ ] **TXXX** [USX] Extract design system variables from UI_PROTOTYPE.html to `src/styles/design-system.css`
194
-
195
- #### Page Components (Based on UI_PROTOTYPE.html)
196
- - [ ] **TXXX** [P] [USX] Implement {{Page1}} page component in `src/pages/{{Page1}}.{{jsx|vue}}`
197
- - **UI Prototype Ref**: See UI_PROTOTYPE.html `#page-{{page1}}`
198
- - **Design System**: Use CSS variables from `--primary-color`, `--spacing-md`, etc.
199
- - **Responsive**: Implement 320px (mobile), 768px (tablet), 1024px (desktop) breakpoints
200
- - **Interactive States**: Implement hover/active/disabled states
201
-
202
- - [ ] **TXXX** [P] [USX] Implement {{Page2}} page component in `src/pages/{{Page2}}.{{jsx|vue}}`
203
- - **UI Prototype Ref**: See UI_PROTOTYPE.html `#page-{{page2}}`
204
-
205
- #### Reusable Components (From UI_PROTOTYPE.html component inventory)
206
- - [ ] **TXXX** [P] [USX] Create {{Component1}} component in `src/components/{{Component1}}.{{jsx|vue}}`
207
- - **UI Prototype Ref**: See UI_PROTOTYPE.html `<!-- Component: {{Component1}} -->`
208
- - **Props**: Based on component usage in prototype
209
- - **Styling**: Use design system variables
210
-
211
- - [ ] **TXXX** [P] [USX] Create {{Component2}} component in `src/components/{{Component2}}.{{jsx|vue}}`
212
-
213
- #### API Integration
214
- - [ ] **TXXX** [USX] Connect {{Page1}} to backend API endpoint {{/api/endpoint}}
215
- - [ ] **TXXX** [USX] Connect {{Page2}} to backend API endpoint {{/api/endpoint}}
216
-
217
- #### Responsive & Accessibility
218
- - [ ] **TXXX** [P] [USX] Test responsive design on mobile (320px-767px)
219
- - [ ] **TXXX** [P] [USX] Test responsive design on tablet (768px-1023px)
220
- - [ ] **TXXX** [P] [USX] Test responsive design on desktop (1024px+)
221
- - [ ] **TXXX** [USX] Add ARIA labels and accessibility attributes
222
- - [ ] **TXXX** [USX] Test keyboard navigation
223
-
224
- **Checkpoint**: At this point, UI should match prototype with responsive design working
225
-
226
- **Constitution Check (Frontend UI)**:
227
- - [ ] **Article I.1 - NO PARTIAL IMPLEMENTATION**: All pages and components fully implemented
228
- - [ ] **Article II.1 - NO CODE DUPLICATION**: Reusable components extracted
229
- - [ ] **Article V.4 - File Size Limits**: Single component ≤500 lines
230
- - [ ] **UI Prototype Alignment**: Visual design matches UI_PROTOTYPE.html
231
- - [ ] **Responsive Design**: All breakpoints tested and working
232
- - [ ] **Interactive States**: All hover/active/disabled states implemented
233
-
234
- ### Code Review Checkpoint (Phase 5)
235
- - [ ] **TXXX** 触发 `/code-reviewer` 子代理生成 `reviews/phase-5-user-story-x_code_review.md`(继续前必须得到通过并确认无需求扩张)
236
-
237
- ---
238
-
239
- ## Phase 6: User Story 3 - {{STORY_3_TITLE}} (Priority: P3)
240
-
241
- **Goal**: {{STORY_3_GOAL}}
242
-
243
- **Independent Test**: {{STORY_3_INDEPENDENT_TEST}}
244
-
245
- ### Tests for User Story 3 (OPTIONAL - only if tests requested) ⚠️
246
-
247
- - [ ] **T029** [P] [US3] Contract test for {{ENDPOINT}} in `tests/contract/test_{{NAME}}.{{EXT}}`
248
- - [ ] **T030** [P] [US3] Integration test for {{USER_JOURNEY}} in `tests/integration/test_{{NAME}}.{{EXT}}`
249
-
250
- ### Implementation for User Story 3
251
-
252
- - [ ] **T031** [P] [US3] Create {{Entity}} model in `src/models/{{entity}}.{{EXT}}`
253
- - [ ] **T032** [US3] Implement {{Service}} in `src/services/{{service}}.{{EXT}}`
254
- - [ ] **T033** [US3] Implement {{endpoint/feature}} in `src/{{location}}/{{file}}.{{EXT}}`
255
-
256
- **Checkpoint**: All user stories should now be independently functional
257
-
258
- ### Code Review Checkpoint (Phase 6)
259
- - [ ] **T034** 触发 `/code-reviewer` 子代理生成 `reviews/phase-6-user-story-3_code_review.md`(报告如含阻塞项,需完成整改再提交复审)
260
-
261
- ---
262
-
263
- [Add more user story phases as needed, following the same pattern]
264
-
265
- ---
266
-
267
- ## Phase N: Polish & Cross-Cutting Concerns
268
-
269
- **Purpose**: 跨用户故事的改进
270
-
271
- - [ ] **TXXX** [P] Documentation updates in `docs/`
272
- - [ ] **TXXX** Code cleanup and refactoring
273
- - [ ] **TXXX** Performance optimization across all stories
274
- - [ ] **TXXX** [P] Additional unit tests (if requested) in `tests/unit/`
275
- - [ ] **TXXX** Security hardening
276
- - [ ] **TXXX** Run quickstart.md validation
277
-
278
- ### Code Review Checkpoint (Phase N)
279
- - [ ] **TXXX** 触发 `/code-reviewer` 子代理生成 `reviews/phase-n-polish_code_review.md`(必须 Pass 方可切换至 QA 流程)
280
-
281
- ---
282
-
283
- ## Dependencies & Execution Order (依赖关系与执行顺序)
284
-
285
- ### Phase Dependencies
286
-
287
- - **Setup (Phase 1)**: No dependencies - can start immediately
288
- - **Foundational (Phase 2)**: Depends on Setup completion - BLOCKS all user stories
289
- - **User Stories (Phase 3+)**: All depend on Foundational phase completion
290
- - User stories can then proceed in parallel (if staffed)
291
- - Or sequentially in priority order (P1 → P2 → P3)
292
- - **Polish (Final Phase)**: Depends on all desired user stories being complete
293
-
294
- ### User Story Dependencies
295
-
296
- - **User Story 1 (P1)**: Can start after Foundational (Phase 2) - No dependencies on other stories
297
- - **User Story 2 (P2)**: Can start after Foundational (Phase 2) - May integrate with US1 but should be independently testable
298
- - **User Story 3 (P3)**: Can start after Foundational (Phase 2) - May integrate with US1/US2 but should be independently testable
299
-
300
- ### Within Each User Story
301
-
302
- - Tests (if included) MUST be written and FAIL before implementation
303
- - Models before services
304
- - Services before endpoints
305
- - Core implementation before integration
306
- - Story complete before moving to next priority
307
-
308
- ### Parallel Opportunities
309
-
310
- - All Setup tasks marked [P] can run in parallel
311
- - All Foundational tasks marked [P] can run in parallel (within Phase 2)
312
- - Once Foundational phase completes, all user stories can start in parallel (if team capacity allows)
313
- - All tests for a user story marked [P] can run in parallel
314
- - Models within a story marked [P] can run in parallel
315
- - Different user stories can be worked on in parallel by different team members
316
-
317
- ---
318
-
319
- ## Parallel Example: User Story 1
320
-
321
- ```bash
322
- # Launch all tests for User Story 1 together (if tests requested):
323
- Task: "Contract test for [endpoint] in tests/contract/test_[name].py"
324
- Task: "Integration test for [user journey] in tests/integration/test_[name].py"
325
-
326
- # Launch all models for User Story 1 together:
327
- Task: "Create [Entity1] model in src/models/[entity1].py"
328
- Task: "Create [Entity2] model in src/models/[entity2].py"
329
- ```
330
-
331
- ---
332
-
333
- ## Implementation Strategy (实施策略)
334
-
335
- ### MVP First (User Story 1 Only)
336
-
337
- 1. Complete Phase 1: Setup
338
- 2. Complete Phase 2: Foundational (CRITICAL - blocks all stories)
339
- 3. Complete Phase 3: User Story 1
340
- 4. **STOP and VALIDATE**: Test User Story 1 independently
341
- 5. Deploy/demo if ready
342
-
343
- ### Incremental Delivery
344
-
345
- 1. Complete Setup + Foundational → Foundation ready
346
- 2. Add User Story 1 → Test independently → Deploy/Demo (MVP!)
347
- 3. Add User Story 2 → Test independently → Deploy/Demo
348
- 4. Add User Story 3 → Test independently → Deploy/Demo
349
- 5. Each story adds value without breaking previous stories
350
-
351
- ### Parallel Team Strategy
352
-
353
- With multiple developers:
354
-
355
- 1. Team completes Setup + Foundational together
356
- 2. Once Foundational is done:
357
- - Developer A: User Story 1
358
- - Developer B: User Story 2
359
- - Developer C: User Story 3
360
- 3. Stories complete and integrate independently
361
-
362
- ---
363
-
364
- ## Notes (注意事项)
365
-
366
- ### Critical Rules
367
- - **[P] = Parallel**: 只有不同文件、无依赖的任务才能标记 [P]
368
- - **[US#] = Story Label**: 所有任务必须标记所属用户故事
369
- - **Story Independence**: 每个用户故事应该独立可测试
370
- - **Foundational First**: Phase 2 必须完成才能开始用户故事
371
- - **Tests Optional**: 只有用户明确要求时才生成测试任务
372
- - **Commit Early**: 每完成一个任务就提交
373
-
374
- ### Common Pitfalls (常见陷阱)
375
- - ❌ 跨用户故事的依赖(破坏独立性)
376
- - ❌ 标记 [P] 但任务修改同一文件
377
- - ❌ 任务描述模糊,没有指定具体文件路径
378
- - ❌ 忘记标记 [US#] 用户故事标签
379
- - ❌ Foundational 包含特定用户故事的功能
380
-
381
- ### Best Practices (最佳实践)
382
- - ✅ 每个用户故事独立可测试
383
- - ✅ 一次只做一个用户故事
384
- - ✅ 频繁提交,小步前进
385
- - ✅ 运行测试套件验证
386
- - ✅ 每个故事完成后 demo
387
-
388
- ---
389
-
390
- ## Task Generation Rules (任务生成规则)
391
- *这些规则由 planner agent 在执行 Execution Flow 时应用*
392
-
393
- ### 1. From User Stories (PRIMARY ORGANIZATION)
394
- - 每个用户故事 (P1, P2, P3...) 得到自己的 Phase
395
- - 映射所有相关组件到其故事:
396
- - 该故事需要的 Models
397
- - 该故事需要的 Services
398
- - 该故事需要的 Endpoints/UI
399
- - 如果请求了测试: 该故事特定的测试
400
- - 标记故事依赖(大多数故事应该独立)
401
-
402
- ### 2. From API Contracts
403
- - 映射每个 contract/endpoint → 到它服务的用户故事
404
- - 如果请求了测试: 每个 contract → contract test 任务 [P] 在该故事的阶段之前
405
-
406
- ### 3. From Data Model
407
- - 映射每个 entity → 到需要它的用户故事
408
- - 如果 entity 服务多个故事: 放入最早的故事或 Setup phase
409
- - Relationships → service layer 任务在适当的故事阶段
410
-
411
- ### 4. From Setup/Infrastructure
412
- - 共享基础设施 → Setup phase (Phase 1)
413
- - Foundational/blocking 任务 → Foundational phase (Phase 2)
414
- - 示例: Database schema setup, authentication framework, core libraries, base configurations
415
- - 这些必须在任何用户故事可以实现之前完成
416
- - 故事特定的 setup → 在该故事的阶段内
417
-
418
- ### 5. Ordering
419
- - Phase 1: Setup (project initialization)
420
- - Phase 2: Foundational (blocking prerequisites - must complete before user stories)
421
- - Phase 3+: User Stories in priority order (P1, P2, P3...)
422
- - Within each story: Tests (if requested) → Models → Services → Endpoints → Integration
423
- - Final Phase: Polish & Cross-Cutting Concerns
424
- - Each user story phase should be a complete, independently testable increment
425
-
426
- ---
427
-
428
- ## Validation Checklist (验证清单)
429
- *GATE: 由 planner 在生成 tasks.md 后检查*
430
-
431
- ### User Story Organization ⚠️ CRITICAL
432
- - [ ] 每个用户故事有自己的 Phase (Phase 3, 4, 5...)
433
- - [ ] 所有任务都有 [US#] 标签标记所属故事
434
- - [ ] 每个故事有 Independent Test 标准
435
- - [ ] 每个故事有 Checkpoint 验证点
436
- - [ ] Foundational phase 只包含所有故事共需的前置条件
437
-
438
- ### Completeness (完整性)
439
- - [ ] 所有 API contracts 都映射到用户故事
440
- - [ ] 所有 data entities 都映射到用户故事
441
- - [ ] 所有用户故事都有对应的任务集合
442
- - [ ] Setup 和 Foundational phase 明确定义
443
-
444
- ### Story Independence (故事独立性)
445
- - [ ] US1 可以独立实现和测试
446
- - [ ] US2 可以独立实现和测试
447
- - [ ] US3 可以独立实现和测试
448
- - [ ] 故事间依赖已明确标注(应该最小化)
449
-
450
- ### Parallel Safety (并行安全性)
451
- - [ ] 所有 [P] 标记的任务都操作不同文件
452
- - [ ] 同一文件的任务没有 [P] 标记
453
- - [ ] 有依赖关系的任务没有 [P] 标记
454
-
455
- ### Path Specificity (路径明确性)
456
- - [ ] 每个任务都指定了具体的文件路径
457
- - [ ] 路径使用了正确的项目结构约定
458
- - [ ] 测试文件路径遵循 tests/ 目录结构
459
-
460
- ### Constitution Alignment (宪法符合性)
461
-
462
- **Reference**: `.claude/rules/project-constitution.md` (v2.0.0)
463
-
464
- - [ ] **Article I - Quality First**: 没有违反 NO PARTIAL IMPLEMENTATION,所有任务完整定义
465
- - [ ] **Article II - Architectural Consistency**: 没有违反 NO CODE DUPLICATION,复用现有组件
466
- - [ ] **Article II - Anti-Over-Engineering**: 没有违反 NO OVER-ENGINEERING,架构适度
467
- - [ ] **Article III - Security First**: 所有安全原则都有对应的任务(密钥管理、输入验证等)
468
- - [ ] **Article VI - Test-First Development**: TDD顺序正确(Phase 2测试 → Phase 3实现)
469
- - [ ] **Article X - Requirement Boundary**: 任务仅实现PRD明确的需求,无推测性功能
470
-
471
- ---
472
-
473
- ## Progress Tracking (进度跟踪)
474
- *在执行过程中更新*
475
-
476
- ### Overall Progress
477
- - [ ] Phase 1: Setup ({{SETUP_TASKS_COUNT}} tasks)
478
- - [ ] Phase 2: Foundational ({{FOUNDATIONAL_TASKS_COUNT}} tasks)
479
- - [ ] **CHECKPOINT**: Foundation ready ✓
480
- - [ ] Phase 3: User Story 1 ({{US1_TASKS_COUNT}} tasks) 🎯 MVP
481
- - [ ] Phase 4: User Story 2 ({{US2_TASKS_COUNT}} tasks)
482
- - [ ] Phase 5: User Story 3 ({{US3_TASKS_COUNT}} tasks)
483
- - [ ] Phase N: Polish ({{POLISH_TASKS_COUNT}} tasks)
484
-
485
- ### Test Coverage Status (if tests requested)
486
- - Contract Tests: {{CONTRACT_TESTS_PASSED}} / {{CONTRACT_TESTS_TOTAL}}
487
- - Integration Tests: {{INTEGRATION_TESTS_PASSED}} / {{INTEGRATION_TESTS_TOTAL}}
488
- - Unit Tests: {{UNIT_TESTS_PASSED}} / {{UNIT_TESTS_TOTAL}}
489
- - Coverage: {{COVERAGE_PERCENTAGE}}%
490
-
491
- ### User Story Completion
492
- - [ ] US1 (P1): {{COMPLETED}} / {{TOTAL}} tasks - Independent Test: {{PASS|FAIL}}
493
- - [ ] US2 (P2): {{COMPLETED}} / {{TOTAL}} tasks - Independent Test: {{PASS|FAIL}}
494
- - [ ] US3 (P3): {{COMPLETED}} / {{TOTAL}} tasks - Independent Test: {{PASS|FAIL}}
495
-
496
- ### Constitution Compliance
497
-
498
- **Reference**: `.claude/rules/project-constitution.md` (v2.0.0)
499
-
500
- - [ ] **Initial Check**: All 10 Articles validated at planning stage
501
- - [ ] **Article I-V**: Core principles checked (Quality, Architecture, Security, Performance, Maintainability)
502
- - [ ] **Article VI**: TDD sequence enforced (Tests First → Implementation)
503
- - [ ] **Article VII-IX**: Phase -1 Gates passed (Simplicity, Anti-Abstraction, Integration-First)
504
- - [ ] **Article X**: Requirement boundary validated (No speculative features)
505
- - [ ] **Post-Implementation**: Constitution Check re-run after all tasks complete
506
- - [ ] **Security Scan**: No high-severity issues
507
- - [ ] **Code Review**: Architectural consistency verified
508
-
509
- ---
510
-
511
- **Generated by**: planner agent
512
- **Based on**: PRD.md, EPIC.md
513
- **Constitution**: `.claude/rules/project-constitution.md` v2.0.0
514
- **Template Version**: 3.0.0 (Spec-Kit inspired - User Story Centric + Article-based Constitution)
515
-
516
- ---
517
-
518
- ## 相关文档
519
-
520
- - **PRD**: `devflow/requirements/{{REQ_ID}}/PRD.md`
521
- - **EPIC**: `devflow/requirements/{{REQ_ID}}/EPIC.md`
522
- - **Constitution**: `.claude/rules/project-constitution.md`
523
- - **Execution Log**: `devflow/requirements/{{REQ_ID}}/EXECUTION_LOG.md`