cc-devflow 4.3.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 (575) 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 +61 -4
  86. package/README.md +120 -756
  87. package/README.zh-CN.md +119 -756
  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 +60 -225
  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/skill-runtime/operations/release.js +96 -0
  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 -24
  235. package/.claude/commands/flow/archive.md +0 -280
  236. package/.claude/commands/flow/constitution.md +0 -82
  237. package/.claude/commands/flow/context.md +0 -150
  238. package/.claude/commands/flow/delta.md +0 -245
  239. package/.claude/commands/flow/dev.md +0 -40
  240. package/.claude/commands/flow/fix.md +0 -217
  241. package/.claude/commands/flow/ideate.md +0 -214
  242. package/.claude/commands/flow/init.md +0 -38
  243. package/.claude/commands/flow/release.md +0 -36
  244. package/.claude/commands/flow/restart.md +0 -97
  245. package/.claude/commands/flow/spec.md +0 -36
  246. package/.claude/commands/flow/status.md +0 -64
  247. package/.claude/commands/flow/update.md +0 -111
  248. package/.claude/commands/flow/upgrade.md +0 -115
  249. package/.claude/commands/flow/verify.md +0 -37
  250. package/.claude/commands/flow/workspace.md +0 -155
  251. package/.claude/commands/util/cancel-ralph.md +0 -60
  252. package/.claude/commands/util/code-review.md +0 -58
  253. package/.claude/commands/util/git-commit.md +0 -422
  254. package/.claude/commands/util/problem-analyzer.md +0 -60
  255. package/.claude/config/quality-gates.yml +0 -305
  256. package/.claude/config/quality-rules.yml +0 -161
  257. package/.claude/docs/SPEC_KIT_CONSTITUTION_ANALYSIS.md +0 -426
  258. package/.claude/docs/design/consistency-conflict-detection-algorithms.md +0 -658
  259. package/.claude/docs/design/intent-driven-input-design.md +0 -380
  260. package/.claude/docs/design/prd-version-management-design.md +0 -437
  261. package/.claude/docs/examples/design-inspiration-pool.md +0 -59
  262. package/.claude/docs/examples/ui-prototype-constitution-checklist.md +0 -75
  263. package/.claude/docs/guides/INIT_TROUBLESHOOTING.md +0 -117
  264. package/.claude/docs/guides/NEW_TROUBLESHOOTING.md +0 -99
  265. package/.claude/docs/guides/ROADMAP_TROUBLESHOOTING.md +0 -188
  266. package/.claude/docs/guides/TASK_COMPLETION_MARKING.md +0 -338
  267. package/.claude/docs/guides/TEAM_MODE_GUIDE.md +0 -312
  268. package/.claude/docs/implementation-summary-v7.md +0 -449
  269. package/.claude/docs/spec-format-guide.md +0 -349
  270. package/.claude/docs/state-consolidation-design.md +0 -323
  271. package/.claude/docs/templates/ARCHITECTURE_TEMPLATE.md +0 -332
  272. package/.claude/docs/templates/ATTEMPT_TEMPLATE.md +0 -156
  273. package/.claude/docs/templates/BACKLOG_TEMPLATE.md +0 -261
  274. package/.claude/docs/templates/BRAINSTORM_TEMPLATE.md +0 -148
  275. package/.claude/docs/templates/CHECKLIST_TEMPLATE.md +0 -52
  276. package/.claude/docs/templates/CLARIFICATION_REPORT_TEMPLATE.md +0 -206
  277. package/.claude/docs/templates/CODE_REVIEW_TEMPLATE.md +0 -71
  278. package/.claude/docs/templates/DELTA_SPEC_TEMPLATE.md +0 -91
  279. package/.claude/docs/templates/DESIGN_DECISIONS_TEMPLATE.md +0 -151
  280. package/.claude/docs/templates/DESIGN_TEMPLATE.md +0 -157
  281. package/.claude/docs/templates/ERROR_LOG_TEMPLATE.md +0 -80
  282. package/.claude/docs/templates/INIT_FLOW_TEMPLATE.md +0 -198
  283. package/.claude/docs/templates/INTENT_CLARIFICATION_TEMPLATE.md +0 -57
  284. package/.claude/docs/templates/JOURNAL_TEMPLATE.md +0 -75
  285. package/.claude/docs/templates/NEW_ORCHESTRATION_TEMPLATE.md +0 -76
  286. package/.claude/docs/templates/PROPOSAL_TEMPLATE.md +0 -91
  287. package/.claude/docs/templates/RESEARCH_TEMPLATE.md +0 -276
  288. package/.claude/docs/templates/REVIEW-HIGH.md +0 -57
  289. package/.claude/docs/templates/ROADMAP_DIALOGUE_TEMPLATE.md +0 -198
  290. package/.claude/docs/templates/ROADMAP_TEMPLATE.md +0 -310
  291. package/.claude/docs/templates/SPEC_TEMPLATE_DELTA.md +0 -139
  292. package/.claude/docs/templates/SPEC_TEMPLATE_PROJECT.md +0 -93
  293. package/.claude/docs/templates/STYLE_TEMPLATE.md +0 -479
  294. package/.claude/docs/templates/UI_PROTOTYPE_TEMPLATE.md +0 -373
  295. package/.claude/docs/templates/_shared/CLAUDE.md +0 -36
  296. package/.claude/docs/templates/_shared/CONSTITUTION_CHECK.md +0 -125
  297. package/.claude/docs/templates/_shared/VALIDATION_CHECKLIST.md +0 -187
  298. package/.claude/docs/templates/_shared/YAML_FRONTMATTER.md +0 -164
  299. package/.claude/docs/templates/context/dev.jsonl.template +0 -6
  300. package/.claude/docs/templates/context/epic.jsonl.template +0 -5
  301. package/.claude/docs/templates/context/prd.jsonl.template +0 -4
  302. package/.claude/docs/templates/context/research.jsonl.template +0 -4
  303. package/.claude/docs/templates/context/review.jsonl.template +0 -5
  304. package/.claude/docs/templates/context/tech.jsonl.template +0 -5
  305. package/.claude/guides/agent-guides/agent-coordination-guide.md +0 -459
  306. package/.claude/guides/project-guidelines-system.md +0 -463
  307. package/.claude/guides/technical-guides/datetime-handling-guide.md +0 -563
  308. package/.claude/guides/technical-guides/git-github-guide.md +0 -642
  309. package/.claude/guides/technical-guides/test-execution-guide.md +0 -618
  310. package/.claude/guides/workflow-guides/bug-fix-orchestrator.md +0 -217
  311. package/.claude/guides/workflow-guides/flow-orchestrator.md +0 -48
  312. package/.claude/hooks/CLAUDE.md +0 -342
  313. package/.claude/hooks/checklist-gate.js +0 -397
  314. package/.claude/hooks/error-handling-reminder.sh +0 -12
  315. package/.claude/hooks/error-handling-reminder.ts +0 -459
  316. package/.claude/hooks/hooks.json +0 -15
  317. package/.claude/hooks/inject-agent-context.ts +0 -480
  318. package/.claude/hooks/inject-skill-context.ts +0 -359
  319. package/.claude/hooks/post-tool-use-tracker.sh +0 -280
  320. package/.claude/hooks/pre-tool-use-guardrail.sh +0 -36
  321. package/.claude/hooks/pre-tool-use-guardrail.ts +0 -342
  322. package/.claude/hooks/ralph-loop.ts +0 -931
  323. package/.claude/hooks/ralph-stop-hook.sh +0 -190
  324. package/.claude/hooks/skill-activation-prompt.sh +0 -36
  325. package/.claude/hooks/skill-activation-prompt.ts +0 -214
  326. package/.claude/hooks/state/skills-used-test-guard.json +0 -3
  327. package/.claude/hooks/task-completed-hook.ts +0 -593
  328. package/.claude/hooks/teammate-idle-hook.ts +0 -690
  329. package/.claude/hooks/types/team-types.d.ts +0 -238
  330. package/.claude/rules/devflow-conventions.md +0 -286
  331. package/.claude/rules/project-constitution.md +0 -1002
  332. package/.claude/rules/rationalization-library.md +0 -282
  333. package/.claude/schemas/constitution.schema.json +0 -43
  334. package/.claude/scripts/.claude/commands/flow/export-openspec.md +0 -221
  335. package/.claude/scripts/.claude/commands/flow/import-openspec.md +0 -171
  336. package/.claude/scripts/CLAUDE.md +0 -76
  337. package/.claude/scripts/__tests__/openspec.test.js +0 -212
  338. package/.claude/scripts/analyze-upgrade-impact.sh +0 -200
  339. package/.claude/scripts/archive-requirement.sh +0 -394
  340. package/.claude/scripts/calculate-checklist-completion.sh +0 -243
  341. package/.claude/scripts/calculate-quarter.sh +0 -206
  342. package/.claude/scripts/check-dependencies.sh +0 -409
  343. package/.claude/scripts/check-prerequisites.sh +0 -232
  344. package/.claude/scripts/check-task-status.sh +0 -288
  345. package/.claude/scripts/checklist-errors.sh +0 -131
  346. package/.claude/scripts/common.sh +0 -1102
  347. package/.claude/scripts/consolidate-research.sh +0 -182
  348. package/.claude/scripts/create-requirement.sh +0 -451
  349. package/.claude/scripts/delta-parser.ts +0 -637
  350. package/.claude/scripts/detect-file-conflicts.sh +0 -151
  351. package/.claude/scripts/export-contracts.sh +0 -117
  352. package/.claude/scripts/export-openspec.js +0 -222
  353. package/.claude/scripts/extract-data-model.sh +0 -78
  354. package/.claude/scripts/flow-context-add.sh +0 -134
  355. package/.claude/scripts/flow-context-init.sh +0 -133
  356. package/.claude/scripts/flow-context-validate.sh +0 -144
  357. package/.claude/scripts/flow-delta-apply.sh +0 -297
  358. package/.claude/scripts/flow-delta-archive.sh +0 -71
  359. package/.claude/scripts/flow-delta-create.sh +0 -202
  360. package/.claude/scripts/flow-delta-list.sh +0 -142
  361. package/.claude/scripts/flow-delta-status.sh +0 -235
  362. package/.claude/scripts/flow-quality-full.sh +0 -215
  363. package/.claude/scripts/flow-quality-quick.sh +0 -119
  364. package/.claude/scripts/flow-workspace-init.sh +0 -117
  365. package/.claude/scripts/flow-workspace-record.sh +0 -164
  366. package/.claude/scripts/generate-clarification-questions.sh +0 -377
  367. package/.claude/scripts/generate-clarification-report.sh +0 -463
  368. package/.claude/scripts/generate-quickstart.sh +0 -146
  369. package/.claude/scripts/generate-research-tasks.sh +0 -157
  370. package/.claude/scripts/generate-status-report.sh +0 -523
  371. package/.claude/scripts/generate-tech-analysis.sh +0 -46
  372. package/.claude/scripts/get-workflow-status.sh +0 -415
  373. package/.claude/scripts/import-openspec.js +0 -272
  374. package/.claude/scripts/locate-requirement-in-roadmap.sh +0 -233
  375. package/.claude/scripts/manage-constitution.sh +0 -602
  376. package/.claude/scripts/mark-task-complete.sh +0 -198
  377. package/.claude/scripts/parse-task-dependencies.js +0 -334
  378. package/.claude/scripts/populate-research-tasks.sh +0 -284
  379. package/.claude/scripts/record-quality-error.sh +0 -165
  380. package/.claude/scripts/recover-workflow.sh +0 -463
  381. package/.claude/scripts/run-clarify-scan.sh +0 -601
  382. package/.claude/scripts/run-high-review.sh +0 -62
  383. package/.claude/scripts/run-problem-analysis.sh +0 -68
  384. package/.claude/scripts/run-quality-gates.sh +0 -242
  385. package/.claude/scripts/setup-epic.sh +0 -173
  386. package/.claude/scripts/setup-ralph-loop.sh +0 -155
  387. package/.claude/scripts/sync-roadmap-progress.sh +0 -300
  388. package/.claude/scripts/sync-task-marks.sh +0 -199
  389. package/.claude/scripts/team-dev-init.sh +0 -319
  390. package/.claude/scripts/team-state-recovery.sh +0 -229
  391. package/.claude/scripts/test-clarify-scan.sh +0 -515
  392. package/.claude/scripts/update-agent-context.sh +0 -806
  393. package/.claude/scripts/validate-constitution.sh +0 -567
  394. package/.claude/scripts/validate-hooks.sh +0 -487
  395. package/.claude/scripts/validate-research.sh +0 -332
  396. package/.claude/scripts/validate-scope-boundary.sh +0 -493
  397. package/.claude/scripts/validate-scope.sh +0 -200
  398. package/.claude/scripts/verify-gate.sh +0 -269
  399. package/.claude/scripts/verify-setup.sh +0 -37
  400. package/.claude/scripts/workflow-status.ts +0 -433
  401. package/.claude/settings.json +0 -95
  402. package/.claude/skills/_reference-implementations/README.md +0 -96
  403. package/.claude/skills/_reference-implementations/backend-express-prisma/SKILL.md +0 -302
  404. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/architecture-overview.md +0 -451
  405. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/async-and-errors.md +0 -307
  406. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/complete-examples.md +0 -638
  407. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/configuration.md +0 -275
  408. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/database-patterns.md +0 -224
  409. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/middleware-guide.md +0 -213
  410. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/routing-and-controllers.md +0 -756
  411. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/sentry-and-monitoring.md +0 -336
  412. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/services-and-repositories.md +0 -789
  413. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/testing-guide.md +0 -235
  414. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/validation-patterns.md +0 -754
  415. package/.claude/skills/_reference-implementations/frontend-react-mui/SKILL.md +0 -399
  416. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/common-patterns.md +0 -331
  417. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/complete-examples.md +0 -872
  418. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/component-patterns.md +0 -502
  419. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/data-fetching.md +0 -767
  420. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/file-organization.md +0 -502
  421. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/loading-and-error-states.md +0 -501
  422. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/performance.md +0 -406
  423. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/routing-guide.md +0 -364
  424. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/styling-guide.md +0 -428
  425. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/typescript-standards.md +0 -418
  426. package/.claude/skills/attention-refresh/SKILL.md +0 -170
  427. package/.claude/skills/brainstorming/SKILL.md +0 -161
  428. package/.claude/skills/cc-devflow-orchestrator/SKILL.md +0 -169
  429. package/.claude/skills/constitution-guardian/SKILL.md +0 -306
  430. package/.claude/skills/constitution-quick-ref/SKILL.md +0 -374
  431. package/.claude/skills/debugging/SKILL.md +0 -221
  432. package/.claude/skills/file-standards/SKILL.md +0 -353
  433. package/.claude/skills/finishing-branch/SKILL.md +0 -189
  434. package/.claude/skills/flow-dev/CLAUDE.md +0 -16
  435. package/.claude/skills/flow-dev/SKILL.md +0 -94
  436. package/.claude/skills/flow-dev/assets/IMPLEMENTATION_PLAN_TEMPLATE.md +0 -71
  437. package/.claude/skills/flow-dev/context.jsonl +0 -4
  438. package/.claude/skills/flow-dev/dev-implementer.jsonl +0 -8
  439. package/.claude/skills/flow-dev/scripts/entry-gate.sh +0 -116
  440. package/.claude/skills/flow-dev/scripts/exit-gate.sh +0 -101
  441. package/.claude/skills/flow-dev/scripts/task-orchestrator.sh +0 -106
  442. package/.claude/skills/flow-fix/SKILL.md +0 -105
  443. package/.claude/skills/flow-fix/context.jsonl +0 -6
  444. package/.claude/skills/flow-fix/references/bug-analyzer.md +0 -381
  445. package/.claude/skills/flow-init/SKILL.md +0 -105
  446. package/.claude/skills/flow-init/assets/BRAINSTORM_TEMPLATE.md +0 -148
  447. package/.claude/skills/flow-init/assets/INIT_FLOW_TEMPLATE.md +0 -198
  448. package/.claude/skills/flow-init/assets/RESEARCH_TEMPLATE.md +0 -276
  449. package/.claude/skills/flow-init/context.jsonl +0 -5
  450. package/.claude/skills/flow-init/references/flow-researcher.md +0 -132
  451. package/.claude/skills/flow-init/scripts/check-prerequisites.sh +0 -240
  452. package/.claude/skills/flow-init/scripts/consolidate-research.sh +0 -182
  453. package/.claude/skills/flow-init/scripts/create-requirement.sh +0 -404
  454. package/.claude/skills/flow-init/scripts/generate-research-tasks.sh +0 -157
  455. package/.claude/skills/flow-init/scripts/populate-research-tasks.sh +0 -284
  456. package/.claude/skills/flow-init/scripts/validate-research.sh +0 -340
  457. package/.claude/skills/flow-quality/SKILL.md +0 -98
  458. package/.claude/skills/flow-quality/context.jsonl +0 -6
  459. package/.claude/skills/flow-quality/references/code-quality-reviewer.md +0 -205
  460. package/.claude/skills/flow-quality/references/qa-tester.md +0 -313
  461. package/.claude/skills/flow-quality/references/security-reviewer.md +0 -314
  462. package/.claude/skills/flow-quality/references/spec-reviewer.md +0 -221
  463. package/.claude/skills/flow-release/SKILL.md +0 -60
  464. package/.claude/skills/flow-release/context.jsonl +0 -5
  465. package/.claude/skills/flow-release/references/release-manager.md +0 -295
  466. package/.claude/skills/flow-spec/CLAUDE.md +0 -17
  467. package/.claude/skills/flow-spec/SKILL.md +0 -102
  468. package/.claude/skills/flow-spec/context.jsonl +0 -5
  469. package/.claude/skills/flow-spec/scripts/entry-gate.sh +0 -194
  470. package/.claude/skills/flow-spec/scripts/exit-gate.sh +0 -244
  471. package/.claude/skills/flow-spec/scripts/parallel-orchestrator.sh +0 -205
  472. package/.claude/skills/flow-spec/scripts/team-communication.sh +0 -353
  473. package/.claude/skills/flow-spec/scripts/team-init.sh +0 -195
  474. package/.claude/skills/flow-spec/scripts/test-team-mode.sh +0 -496
  475. package/.claude/skills/flow-spec/team-config.json +0 -165
  476. package/.claude/skills/flow-verify/CLAUDE.md +0 -10
  477. package/.claude/skills/flow-verify/SKILL.md +0 -53
  478. package/.claude/skills/flow-verify/context.jsonl +0 -5
  479. package/.claude/skills/fractal-docs/SKILL.md +0 -45
  480. package/.claude/skills/journey-checker/SKILL.md +0 -199
  481. package/.claude/skills/journey-checker/pressure-scenarios.md +0 -164
  482. package/.claude/skills/receiving-review/SKILL.md +0 -153
  483. package/.claude/skills/skill-creator/LICENSE.txt +0 -202
  484. package/.claude/skills/skill-creator/SKILL.md +0 -356
  485. package/.claude/skills/skill-creator/references/output-patterns.md +0 -82
  486. package/.claude/skills/skill-creator/references/workflows.md +0 -28
  487. package/.claude/skills/skill-creator/scripts/init_skill.py +0 -303
  488. package/.claude/skills/skill-creator/scripts/package_skill.py +0 -110
  489. package/.claude/skills/skill-creator/scripts/quick_validate.py +0 -95
  490. package/.claude/skills/skill-rules.json +0 -359
  491. package/.claude/skills/tdd/SKILL.md +0 -218
  492. package/.claude/skills/tdd-enforcer/SKILL.md +0 -192
  493. package/.claude/skills/utility/npm-release/CLAUDE.md +0 -55
  494. package/.claude/skills/utility/npm-release/SKILL.md +0 -379
  495. package/.claude/skills/utility/npm-release/references/version-decision-guide.md +0 -134
  496. package/.claude/skills/utility/npm-release/scripts/atomic-version-bump.sh +0 -95
  497. package/.claude/skills/utility/npm-release/scripts/validate-version-sync.sh +0 -82
  498. package/.claude/skills/utility/npm-release/scripts/version-decision-tree.sh +0 -44
  499. package/.claude/skills/verification/SKILL.md +0 -158
  500. package/.claude/skills/workflow.yaml +0 -219
  501. package/.claude/tests/README.md +0 -300
  502. package/.claude/tests/TODO.md +0 -69
  503. package/.claude/tests/__pycache__/test_analyze_upgrade_impact.cpython-311-pytest-7.2.2.pyc +0 -0
  504. package/.claude/tests/__pycache__/test_consolidate_research.cpython-311-pytest-7.2.2.pyc +0 -0
  505. package/.claude/tests/__pycache__/test_export_contracts.cpython-311-pytest-7.2.2.pyc +0 -0
  506. package/.claude/tests/__pycache__/test_extract_data_model.cpython-311-pytest-7.2.2.pyc +0 -0
  507. package/.claude/tests/__pycache__/test_generate_quickstart.cpython-311-pytest-7.2.2.pyc +0 -0
  508. package/.claude/tests/__pycache__/test_generate_research_tasks.cpython-311-pytest-7.2.2.pyc +0 -0
  509. package/.claude/tests/constitution/run_all_constitution_tests.sh +0 -111
  510. package/.claude/tests/constitution/test_agent_assignment.sh +0 -207
  511. package/.claude/tests/constitution/test_article_coverage.sh +0 -201
  512. package/.claude/tests/constitution/test_template_completeness.sh +0 -150
  513. package/.claude/tests/constitution/test_version_consistency.sh +0 -120
  514. package/.claude/tests/fixtures/spec_delta_full.md +0 -16
  515. package/.claude/tests/fixtures/tasks_progress_sample.md +0 -5
  516. package/.claude/tests/run-all-tests.sh +0 -229
  517. package/.claude/tests/scripts/run.sh +0 -30
  518. package/.claude/tests/scripts/test-framework.sh +0 -128
  519. package/.claude/tests/scripts/test_check_prerequisites.sh +0 -511
  520. package/.claude/tests/scripts/test_check_prerequisites.sh.bak +0 -504
  521. package/.claude/tests/scripts/test_check_prerequisites.sh.bak2 +0 -505
  522. package/.claude/tests/scripts/test_check_prerequisites.sh.bak3 +0 -506
  523. package/.claude/tests/scripts/test_check_prerequisites.sh.bak4 +0 -507
  524. package/.claude/tests/scripts/test_check_prerequisites.sh.bak5 +0 -508
  525. package/.claude/tests/scripts/test_check_task_status.sh +0 -499
  526. package/.claude/tests/scripts/test_common.sh +0 -244
  527. package/.claude/tests/scripts/test_generate_status_report.sh +0 -71
  528. package/.claude/tests/scripts/test_mark_task_complete.sh +0 -441
  529. package/.claude/tests/scripts/test_mark_task_complete.sh.backup +0 -410
  530. package/.claude/tests/scripts/test_recover_workflow.sh +0 -304
  531. package/.claude/tests/scripts/test_setup_epic.sh +0 -437
  532. package/.claude/tests/scripts/test_sync_task_marks.sh +0 -196
  533. package/.claude/tests/scripts/test_validate_constitution.sh +0 -74
  534. package/.claude/tests/scripts/test_validate_research.sh +0 -462
  535. package/.claude/tests/slugify.bats +0 -82
  536. package/.claude/tests/test-framework.sh +0 -732
  537. package/.claude/tests/test_analyze_upgrade_impact.py +0 -34
  538. package/.claude/tests/test_consolidate_research.py +0 -48
  539. package/.claude/tests/test_export_contracts.py +0 -43
  540. package/.claude/tests/test_extract_data_model.py +0 -33
  541. package/.claude/tests/test_generate_quickstart.py +0 -50
  542. package/.claude/tests/test_generate_research_tasks.py +0 -52
  543. package/.claude/tsc-cache/70d2fc6d-2936-429b-b529-429f1aae8c88/affected-repos.txt +0 -1
  544. package/.claude/tsc-cache/70d2fc6d-2936-429b-b529-429f1aae8c88/edited-files.log +0 -2
  545. package/bin/harness.js +0 -22
  546. package/docs/commands/core-roadmap.md +0 -106
  547. package/docs/commands/core-roadmap.zh-CN.md +0 -102
  548. package/docs/commands/core-style.md +0 -53
  549. package/docs/commands/core-style.zh-CN.md +0 -53
  550. package/docs/commands/flow-init.md +0 -140
  551. package/docs/commands/flow-init.zh-CN.md +0 -169
  552. package/docs/commands/flow-new.md +0 -39
  553. package/docs/commands/flow-new.zh-CN.md +0 -39
  554. package/lib/compiler/__tests__/compile-regression.test.js +0 -103
  555. package/lib/compiler/__tests__/multi-module-emitters.test.js +0 -534
  556. package/lib/compiler/__tests__/resource-copier.test.js +0 -26
  557. package/lib/compiler/__tests__/skill-discovery.test.js +0 -72
  558. package/lib/compiler/context-expander.js +0 -179
  559. package/lib/compiler/rules-emitters/__tests__/codex-rules-emitter.test.js +0 -109
  560. package/lib/compiler/rules-emitters/codex-rules-emitter.js +0 -116
  561. package/lib/compiler/skill-discovery.js +0 -68
  562. package/lib/harness/CLAUDE.md +0 -22
  563. package/lib/harness/__tests__/planner.tdd.test.js +0 -125
  564. package/lib/harness/cli.js +0 -208
  565. package/lib/harness/index.js +0 -18
  566. package/lib/harness/operations/dispatch.js +0 -298
  567. package/lib/harness/operations/init.js +0 -48
  568. package/lib/harness/operations/pack.js +0 -100
  569. package/lib/harness/operations/plan.js +0 -83
  570. package/lib/harness/operations/release.js +0 -170
  571. package/lib/harness/operations/resume.js +0 -44
  572. package/lib/harness/operations/verify.js +0 -177
  573. package/lib/harness/planner.js +0 -272
  574. package/lib/harness/query.js +0 -126
  575. package/lib/harness/schemas.js +0 -129
@@ -1,261 +0,0 @@
1
- # Product Backlog: {{PROJECT_NAME}}
2
-
3
- **Updated**: {{UPDATED_DATE}} 北京时间
4
- **Total Items**: {{TOTAL_COUNT}}
5
- **P1 Count**: {{P1_COUNT}} | **P2 Count**: {{P2_COUNT}} | **P3 Count**: {{P3_COUNT}}
6
-
7
- **Input**:
8
- - candidates 列表(包含 RM-ID, title, priority, derived_from, description)
9
- - dependencies 依赖关系
10
- - timeline 时间线分配
11
-
12
- **Prerequisites**: roadmap-planner agent 正在基于 core-roadmap 命令的上下文生成此文档
13
-
14
- ## Execution Flow (Backlog 生成流程)
15
- ```
16
- 1. Load context from command
17
- → Parse candidates array
18
- → Parse dependencies array
19
- → Parse timeline object
20
- → Validate all fields present
21
-
22
- 2. Load BACKLOG_TEMPLATE.md
23
- → Read template from .claude/docs/templates/BACKLOG_TEMPLATE.md
24
- → Prepare to fill all sections
25
-
26
- 3. Group candidates by priority
27
- → Separate into P1 (MVP Must-Have), P2 (Important), P3 (Nice-to-Have)
28
- → Sort by RM-ID within each priority group
29
- → Count items in each priority
30
-
31
- 4. Generate Priority 1 section
32
- → For each P1 candidate:
33
- • Generate detailed entry with all fields
34
- • Extract business value from description
35
- • Estimate effort (S/M/L based on effort_weeks)
36
- • Identify dependencies from dependencies array
37
- • Extract derived_from source
38
- • Assign target milestone from timeline
39
- • Set status = "Backlog"
40
-
41
- 5. Generate Priority 2 section
42
- → Similar to P1 but for P2 candidates
43
-
44
- 6. Generate Priority 3 section
45
- → Similar to P1 but for P3 candidates
46
-
47
- 7. Generate Dependency Matrix
48
- → For each RM-ID:
49
- • Find what it blocks (RM-IDs that depend on this)
50
- • Find what blocks it (REQ-IDs or RM-IDs this depends on)
51
- → Format as markdown table
52
- → Use "-" for no dependencies
53
-
54
- 8. Validate completeness
55
- → All candidates included
56
- → All have priority assigned
57
- → Dependency matrix complete
58
- → No {{PLACEHOLDER}} remaining
59
- → If incomplete: ERROR "Complete missing sections"
60
-
61
- 9. Write devflow/BACKLOG.md
62
- → Write complete file
63
- → Use UTF-8 encoding
64
-
65
- 10. Return: SUCCESS (BACKLOG.md generated)
66
- ```
67
-
68
- **重要**: 这是一个自执行模板。roadmap-planner agent 应该按照 Execution Flow 生成完整的 BACKLOG.md 文件。
69
-
70
- ---
71
-
72
- ## Priority 1 (MVP Must-Have)
73
-
74
- _P1 是必须完成的核心功能,没有这些功能产品无法交付价值。_
75
-
76
- ### {{RM_ID_1}}: {{TITLE_1}}
77
-
78
- - **Description**: {{DESCRIPTION_1}}
79
- - **Business Value**: {{BUSINESS_VALUE_1}}
80
- _为什么这是 P1?为什么用户需要这个功能?_
81
-
82
- - **Effort**: {{EFFORT_1}} (S/M/L)
83
- - S (Small): 1 周以内
84
- - M (Medium): 1-3 周
85
- - L (Large): 3 周以上
86
-
87
- - **Dependencies**: {{DEPENDENCIES_1}}
88
- _此功能依赖哪些已有需求?格式: REQ-009 (completed), REQ-010 (in progress)_
89
-
90
- - **Derived From**: {{DERIVED_FROM_1}}
91
- _来源:REQ-001, Tech Stack, User Feedback, etc._
92
-
93
- - **Target Milestone**: {{MILESTONE_1}}
94
- _计划在哪个里程碑完成?格式: M1-Q1-2025_
95
-
96
- - **Status**: {{STATUS_1}}
97
- _Backlog | Ready | In Progress | Blocked | Completed_
98
-
99
- ---
100
-
101
- ### {{RM_ID_2}}: {{TITLE_2}}
102
-
103
- - **Description**: {{DESCRIPTION_2}}
104
- - **Business Value**: {{BUSINESS_VALUE_2}}
105
- - **Effort**: {{EFFORT_2}} (S/M/L)
106
- - **Dependencies**: {{DEPENDENCIES_2}}
107
- - **Derived From**: {{DERIVED_FROM_2}}
108
- - **Target Milestone**: {{MILESTONE_2}}
109
- - **Status**: {{STATUS_2}}
110
-
111
- ---
112
-
113
- _重复以上结构为每个 P1 需求创建条目_
114
-
115
- ---
116
-
117
- ## Priority 2 (Important)
118
-
119
- _P2 是重要功能,能够显著提升用户体验或解决重要问题,但不影响 MVP 交付。_
120
-
121
- ### {{RM_ID_3}}: {{TITLE_3}}
122
-
123
- - **Description**: {{DESCRIPTION_3}}
124
- - **Business Value**: {{BUSINESS_VALUE_3}}
125
- _为什么这是 P2?相比 P1 的区别是什么?_
126
-
127
- - **Effort**: {{EFFORT_3}} (S/M/L)
128
- - **Dependencies**: {{DEPENDENCIES_3}}
129
- - **Derived From**: {{DERIVED_FROM_3}}
130
- - **Target Milestone**: {{MILESTONE_3}}
131
- - **Status**: {{STATUS_3}}
132
-
133
- ---
134
-
135
- _重复以上结构为每个 P2 需求创建条目_
136
-
137
- ---
138
-
139
- ## Priority 3 (Nice-to-Have)
140
-
141
- _P3 是锦上添花的功能,有更好没有也不影响核心价值。_
142
-
143
- ### {{RM_ID_4}}: {{TITLE_4}}
144
-
145
- - **Description**: {{DESCRIPTION_4}}
146
- - **Business Value**: {{BUSINESS_VALUE_4}}
147
- _为什么这是 P3?什么情况下会提升到 P2 或 P1?_
148
-
149
- - **Effort**: {{EFFORT_4}} (S/M/L)
150
- - **Dependencies**: {{DEPENDENCIES_4}}
151
- - **Derived From**: {{DERIVED_FROM_4}}
152
- - **Target Milestone**: {{MILESTONE_4}}
153
- - **Status**: {{STATUS_4}}
154
-
155
- ---
156
-
157
- _重复以上结构为每个 P3 需求创建条目_
158
-
159
- ---
160
-
161
- ## Dependency Matrix
162
-
163
- | RM-ID | Blocks | Blocked By |
164
- |-------|--------|------------|
165
- | {{RM_ID_1}} | {{BLOCKS_1}} | {{BLOCKED_BY_1}} |
166
- | {{RM_ID_2}} | {{BLOCKS_2}} | {{BLOCKED_BY_2}} |
167
- | {{RM_ID_3}} | {{BLOCKS_3}} | {{BLOCKED_BY_3}} |
168
- | {{RM_ID_4}} | {{BLOCKS_4}} | {{BLOCKED_BY_4}} |
169
-
170
- _填充规则:_
171
- - **Blocks**: 此需求完成后可以解锁的其他需求(逗号分隔)
172
- - 例如: `RM-003, RM-005`
173
- - 如果没有: `-`
174
-
175
- - **Blocked By**: 此需求依赖的其他需求(逗号分隔)
176
- - 格式: `REQ-001 (completed)`, `REQ-010 (in progress)`, `RM-002 (backlog)`
177
- - 如果没有: `-`
178
-
179
- _说明: 此矩阵用于快速识别需求间的依赖关系,避免优先级冲突_
180
-
181
- ---
182
-
183
- ## Backlog Management Notes
184
-
185
- ### 优先级调整指南
186
-
187
- **何时提升 P3 → P2**:
188
- - 用户强烈要求
189
- - 技术依赖需要(为了完成 P1/P2,需要先完成此功能)
190
- - 竞争压力(竞品已有类似功能)
191
-
192
- **何时提升 P2 → P1**:
193
- - 成为 MVP 的阻塞项
194
- - 影响核心用户体验
195
- - 安全或合规要求
196
-
197
- **何时降低优先级**:
198
- - 用户需求不明确
199
- - 技术复杂度过高,风险大
200
- - 有更好的替代方案
201
-
202
- ### 准入标准 (Definition of Ready)
203
-
204
- 一个 backlog item 准备好进入开发 (运行 /flow:init) 的标准:
205
- - [ ] Description 清晰明确
206
- - [ ] Business Value 已明确
207
- - [ ] Effort 已评估
208
- - [ ] Dependencies 已识别并满足(依赖的需求已完成)
209
- - [ ] Derived From 已标注
210
- - [ ] 已分配到具体的 Milestone
211
- - [ ] 用户已确认需求
212
-
213
- ### 完成标准 (Definition of Done)
214
-
215
- 一个 backlog item 被认为完成的标准:
216
- - [ ] 通过 /flow:init, /flow:spec, /flow:dev 流程
217
- - [ ] 所有 TASKS.md 中的任务完成
218
- - [ ] 通过 /flow:verify (测试 + 安全审查)
219
- - [ ] 代码已合并到主分支
220
- - [ ] 文档已更新
221
- - [ ] 用户验收通过
222
-
223
- ---
224
-
225
- ## Appendix: Priority Guidelines
226
-
227
- ### P1 (MVP Must-Have) - 优先级评估标准
228
-
229
- | 标准 | 说明 | 示例 |
230
- |------|------|------|
231
- | **核心价值** | 没有此功能产品无法交付核心价值 | 用户认证(没有认证就无法使用) |
232
- | **阻塞依赖** | 其他高优先级功能依赖此功能 | 权限管理(多个功能需要权限控制) |
233
- | **用户痛点** | 解决用户最迫切的问题 | 性能优化(启动慢导致用户流失) |
234
- | **合规要求** | 法律、安全、合规必须 | 数据加密(隐私合规要求) |
235
-
236
- ### P2 (Important) - 优先级评估标准
237
-
238
- | 标准 | 说明 | 示例 |
239
- |------|------|------|
240
- | **体验提升** | 显著提升用户体验但不影响核心功能 | 输入框增强(Markdown 预览) |
241
- | **运营需求** | 支持运营、分析、监控 | 数据分析模块 |
242
- | **扩展性** | 为未来扩展打基础 | 多账号支持 |
243
- | **差异化** | 与竞品形成差异化 | AI 辅助功能 |
244
-
245
- ### P3 (Nice-to-Have) - 优先级评估标准
246
-
247
- | 标准 | 说明 | 示例 |
248
- |------|------|------|
249
- | **锦上添花** | 有更好,没有也不影响 | 快捷键自定义 |
250
- | **小众需求** | 只有少数用户需要 | 高级配置项 |
251
- | **实验性** | 需要验证是否有价值 | 新 UI 风格 |
252
- | **技术优化** | 技术层面的优化,用户无感知 | 代码重构 |
253
-
254
- ---
255
-
256
- **生成说明**:
257
- 1. 所有 `{{PLACEHOLDER}}` 必须被实际内容替换
258
- 2. Business Value 应具体说明为什么这个功能重要
259
- 3. Effort 估算基于历史 Velocity
260
- 4. Dependency Matrix 应与 ROADMAP.md 保持一致
261
- 5. 所有日期使用北京时间
@@ -1,148 +0,0 @@
1
- ---
2
- req_id: "{REQ_ID}"
3
- title: "{TITLE}"
4
- created_at: "{ISO8601_TIMESTAMP}"
5
- brainstorm_version: "1.0"
6
- status: "draft"
7
- ---
8
-
9
- # {REQ_ID} Brainstorm Record
10
-
11
- > **[PROTOCOL]**: 后续所有开发必须与本文档保持一致。如有偏离,需更新本文档并说明原因。
12
-
13
- ## 原始需求(用户原话)
14
-
15
- > {用户的原始描述,一字不改,保留所有细节}
16
-
17
- ## 核心问题定义
18
-
19
- ### 解决什么问题?
20
-
21
- {一句话定义核心问题,例如:"用户无法在移动端完成支付"}
22
-
23
- ### 为谁解决?
24
-
25
- {用户画像,例如:"日均活跃用户 10,000+,年龄 25-45,移动端为主"}
26
-
27
- ### 现状痛点
28
-
29
- - {痛点1:具体描述,包含数据或用户反馈}
30
- - {痛点2}
31
- - {痛点3}
32
-
33
- ## 成功标准
34
-
35
- ### 如何判断需求完成?(验收标准)
36
-
37
- - [ ] {可度量的标准1,例如:"支付成功率 ≥ 95%"}
38
- - [ ] {可度量的标准2}
39
- - [ ] {可度量的标准3}
40
-
41
- ### 如何判断需求成功?(业务指标)
42
-
43
- - {业务指标1,例如:"订单转化率提升 10%"}
44
- - {业务指标2}
45
-
46
- ## 约束条件
47
-
48
- | 类型 | 约束 | 原因 |
49
- |------|------|------|
50
- | 技术 | {约束,例如:"必须兼容 iOS 12+"} | {原因} |
51
- | 时间 | {约束,例如:"2 周内上线"} | {原因} |
52
- | 资源 | {约束,例如:"1 前端 + 1 后端"} | {原因} |
53
- | 安全 | {约束,例如:"敏感数据需加密"} | {原因} |
54
- | 法规 | {约束,例如:"符合 GDPR"} | {原因} |
55
-
56
- ## 方案探索
57
-
58
- ### 方案 A: {名称} ⭐ 推荐
59
-
60
- **描述**:
61
- {方案概述,100-200 字}
62
-
63
- **优势**:
64
- - {优势1}
65
- - {优势2}
66
-
67
- **劣势**:
68
- - {劣势1}
69
- - {劣势2}
70
-
71
- **适用场景**:
72
- {何时选择这个方案}
73
-
74
- **实现要点**:
75
- 1. {关键步骤1}
76
- 2. {关键步骤2}
77
-
78
- ---
79
-
80
- ### 方案 B: {名称}
81
-
82
- **描述**:
83
- {方案概述}
84
-
85
- **优势**:
86
- - {优势1}
87
-
88
- **劣势**:
89
- - {劣势1}
90
-
91
- **适用场景**:
92
- {何时选择这个方案}
93
-
94
- ---
95
-
96
- ### 方案 C: {名称}
97
-
98
- **描述**:
99
- {方案概述}
100
-
101
- **优势**:
102
- - {优势1}
103
-
104
- **劣势**:
105
- - {劣势1}
106
-
107
- **适用场景**:
108
- {何时选择这个方案}
109
-
110
- ## 最终决策
111
-
112
- **选定方案**: 方案 {X}
113
-
114
- **选择理由**:
115
- {为什么选这个方案,而非其他方案}
116
-
117
- **否决理由**:
118
- - 方案 {Y}: {为什么不选}
119
- - 方案 {Z}: {为什么不选}
120
-
121
- ## 关键决策记录
122
-
123
- | 决策点 | 决策 | 理由 | 日期 |
124
- |--------|------|------|------|
125
- | {问题1} | {选择} | {为什么} | {YYYY-MM-DD} |
126
- | {问题2} | {选择} | {为什么} | {YYYY-MM-DD} |
127
-
128
- ## 风险识别
129
-
130
- | 风险 | 概率 | 影响 | 缓解策略 |
131
- |------|------|------|----------|
132
- | {风险1} | 高/中/低 | 高/中/低 | {应对措施} |
133
- | {风险2} | 高/中/低 | 高/中/低 | {应对措施} |
134
-
135
- ## 变更历史
136
-
137
- | 版本 | 日期 | 变更内容 | 变更原因 |
138
- |------|------|----------|----------|
139
- | 1.0 | {YYYY-MM-DD} | 初始版本 | 头脑风暴完成 |
140
-
141
- ---
142
-
143
- **⚠️ 追溯声明**:
144
- 本文档是 {REQ_ID} 的「北极星」。后续 PRD、EPIC、TASKS、实现都必须与本文档保持一致。
145
- 如发现偏离,必须:
146
- 1. 确认偏离原因
147
- 2. 更新本文档
148
- 3. 记录变更历史
@@ -1,52 +0,0 @@
1
- # {{TYPE}} Checklist: {{REQ_ID}}
2
-
3
- **Purpose**: {{TYPE_DESCRIPTION}}
4
- **Created**: {{TIMESTAMP}}
5
- **PRD Reference**: PRD.md
6
- **Quality Dimensions**: Completeness, Clarity, Consistency, Measurability, Coverage
7
-
8
- ---
9
-
10
- ## Requirement Completeness
11
-
12
- - [ ] CHK001 - Are all {{TYPE}} requirements documented in PRD? [Completeness, Spec §FR-XXX]
13
- - [ ] CHK002 - Are success criteria defined for {{TYPE}} features? [Completeness]
14
- - [ ] CHK003 - Are error handling scenarios specified? [Completeness, Gap]
15
-
16
- ## Requirement Clarity
17
-
18
- - [ ] CHK004 - Is '{{VAGUE_TERM}}' quantified with specific metrics? [Clarity, Spec §NFR-XXX]
19
- - [ ] CHK005 - Are {{TYPE}} behaviors explicitly specified? [Clarity]
20
- - [ ] CHK006 - Are technical constraints clearly documented? [Clarity]
21
-
22
- ## Requirement Consistency
23
-
24
- - [ ] CHK007 - Are {{TYPE}} requirements consistent across sections? [Consistency]
25
- - [ ] CHK008 - Are terminology and naming conventions consistent? [Consistency]
26
- - [ ] CHK009 - Are data formats consistent between requirements? [Consistency]
27
-
28
- ## Acceptance Criteria Quality
29
-
30
- - [ ] CHK010 - Can {{TYPE}} requirements be objectively verified? [Measurability]
31
- - [ ] CHK011 - Are acceptance criteria in Given-When-Then format? [Measurability]
32
- - [ ] CHK012 - Are performance metrics quantified with specific numbers? [Measurability]
33
-
34
- ## Scenario Coverage
35
-
36
- - [ ] CHK013 - Are edge cases defined for {{TYPE}} scenarios? [Coverage, Gap]
37
- - [ ] CHK014 - Are error states and recovery paths specified? [Coverage]
38
- - [ ] CHK015 - Are boundary conditions addressed? [Coverage]
39
-
40
- ---
41
-
42
- ## Notes
43
-
44
- - Check items off as completed: change `[ ]` to `[x]`
45
- - Items are numbered sequentially (CHK001-CHKnnn)
46
- - Quality dimensions: [Completeness], [Clarity], [Consistency], [Measurability], [Coverage]
47
- - References:
48
- - `[Spec §X.Y]` - Links to existing PRD requirement
49
- - `[Gap]` - Missing requirement identified
50
- - `[Ambiguity]` - Unclear requirement needs clarification
51
- - `[Conflict]` - Requirement conflicts with another
52
- - `[Assumption]` - Needs validation
@@ -1,206 +0,0 @@
1
- # Clarification Report: {{REQ_ID}}
2
-
3
- **Session ID**: {{SESSION_ID}}
4
- **Date**: {{DATE}}
5
- **Duration**: {{SCAN_DURATION}}s (scan) + interactive Q&A
6
- **Status**: {{STATUS}}
7
-
8
- ---
9
-
10
- ## Metadata
11
-
12
- | Field | Value |
13
- |-------|-------|
14
- | Requirement | {{REQ_ID}} |
15
- | Session ID | {{SESSION_ID}} |
16
- | Questions | {{QUESTIONS_ANSWERED}} / {{QUESTIONS_TOTAL}} |
17
- | Generated | {{GENERATED_AT}} |
18
-
19
- ---
20
-
21
- ## Coverage Summary
22
-
23
- **Legend**: ✅ Clear | ⚠️ Partial | ❌ Missing | 🔄 Resolved | ⏭️ Deferred
24
-
25
- | Category | Status | Issues | Resolution |
26
- |----------|--------|--------|------------|
27
- | Functional Scope | {{DIM_1_STATUS}} | {{DIM_1_ISSUES}} | {{DIM_1_RESOLUTION}} |
28
- | Data Model | {{DIM_2_STATUS}} | {{DIM_2_ISSUES}} | {{DIM_2_RESOLUTION}} |
29
- | UX Flow | {{DIM_3_STATUS}} | {{DIM_3_ISSUES}} | {{DIM_3_RESOLUTION}} |
30
- | Non-Functional Quality | {{DIM_4_STATUS}} | {{DIM_4_ISSUES}} | {{DIM_4_RESOLUTION}} |
31
- | Integration & Dependencies | {{DIM_5_STATUS}} | {{DIM_5_ISSUES}} | {{DIM_5_RESOLUTION}} |
32
- | Edge Cases | {{DIM_6_STATUS}} | {{DIM_6_ISSUES}} | {{DIM_6_RESOLUTION}} |
33
- | Constraints & Tradeoffs | {{DIM_7_STATUS}} | {{DIM_7_ISSUES}} | {{DIM_7_RESOLUTION}} |
34
- | Terminology | {{DIM_8_STATUS}} | {{DIM_8_ISSUES}} | {{DIM_8_RESOLUTION}} |
35
- | Completion Signals | {{DIM_9_STATUS}} | {{DIM_9_ISSUES}} | {{DIM_9_RESOLUTION}} |
36
- | Misc & Placeholders | {{DIM_10_STATUS}} | {{DIM_10_ISSUES}} | {{DIM_10_RESOLUTION}} |
37
- | Security & Privacy | {{DIM_11_STATUS}} | {{DIM_11_ISSUES}} | {{DIM_11_RESOLUTION}} |
38
-
39
- **Summary**:
40
- - ✅ Clear: {{CLEAR_COUNT}} categories
41
- - 🔄 Resolved: {{RESOLVED_COUNT}} categories
42
- - ⏭️ Deferred: {{DEFERRED_COUNT}} categories
43
- - ❌ Outstanding: {{OUTSTANDING_COUNT}} categories
44
-
45
- ---
46
-
47
- ## Scan Details
48
-
49
- ### High-Priority Issues (Priority ≥ 50)
50
-
51
- {{#HIGH_PRIORITY_ISSUES}}
52
- | Issue ID | Dimension | Description | Impact | Uncertainty | Priority |
53
- |----------|-----------|-------------|--------|-------------|----------|
54
- {{#ISSUES}}
55
- | {{ISSUE_ID}} | {{DIM_NAME}} | {{DESCRIPTION}} | {{IMPACT}}/10 | {{UNCERTAINTY}}/10 | {{PRIORITY}} |
56
- {{/ISSUES}}
57
- {{/HIGH_PRIORITY_ISSUES}}
58
-
59
- {{^HIGH_PRIORITY_ISSUES}}
60
- No high-priority issues detected.
61
- {{/HIGH_PRIORITY_ISSUES}}
62
-
63
- ---
64
-
65
- ## Clarification Session
66
-
67
- ### Session {{DATE}}
68
-
69
- {{#QUESTIONS}}
70
- #### {{QUESTION_ID}}: {{DIM_NAME}}
71
-
72
- **Question**: {{QUESTION_TEXT}}
73
-
74
- **Type**: {{QUESTION_TYPE}}
75
-
76
- {{#IS_MULTIPLE_CHOICE}}
77
- | Option | Description |
78
- |--------|-------------|
79
- {{#OPTIONS}}
80
- | **{{OPTION_ID}}** | {{OPTION_TEXT}} - {{OPTION_DESC}} |
81
- {{/OPTIONS}}
82
-
83
- **Recommended**: {{RECOMMENDED_OPTION}} ⭐
84
- > {{RECOMMENDED_RATIONALE}}
85
- {{/IS_MULTIPLE_CHOICE}}
86
-
87
- {{#IS_SHORT_ANSWER}}
88
- **Format**: Short answer (≤5 words)
89
- **Suggested**: {{SUGGESTED_VALUE}}
90
- {{/IS_SHORT_ANSWER}}
91
-
92
- **User Answer**: {{ANSWER}}
93
-
94
- **Rationale**: {{ANSWER_RATIONALE}}
95
-
96
- **Impact**: {{ANSWER_IMPACT}}
97
-
98
- - Q: {{QUESTION_TEXT}} → A: {{ANSWER}}
99
-
100
- ---
101
-
102
- {{/QUESTIONS}}
103
-
104
- {{^QUESTIONS}}
105
- No questions generated - research.md appears sufficiently clear.
106
- {{/QUESTIONS}}
107
-
108
- ---
109
-
110
- ## Integration Summary
111
-
112
- ### Sections Updated
113
-
114
- {{#UPDATED_SECTIONS}}
115
- | Section | Update Type | Description |
116
- |---------|-------------|-------------|
117
- {{#SECTIONS}}
118
- | {{SECTION_NAME}} | {{UPDATE_TYPE}} | {{UPDATE_DESC}} |
119
- {{/SECTIONS}}
120
- {{/UPDATED_SECTIONS}}
121
-
122
- {{^UPDATED_SECTIONS}}
123
- No sections updated (clarification-only session or no material changes required).
124
- {{/UPDATED_SECTIONS}}
125
-
126
- ---
127
-
128
- ## Deferred Items
129
-
130
- {{#DEFERRED_ITEMS}}
131
- | Category | Reason | Recommendation |
132
- |----------|--------|----------------|
133
- {{#ITEMS}}
134
- | {{CATEGORY}} | {{REASON}} | {{RECOMMENDATION}} |
135
- {{/ITEMS}}
136
- {{/DEFERRED_ITEMS}}
137
-
138
- {{^DEFERRED_ITEMS}}
139
- No items deferred.
140
- {{/DEFERRED_ITEMS}}
141
-
142
- ---
143
-
144
- ## Outstanding Items
145
-
146
- {{#OUTSTANDING_ITEMS}}
147
- > ⚠️ The following items remain unresolved but are low-impact:
148
-
149
- {{#ITEMS}}
150
- - **{{CATEGORY}}**: {{DESCRIPTION}}
151
- {{/ITEMS}}
152
- {{/OUTSTANDING_ITEMS}}
153
-
154
- {{^OUTSTANDING_ITEMS}}
155
- No outstanding items.
156
- {{/OUTSTANDING_ITEMS}}
157
-
158
- ---
159
-
160
- ## Next Steps
161
-
162
- {{#ALL_RESOLVED}}
163
- ✅ **Clarification complete**. All critical ambiguities have been resolved.
164
-
165
- Recommended next command: `/flow:spec {{REQ_ID}}`
166
- {{/ALL_RESOLVED}}
167
-
168
- {{#HAS_OUTSTANDING}}
169
- ⚠️ **Clarification partially complete**. Some low-impact items remain.
170
-
171
- Options:
172
- 1. Proceed with `/flow:spec {{REQ_ID}}` (acceptable risk)
173
- 2. Re-run `/flow:spec {{REQ_ID}} --overwrite` after planning phase
174
- {{/HAS_OUTSTANDING}}
175
-
176
- {{#HAS_DEFERRED}}
177
- ⏭️ **Items deferred to planning phase**:
178
- {{#DEFERRED_SUMMARY}}
179
- - {{ITEM}}
180
- {{/DEFERRED_SUMMARY}}
181
-
182
- These will be addressed during `/flow:spec` task planning or `/flow:dev` implementation.
183
- {{/HAS_DEFERRED}}
184
-
185
- {{#NO_QUESTIONS}}
186
- ✅ **No critical ambiguities detected**. research.md is sufficiently specified.
187
-
188
- Recommended next command: `/flow:spec {{REQ_ID}}`
189
- {{/NO_QUESTIONS}}
190
-
191
- ---
192
-
193
- ## Validation Checklist
194
-
195
- - [ ] CLR-001 All Q&A pairs recorded in session section
196
- - [ ] CLR-002 No duplicate questions asked
197
- - [ ] CLR-003 Questions ≤ 5 (actual: {{QUESTIONS_COUNT}})
198
- - [ ] CLR-004 Coverage summary complete for all 11 dimensions
199
- - [ ] CLR-005 No contradictory statements remain in research.md
200
- - [ ] CLR-006 Terminology consistent across updated sections
201
-
202
- ---
203
-
204
- **Generated by**: clarify-analyst agent
205
- **Template Version**: 1.0.0
206
- **Based on**: spec-kit /speckit.clarify pattern