cc-devflow 4.3.0 → 4.5.0

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 (579) hide show
  1. package/.claude/skills/cc-act/CHANGELOG.md +70 -0
  2. package/.claude/skills/cc-act/PLAYBOOK.md +212 -0
  3. package/.claude/skills/cc-act/SKILL.md +330 -0
  4. package/.claude/skills/cc-act/assets/PR_BRIEF_TEMPLATE.md +68 -0
  5. package/.claude/skills/cc-act/assets/RELEASE_NOTE_TEMPLATE.md +29 -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 +245 -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 +200 -0
  13. package/.claude/skills/cc-act/scripts/sync-act-docs.sh +328 -0
  14. package/.claude/skills/cc-act/scripts/verify-act-gate.sh +63 -0
  15. package/.claude/skills/cc-check/CHANGELOG.md +78 -0
  16. package/.claude/skills/cc-check/PLAYBOOK.md +153 -0
  17. package/.claude/skills/cc-check/SKILL.md +353 -0
  18. package/.claude/skills/cc-check/assets/REPORT_CARD_TEMPLATE.json +53 -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 +54 -0
  25. package/.claude/skills/cc-do/PLAYBOOK.md +119 -0
  26. package/.claude/skills/cc-do/SKILL.md +224 -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 +31 -0
  41. package/.claude/skills/cc-investigate/PLAYBOOK.md +49 -0
  42. package/.claude/skills/cc-investigate/SKILL.md +229 -0
  43. package/.claude/skills/cc-investigate/assets/ANALYSIS_TEMPLATE.md +56 -0
  44. package/.claude/skills/cc-investigate/assets/TASKS_TEMPLATE.md +53 -0
  45. package/.claude/skills/cc-investigate/assets/TASK_MANIFEST_TEMPLATE.json +106 -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 +104 -0
  49. package/.claude/skills/cc-plan/PLAYBOOK.md +106 -0
  50. package/.claude/skills/cc-plan/SKILL.md +333 -0
  51. package/.claude/skills/cc-plan/assets/DESIGN_TEMPLATE.md +156 -0
  52. package/.claude/skills/cc-plan/assets/TASKS_TEMPLATE.md +99 -0
  53. package/.claude/skills/cc-plan/assets/TASK_MANIFEST_TEMPLATE.json +111 -0
  54. package/.claude/skills/cc-plan/assets/TINY_DESIGN_TEMPLATE.md +80 -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 +119 -0
  60. package/.claude/skills/cc-roadmap/PLAYBOOK.md +136 -0
  61. package/.claude/skills/cc-roadmap/SKILL.md +267 -0
  62. package/.claude/skills/cc-roadmap/assets/BACKLOG_TEMPLATE.md +46 -0
  63. package/.claude/skills/cc-roadmap/assets/ROADMAP_TEMPLATE.md +154 -0
  64. package/.claude/skills/cc-roadmap/assets/TRACKING_TEMPLATE.json +51 -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 +12 -0
  77. package/.claude/skills/cc-spec-init/PLAYBOOK.md +55 -0
  78. package/.claude/skills/cc-spec-init/SKILL.md +135 -0
  79. package/.claude/skills/cc-spec-init/assets/CAPABILITY_TEMPLATE.md +64 -0
  80. package/.claude/skills/cc-spec-init/assets/CHANGE_META_TEMPLATE.json +28 -0
  81. package/.claude/skills/cc-spec-init/assets/INDEX_TEMPLATE.md +35 -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 +80 -4
  86. package/README.md +148 -741
  87. package/README.zh-CN.md +146 -740
  88. package/bin/adapt.js +2 -6
  89. package/bin/cc-devflow-cli.js +287 -166
  90. package/config/distributable-skills.json +24 -0
  91. package/config/schema/cc-devflow-config.schema.json +45 -0
  92. package/config/user-config.template.yml +16 -0
  93. package/docs/CLAUDE.md +10 -6
  94. package/docs/commands/README.md +19 -46
  95. package/docs/commands/README.zh-CN.md +25 -48
  96. package/docs/examples/BY-ARTIFACT.md +7 -0
  97. package/docs/examples/README.md +38 -0
  98. package/docs/examples/START-HERE.md +149 -0
  99. package/docs/examples/example-bindings.json +38 -0
  100. package/docs/examples/full-design-blocked/BACKLOG.md +45 -0
  101. package/docs/examples/full-design-blocked/README.md +55 -0
  102. package/docs/examples/full-design-blocked/ROADMAP.md +53 -0
  103. package/docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/planning/design.md +154 -0
  104. package/docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/planning/task-manifest.json +146 -0
  105. package/docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/planning/tasks.md +78 -0
  106. package/docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/review/report-card.json +52 -0
  107. package/docs/examples/full-design-blocked/roadmap-tracking.json +50 -0
  108. package/docs/examples/local-handoff/BACKLOG.md +45 -0
  109. package/docs/examples/local-handoff/README.md +56 -0
  110. package/docs/examples/local-handoff/ROADMAP.md +45 -0
  111. package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/handoff/resume-index.md +39 -0
  112. package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/handoff/status.md +29 -0
  113. package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/planning/design.md +71 -0
  114. package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/planning/task-manifest.json +98 -0
  115. package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/planning/tasks.md +59 -0
  116. package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/review/report-card.json +44 -0
  117. package/docs/examples/local-handoff/roadmap-tracking.json +48 -0
  118. package/docs/examples/pdca-loop/BACKLOG.md +46 -0
  119. package/docs/examples/pdca-loop/README.md +58 -0
  120. package/docs/examples/pdca-loop/ROADMAP.md +133 -0
  121. package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/handoff/pr-brief.md +72 -0
  122. package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/handoff/status.md +29 -0
  123. package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/design.md +72 -0
  124. package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/task-manifest.json +201 -0
  125. package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/tasks.md +73 -0
  126. package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/review/report-card.json +44 -0
  127. package/docs/examples/pdca-loop/roadmap-tracking.json +114 -0
  128. package/docs/examples/scripts/check-example-bindings.sh +116 -0
  129. package/docs/guides/getting-started.md +94 -129
  130. package/docs/guides/getting-started.zh-CN.md +103 -84
  131. package/docs/skill-runtime-migration.md +46 -0
  132. package/docs/v4.3.0-migration-guide.md +60 -225
  133. package/lib/compiler/CLAUDE.md +55 -84
  134. package/lib/compiler/__tests__/drift.test.js +1 -1
  135. package/lib/compiler/__tests__/errors.test.js +0 -1
  136. package/lib/compiler/__tests__/integration.test.js +49 -3
  137. package/lib/compiler/__tests__/manifest.test.js +0 -156
  138. package/lib/compiler/__tests__/parser.test.js +33 -104
  139. package/lib/compiler/__tests__/schemas.test.js +30 -34
  140. package/lib/compiler/__tests__/skills-registry.test.js +114 -0
  141. package/lib/compiler/__tests__/transformer.test.js +5 -9
  142. package/lib/compiler/emitters/antigravity-emitter.js +5 -213
  143. package/lib/compiler/emitters/base-emitter.js +3 -298
  144. package/lib/compiler/emitters/codex-emitter.js +4 -202
  145. package/lib/compiler/emitters/cursor-emitter.js +3 -287
  146. package/lib/compiler/emitters/qwen-emitter.js +4 -176
  147. package/lib/compiler/index.js +65 -345
  148. package/lib/compiler/manifest.js +6 -68
  149. package/lib/compiler/parser.js +31 -63
  150. package/lib/compiler/platforms.js +32 -277
  151. package/lib/compiler/resource-copier.js +176 -6
  152. package/lib/compiler/rules-emitters/__tests__/antigravity-rules-emitter.test.js +3 -3
  153. package/lib/compiler/rules-emitters/__tests__/cursor-rules-emitter.test.js +14 -4
  154. package/lib/compiler/rules-emitters/__tests__/qwen-rules-emitter.test.js +16 -7
  155. package/lib/compiler/rules-emitters/antigravity-rules-emitter.js +10 -15
  156. package/lib/compiler/rules-emitters/base-rules-emitter.js +5 -5
  157. package/lib/compiler/rules-emitters/cursor-rules-emitter.js +7 -12
  158. package/lib/compiler/rules-emitters/index.js +6 -3
  159. package/lib/compiler/rules-emitters/qwen-rules-emitter.js +7 -7
  160. package/lib/compiler/schemas.js +8 -4
  161. package/lib/compiler/skills-registry.js +213 -15
  162. package/lib/compiler/transformer.js +1 -1
  163. package/lib/skill-runtime/CLAUDE.md +19 -0
  164. package/lib/skill-runtime/__tests__/autopilot.test.js +210 -0
  165. package/lib/skill-runtime/__tests__/cli-bootstrap.integration.test.js +291 -0
  166. package/lib/skill-runtime/__tests__/config.test.js +161 -0
  167. package/lib/skill-runtime/__tests__/delegation.test.js +97 -0
  168. package/lib/skill-runtime/__tests__/dispatch.test.js +267 -0
  169. package/lib/skill-runtime/__tests__/intent.test.js +219 -0
  170. package/lib/skill-runtime/__tests__/lifecycle.test.js +169 -0
  171. package/lib/skill-runtime/__tests__/paths.test.js +42 -0
  172. package/lib/skill-runtime/__tests__/planner.tdd.test.js +250 -0
  173. package/lib/skill-runtime/__tests__/prepare-pr.test.js +139 -0
  174. package/lib/skill-runtime/__tests__/query.test.js +284 -0
  175. package/lib/skill-runtime/__tests__/runtime.integration.test.js +281 -0
  176. package/lib/skill-runtime/__tests__/schemas.test.js +207 -0
  177. package/lib/skill-runtime/__tests__/team-state.test.js +51 -0
  178. package/lib/skill-runtime/__tests__/worker-run.test.js +253 -0
  179. package/lib/skill-runtime/__tests__/worker.test.js +56 -0
  180. package/lib/skill-runtime/artifacts.js +93 -0
  181. package/lib/skill-runtime/config.js +379 -0
  182. package/lib/skill-runtime/delegation.js +533 -0
  183. package/lib/skill-runtime/index.js +36 -0
  184. package/lib/skill-runtime/intent.js +333 -0
  185. package/lib/skill-runtime/lifecycle.js +294 -0
  186. package/lib/skill-runtime/operations/CLAUDE.md +19 -0
  187. package/lib/skill-runtime/operations/approve.js +66 -0
  188. package/lib/skill-runtime/operations/autopilot-core.js +337 -0
  189. package/lib/skill-runtime/operations/autopilot-execution.js +307 -0
  190. package/lib/skill-runtime/operations/autopilot-shared.js +48 -0
  191. package/lib/skill-runtime/operations/autopilot.js +163 -0
  192. package/lib/skill-runtime/operations/dispatch.js +454 -0
  193. package/lib/skill-runtime/operations/init.js +64 -0
  194. package/lib/{harness → skill-runtime}/operations/janitor.js +9 -6
  195. package/lib/skill-runtime/operations/plan.js +59 -0
  196. package/lib/skill-runtime/operations/prepare-pr.js +25 -0
  197. package/lib/skill-runtime/operations/release.js +96 -0
  198. package/lib/skill-runtime/operations/resume.js +143 -0
  199. package/lib/skill-runtime/operations/snapshot.js +45 -0
  200. package/lib/skill-runtime/operations/verify.js +170 -0
  201. package/lib/skill-runtime/operations/worker-run.js +529 -0
  202. package/lib/skill-runtime/operations/worker.js +33 -0
  203. package/lib/skill-runtime/paths.js +213 -0
  204. package/lib/skill-runtime/planner.js +519 -0
  205. package/lib/skill-runtime/query.js +157 -0
  206. package/lib/skill-runtime/review.js +557 -0
  207. package/lib/skill-runtime/schemas.js +400 -0
  208. package/lib/{harness → skill-runtime}/store.js +45 -30
  209. package/lib/skill-runtime/team-state.js +122 -0
  210. package/package.json +13 -11
  211. package/.claude/CLAUDE.md +0 -125
  212. package/.claude/agents/architecture-designer.md +0 -443
  213. package/.claude/agents/bug-analyzer.md +0 -381
  214. package/.claude/agents/checklist-agent.md +0 -175
  215. package/.claude/agents/clarify-analyst.md +0 -50
  216. package/.claude/agents/code-quality-reviewer.md +0 -205
  217. package/.claude/agents/code-reviewer.md +0 -71
  218. package/.claude/agents/codex-analyzer.md +0 -39
  219. package/.claude/agents/compatibility-checker.md +0 -579
  220. package/.claude/agents/consistency-checker.md +0 -532
  221. package/.claude/agents/dev-implementer.md +0 -195
  222. package/.claude/agents/flow-researcher.md +0 -132
  223. package/.claude/agents/impact-analyzer.md +0 -440
  224. package/.claude/agents/planner.md +0 -230
  225. package/.claude/agents/prd-writer.md +0 -320
  226. package/.claude/agents/project-guidelines-generator.md +0 -1329
  227. package/.claude/agents/qa-tester.md +0 -313
  228. package/.claude/agents/release-manager.md +0 -295
  229. package/.claude/agents/security-reviewer.md +0 -314
  230. package/.claude/agents/spec-reviewer.md +0 -221
  231. package/.claude/agents/style-guide-generator.md +0 -458
  232. package/.claude/agents/tech-architect.md +0 -516
  233. package/.claude/agents/ui-designer.md +0 -485
  234. package/.claude/commands/core/architecture.md +0 -459
  235. package/.claude/commands/core/guidelines.md +0 -511
  236. package/.claude/commands/core/roadmap.md +0 -468
  237. package/.claude/commands/core/style.md +0 -83
  238. package/.claude/commands/flow/CLAUDE.md +0 -24
  239. package/.claude/commands/flow/archive.md +0 -280
  240. package/.claude/commands/flow/constitution.md +0 -82
  241. package/.claude/commands/flow/context.md +0 -150
  242. package/.claude/commands/flow/delta.md +0 -245
  243. package/.claude/commands/flow/dev.md +0 -40
  244. package/.claude/commands/flow/fix.md +0 -217
  245. package/.claude/commands/flow/ideate.md +0 -214
  246. package/.claude/commands/flow/init.md +0 -38
  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/examples/design-inspiration-pool.md +0 -59
  266. package/.claude/docs/examples/ui-prototype-constitution-checklist.md +0 -75
  267. package/.claude/docs/guides/INIT_TROUBLESHOOTING.md +0 -117
  268. package/.claude/docs/guides/NEW_TROUBLESHOOTING.md +0 -99
  269. package/.claude/docs/guides/ROADMAP_TROUBLESHOOTING.md +0 -188
  270. package/.claude/docs/guides/TASK_COMPLETION_MARKING.md +0 -338
  271. package/.claude/docs/guides/TEAM_MODE_GUIDE.md +0 -312
  272. package/.claude/docs/implementation-summary-v7.md +0 -449
  273. package/.claude/docs/spec-format-guide.md +0 -349
  274. package/.claude/docs/state-consolidation-design.md +0 -323
  275. package/.claude/docs/templates/ARCHITECTURE_TEMPLATE.md +0 -332
  276. package/.claude/docs/templates/ATTEMPT_TEMPLATE.md +0 -156
  277. package/.claude/docs/templates/BACKLOG_TEMPLATE.md +0 -261
  278. package/.claude/docs/templates/BRAINSTORM_TEMPLATE.md +0 -148
  279. package/.claude/docs/templates/CHECKLIST_TEMPLATE.md +0 -52
  280. package/.claude/docs/templates/CLARIFICATION_REPORT_TEMPLATE.md +0 -206
  281. package/.claude/docs/templates/CODE_REVIEW_TEMPLATE.md +0 -71
  282. package/.claude/docs/templates/DELTA_SPEC_TEMPLATE.md +0 -91
  283. package/.claude/docs/templates/DESIGN_DECISIONS_TEMPLATE.md +0 -151
  284. package/.claude/docs/templates/DESIGN_TEMPLATE.md +0 -157
  285. package/.claude/docs/templates/ERROR_LOG_TEMPLATE.md +0 -80
  286. package/.claude/docs/templates/INIT_FLOW_TEMPLATE.md +0 -198
  287. package/.claude/docs/templates/INTENT_CLARIFICATION_TEMPLATE.md +0 -57
  288. package/.claude/docs/templates/JOURNAL_TEMPLATE.md +0 -75
  289. package/.claude/docs/templates/NEW_ORCHESTRATION_TEMPLATE.md +0 -76
  290. package/.claude/docs/templates/PROPOSAL_TEMPLATE.md +0 -91
  291. package/.claude/docs/templates/RESEARCH_TEMPLATE.md +0 -276
  292. package/.claude/docs/templates/REVIEW-HIGH.md +0 -57
  293. package/.claude/docs/templates/ROADMAP_DIALOGUE_TEMPLATE.md +0 -198
  294. package/.claude/docs/templates/ROADMAP_TEMPLATE.md +0 -310
  295. package/.claude/docs/templates/SPEC_TEMPLATE_DELTA.md +0 -139
  296. package/.claude/docs/templates/SPEC_TEMPLATE_PROJECT.md +0 -93
  297. package/.claude/docs/templates/STYLE_TEMPLATE.md +0 -479
  298. package/.claude/docs/templates/UI_PROTOTYPE_TEMPLATE.md +0 -373
  299. package/.claude/docs/templates/_shared/CLAUDE.md +0 -36
  300. package/.claude/docs/templates/_shared/CONSTITUTION_CHECK.md +0 -125
  301. package/.claude/docs/templates/_shared/VALIDATION_CHECKLIST.md +0 -187
  302. package/.claude/docs/templates/_shared/YAML_FRONTMATTER.md +0 -164
  303. package/.claude/docs/templates/context/dev.jsonl.template +0 -6
  304. package/.claude/docs/templates/context/epic.jsonl.template +0 -5
  305. package/.claude/docs/templates/context/prd.jsonl.template +0 -4
  306. package/.claude/docs/templates/context/research.jsonl.template +0 -4
  307. package/.claude/docs/templates/context/review.jsonl.template +0 -5
  308. package/.claude/docs/templates/context/tech.jsonl.template +0 -5
  309. package/.claude/guides/agent-guides/agent-coordination-guide.md +0 -459
  310. package/.claude/guides/project-guidelines-system.md +0 -463
  311. package/.claude/guides/technical-guides/datetime-handling-guide.md +0 -563
  312. package/.claude/guides/technical-guides/git-github-guide.md +0 -642
  313. package/.claude/guides/technical-guides/test-execution-guide.md +0 -618
  314. package/.claude/guides/workflow-guides/bug-fix-orchestrator.md +0 -217
  315. package/.claude/guides/workflow-guides/flow-orchestrator.md +0 -48
  316. package/.claude/hooks/CLAUDE.md +0 -342
  317. package/.claude/hooks/checklist-gate.js +0 -397
  318. package/.claude/hooks/error-handling-reminder.sh +0 -12
  319. package/.claude/hooks/error-handling-reminder.ts +0 -459
  320. package/.claude/hooks/hooks.json +0 -15
  321. package/.claude/hooks/inject-agent-context.ts +0 -480
  322. package/.claude/hooks/inject-skill-context.ts +0 -359
  323. package/.claude/hooks/post-tool-use-tracker.sh +0 -280
  324. package/.claude/hooks/pre-tool-use-guardrail.sh +0 -36
  325. package/.claude/hooks/pre-tool-use-guardrail.ts +0 -342
  326. package/.claude/hooks/ralph-loop.ts +0 -931
  327. package/.claude/hooks/ralph-stop-hook.sh +0 -190
  328. package/.claude/hooks/skill-activation-prompt.sh +0 -36
  329. package/.claude/hooks/skill-activation-prompt.ts +0 -214
  330. package/.claude/hooks/state/skills-used-test-guard.json +0 -3
  331. package/.claude/hooks/task-completed-hook.ts +0 -593
  332. package/.claude/hooks/teammate-idle-hook.ts +0 -690
  333. package/.claude/hooks/types/team-types.d.ts +0 -238
  334. package/.claude/rules/devflow-conventions.md +0 -286
  335. package/.claude/rules/project-constitution.md +0 -1002
  336. package/.claude/rules/rationalization-library.md +0 -282
  337. package/.claude/schemas/constitution.schema.json +0 -43
  338. package/.claude/scripts/.claude/commands/flow/export-openspec.md +0 -221
  339. package/.claude/scripts/.claude/commands/flow/import-openspec.md +0 -171
  340. package/.claude/scripts/CLAUDE.md +0 -76
  341. package/.claude/scripts/__tests__/openspec.test.js +0 -212
  342. package/.claude/scripts/analyze-upgrade-impact.sh +0 -200
  343. package/.claude/scripts/archive-requirement.sh +0 -394
  344. package/.claude/scripts/calculate-checklist-completion.sh +0 -243
  345. package/.claude/scripts/calculate-quarter.sh +0 -206
  346. package/.claude/scripts/check-dependencies.sh +0 -409
  347. package/.claude/scripts/check-prerequisites.sh +0 -232
  348. package/.claude/scripts/check-task-status.sh +0 -288
  349. package/.claude/scripts/checklist-errors.sh +0 -131
  350. package/.claude/scripts/common.sh +0 -1102
  351. package/.claude/scripts/consolidate-research.sh +0 -182
  352. package/.claude/scripts/create-requirement.sh +0 -451
  353. package/.claude/scripts/delta-parser.ts +0 -637
  354. package/.claude/scripts/detect-file-conflicts.sh +0 -151
  355. package/.claude/scripts/export-contracts.sh +0 -117
  356. package/.claude/scripts/export-openspec.js +0 -222
  357. package/.claude/scripts/extract-data-model.sh +0 -78
  358. package/.claude/scripts/flow-context-add.sh +0 -134
  359. package/.claude/scripts/flow-context-init.sh +0 -133
  360. package/.claude/scripts/flow-context-validate.sh +0 -144
  361. package/.claude/scripts/flow-delta-apply.sh +0 -297
  362. package/.claude/scripts/flow-delta-archive.sh +0 -71
  363. package/.claude/scripts/flow-delta-create.sh +0 -202
  364. package/.claude/scripts/flow-delta-list.sh +0 -142
  365. package/.claude/scripts/flow-delta-status.sh +0 -235
  366. package/.claude/scripts/flow-quality-full.sh +0 -215
  367. package/.claude/scripts/flow-quality-quick.sh +0 -119
  368. package/.claude/scripts/flow-workspace-init.sh +0 -117
  369. package/.claude/scripts/flow-workspace-record.sh +0 -164
  370. package/.claude/scripts/generate-clarification-questions.sh +0 -377
  371. package/.claude/scripts/generate-clarification-report.sh +0 -463
  372. package/.claude/scripts/generate-quickstart.sh +0 -146
  373. package/.claude/scripts/generate-research-tasks.sh +0 -157
  374. package/.claude/scripts/generate-status-report.sh +0 -523
  375. package/.claude/scripts/generate-tech-analysis.sh +0 -46
  376. package/.claude/scripts/get-workflow-status.sh +0 -415
  377. package/.claude/scripts/import-openspec.js +0 -272
  378. package/.claude/scripts/locate-requirement-in-roadmap.sh +0 -233
  379. package/.claude/scripts/manage-constitution.sh +0 -602
  380. package/.claude/scripts/mark-task-complete.sh +0 -198
  381. package/.claude/scripts/parse-task-dependencies.js +0 -334
  382. package/.claude/scripts/populate-research-tasks.sh +0 -284
  383. package/.claude/scripts/record-quality-error.sh +0 -165
  384. package/.claude/scripts/recover-workflow.sh +0 -463
  385. package/.claude/scripts/run-clarify-scan.sh +0 -601
  386. package/.claude/scripts/run-high-review.sh +0 -62
  387. package/.claude/scripts/run-problem-analysis.sh +0 -68
  388. package/.claude/scripts/run-quality-gates.sh +0 -242
  389. package/.claude/scripts/setup-epic.sh +0 -173
  390. package/.claude/scripts/setup-ralph-loop.sh +0 -155
  391. package/.claude/scripts/sync-roadmap-progress.sh +0 -300
  392. package/.claude/scripts/sync-task-marks.sh +0 -199
  393. package/.claude/scripts/team-dev-init.sh +0 -319
  394. package/.claude/scripts/team-state-recovery.sh +0 -229
  395. package/.claude/scripts/test-clarify-scan.sh +0 -515
  396. package/.claude/scripts/update-agent-context.sh +0 -806
  397. package/.claude/scripts/validate-constitution.sh +0 -567
  398. package/.claude/scripts/validate-hooks.sh +0 -487
  399. package/.claude/scripts/validate-research.sh +0 -332
  400. package/.claude/scripts/validate-scope-boundary.sh +0 -493
  401. package/.claude/scripts/validate-scope.sh +0 -200
  402. package/.claude/scripts/verify-gate.sh +0 -269
  403. package/.claude/scripts/verify-setup.sh +0 -37
  404. package/.claude/scripts/workflow-status.ts +0 -433
  405. package/.claude/settings.json +0 -95
  406. package/.claude/skills/_reference-implementations/README.md +0 -96
  407. package/.claude/skills/_reference-implementations/backend-express-prisma/SKILL.md +0 -302
  408. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/architecture-overview.md +0 -451
  409. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/async-and-errors.md +0 -307
  410. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/complete-examples.md +0 -638
  411. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/configuration.md +0 -275
  412. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/database-patterns.md +0 -224
  413. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/middleware-guide.md +0 -213
  414. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/routing-and-controllers.md +0 -756
  415. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/sentry-and-monitoring.md +0 -336
  416. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/services-and-repositories.md +0 -789
  417. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/testing-guide.md +0 -235
  418. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/validation-patterns.md +0 -754
  419. package/.claude/skills/_reference-implementations/frontend-react-mui/SKILL.md +0 -399
  420. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/common-patterns.md +0 -331
  421. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/complete-examples.md +0 -872
  422. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/component-patterns.md +0 -502
  423. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/data-fetching.md +0 -767
  424. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/file-organization.md +0 -502
  425. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/loading-and-error-states.md +0 -501
  426. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/performance.md +0 -406
  427. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/routing-guide.md +0 -364
  428. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/styling-guide.md +0 -428
  429. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/typescript-standards.md +0 -418
  430. package/.claude/skills/attention-refresh/SKILL.md +0 -170
  431. package/.claude/skills/brainstorming/SKILL.md +0 -161
  432. package/.claude/skills/cc-devflow-orchestrator/SKILL.md +0 -169
  433. package/.claude/skills/constitution-guardian/SKILL.md +0 -306
  434. package/.claude/skills/constitution-quick-ref/SKILL.md +0 -374
  435. package/.claude/skills/debugging/SKILL.md +0 -221
  436. package/.claude/skills/file-standards/SKILL.md +0 -353
  437. package/.claude/skills/finishing-branch/SKILL.md +0 -189
  438. package/.claude/skills/flow-dev/CLAUDE.md +0 -16
  439. package/.claude/skills/flow-dev/SKILL.md +0 -94
  440. package/.claude/skills/flow-dev/assets/IMPLEMENTATION_PLAN_TEMPLATE.md +0 -71
  441. package/.claude/skills/flow-dev/context.jsonl +0 -4
  442. package/.claude/skills/flow-dev/dev-implementer.jsonl +0 -8
  443. package/.claude/skills/flow-dev/scripts/entry-gate.sh +0 -116
  444. package/.claude/skills/flow-dev/scripts/exit-gate.sh +0 -101
  445. package/.claude/skills/flow-dev/scripts/task-orchestrator.sh +0 -106
  446. package/.claude/skills/flow-fix/SKILL.md +0 -105
  447. package/.claude/skills/flow-fix/context.jsonl +0 -6
  448. package/.claude/skills/flow-fix/references/bug-analyzer.md +0 -381
  449. package/.claude/skills/flow-init/SKILL.md +0 -105
  450. package/.claude/skills/flow-init/assets/BRAINSTORM_TEMPLATE.md +0 -148
  451. package/.claude/skills/flow-init/assets/INIT_FLOW_TEMPLATE.md +0 -198
  452. package/.claude/skills/flow-init/assets/RESEARCH_TEMPLATE.md +0 -276
  453. package/.claude/skills/flow-init/context.jsonl +0 -5
  454. package/.claude/skills/flow-init/references/flow-researcher.md +0 -132
  455. package/.claude/skills/flow-init/scripts/check-prerequisites.sh +0 -240
  456. package/.claude/skills/flow-init/scripts/consolidate-research.sh +0 -182
  457. package/.claude/skills/flow-init/scripts/create-requirement.sh +0 -404
  458. package/.claude/skills/flow-init/scripts/generate-research-tasks.sh +0 -157
  459. package/.claude/skills/flow-init/scripts/populate-research-tasks.sh +0 -284
  460. package/.claude/skills/flow-init/scripts/validate-research.sh +0 -340
  461. package/.claude/skills/flow-quality/SKILL.md +0 -98
  462. package/.claude/skills/flow-quality/context.jsonl +0 -6
  463. package/.claude/skills/flow-quality/references/code-quality-reviewer.md +0 -205
  464. package/.claude/skills/flow-quality/references/qa-tester.md +0 -313
  465. package/.claude/skills/flow-quality/references/security-reviewer.md +0 -314
  466. package/.claude/skills/flow-quality/references/spec-reviewer.md +0 -221
  467. package/.claude/skills/flow-release/SKILL.md +0 -60
  468. package/.claude/skills/flow-release/context.jsonl +0 -5
  469. package/.claude/skills/flow-release/references/release-manager.md +0 -295
  470. package/.claude/skills/flow-spec/CLAUDE.md +0 -17
  471. package/.claude/skills/flow-spec/SKILL.md +0 -102
  472. package/.claude/skills/flow-spec/context.jsonl +0 -5
  473. package/.claude/skills/flow-spec/scripts/entry-gate.sh +0 -194
  474. package/.claude/skills/flow-spec/scripts/exit-gate.sh +0 -244
  475. package/.claude/skills/flow-spec/scripts/parallel-orchestrator.sh +0 -205
  476. package/.claude/skills/flow-spec/scripts/team-communication.sh +0 -353
  477. package/.claude/skills/flow-spec/scripts/team-init.sh +0 -195
  478. package/.claude/skills/flow-spec/scripts/test-team-mode.sh +0 -496
  479. package/.claude/skills/flow-spec/team-config.json +0 -165
  480. package/.claude/skills/flow-verify/CLAUDE.md +0 -10
  481. package/.claude/skills/flow-verify/SKILL.md +0 -53
  482. package/.claude/skills/flow-verify/context.jsonl +0 -5
  483. package/.claude/skills/fractal-docs/SKILL.md +0 -45
  484. package/.claude/skills/journey-checker/SKILL.md +0 -199
  485. package/.claude/skills/journey-checker/pressure-scenarios.md +0 -164
  486. package/.claude/skills/receiving-review/SKILL.md +0 -153
  487. package/.claude/skills/skill-creator/LICENSE.txt +0 -202
  488. package/.claude/skills/skill-creator/SKILL.md +0 -356
  489. package/.claude/skills/skill-creator/references/output-patterns.md +0 -82
  490. package/.claude/skills/skill-creator/references/workflows.md +0 -28
  491. package/.claude/skills/skill-creator/scripts/init_skill.py +0 -303
  492. package/.claude/skills/skill-creator/scripts/package_skill.py +0 -110
  493. package/.claude/skills/skill-creator/scripts/quick_validate.py +0 -95
  494. package/.claude/skills/skill-rules.json +0 -359
  495. package/.claude/skills/tdd/SKILL.md +0 -218
  496. package/.claude/skills/tdd-enforcer/SKILL.md +0 -192
  497. package/.claude/skills/utility/npm-release/CLAUDE.md +0 -55
  498. package/.claude/skills/utility/npm-release/SKILL.md +0 -379
  499. package/.claude/skills/utility/npm-release/references/version-decision-guide.md +0 -134
  500. package/.claude/skills/utility/npm-release/scripts/atomic-version-bump.sh +0 -95
  501. package/.claude/skills/utility/npm-release/scripts/validate-version-sync.sh +0 -82
  502. package/.claude/skills/utility/npm-release/scripts/version-decision-tree.sh +0 -44
  503. package/.claude/skills/verification/SKILL.md +0 -158
  504. package/.claude/skills/workflow.yaml +0 -219
  505. package/.claude/tests/README.md +0 -300
  506. package/.claude/tests/TODO.md +0 -69
  507. package/.claude/tests/__pycache__/test_analyze_upgrade_impact.cpython-311-pytest-7.2.2.pyc +0 -0
  508. package/.claude/tests/__pycache__/test_consolidate_research.cpython-311-pytest-7.2.2.pyc +0 -0
  509. package/.claude/tests/__pycache__/test_export_contracts.cpython-311-pytest-7.2.2.pyc +0 -0
  510. package/.claude/tests/__pycache__/test_extract_data_model.cpython-311-pytest-7.2.2.pyc +0 -0
  511. package/.claude/tests/__pycache__/test_generate_quickstart.cpython-311-pytest-7.2.2.pyc +0 -0
  512. package/.claude/tests/__pycache__/test_generate_research_tasks.cpython-311-pytest-7.2.2.pyc +0 -0
  513. package/.claude/tests/constitution/run_all_constitution_tests.sh +0 -111
  514. package/.claude/tests/constitution/test_agent_assignment.sh +0 -207
  515. package/.claude/tests/constitution/test_article_coverage.sh +0 -201
  516. package/.claude/tests/constitution/test_template_completeness.sh +0 -150
  517. package/.claude/tests/constitution/test_version_consistency.sh +0 -120
  518. package/.claude/tests/fixtures/spec_delta_full.md +0 -16
  519. package/.claude/tests/fixtures/tasks_progress_sample.md +0 -5
  520. package/.claude/tests/run-all-tests.sh +0 -229
  521. package/.claude/tests/scripts/run.sh +0 -30
  522. package/.claude/tests/scripts/test-framework.sh +0 -128
  523. package/.claude/tests/scripts/test_check_prerequisites.sh +0 -511
  524. package/.claude/tests/scripts/test_check_prerequisites.sh.bak +0 -504
  525. package/.claude/tests/scripts/test_check_prerequisites.sh.bak2 +0 -505
  526. package/.claude/tests/scripts/test_check_prerequisites.sh.bak3 +0 -506
  527. package/.claude/tests/scripts/test_check_prerequisites.sh.bak4 +0 -507
  528. package/.claude/tests/scripts/test_check_prerequisites.sh.bak5 +0 -508
  529. package/.claude/tests/scripts/test_check_task_status.sh +0 -499
  530. package/.claude/tests/scripts/test_common.sh +0 -244
  531. package/.claude/tests/scripts/test_generate_status_report.sh +0 -71
  532. package/.claude/tests/scripts/test_mark_task_complete.sh +0 -441
  533. package/.claude/tests/scripts/test_mark_task_complete.sh.backup +0 -410
  534. package/.claude/tests/scripts/test_recover_workflow.sh +0 -304
  535. package/.claude/tests/scripts/test_setup_epic.sh +0 -437
  536. package/.claude/tests/scripts/test_sync_task_marks.sh +0 -196
  537. package/.claude/tests/scripts/test_validate_constitution.sh +0 -74
  538. package/.claude/tests/scripts/test_validate_research.sh +0 -462
  539. package/.claude/tests/slugify.bats +0 -82
  540. package/.claude/tests/test-framework.sh +0 -732
  541. package/.claude/tests/test_analyze_upgrade_impact.py +0 -34
  542. package/.claude/tests/test_consolidate_research.py +0 -48
  543. package/.claude/tests/test_export_contracts.py +0 -43
  544. package/.claude/tests/test_extract_data_model.py +0 -33
  545. package/.claude/tests/test_generate_quickstart.py +0 -50
  546. package/.claude/tests/test_generate_research_tasks.py +0 -52
  547. package/.claude/tsc-cache/70d2fc6d-2936-429b-b529-429f1aae8c88/affected-repos.txt +0 -1
  548. package/.claude/tsc-cache/70d2fc6d-2936-429b-b529-429f1aae8c88/edited-files.log +0 -2
  549. package/bin/harness.js +0 -22
  550. package/docs/commands/core-roadmap.md +0 -106
  551. package/docs/commands/core-roadmap.zh-CN.md +0 -102
  552. package/docs/commands/core-style.md +0 -53
  553. package/docs/commands/core-style.zh-CN.md +0 -53
  554. package/docs/commands/flow-init.md +0 -140
  555. package/docs/commands/flow-init.zh-CN.md +0 -169
  556. package/docs/commands/flow-new.md +0 -39
  557. package/docs/commands/flow-new.zh-CN.md +0 -39
  558. package/lib/compiler/__tests__/compile-regression.test.js +0 -103
  559. package/lib/compiler/__tests__/multi-module-emitters.test.js +0 -534
  560. package/lib/compiler/__tests__/resource-copier.test.js +0 -26
  561. package/lib/compiler/__tests__/skill-discovery.test.js +0 -72
  562. package/lib/compiler/context-expander.js +0 -179
  563. package/lib/compiler/rules-emitters/__tests__/codex-rules-emitter.test.js +0 -109
  564. package/lib/compiler/rules-emitters/codex-rules-emitter.js +0 -116
  565. package/lib/compiler/skill-discovery.js +0 -68
  566. package/lib/harness/CLAUDE.md +0 -22
  567. package/lib/harness/__tests__/planner.tdd.test.js +0 -125
  568. package/lib/harness/cli.js +0 -208
  569. package/lib/harness/index.js +0 -18
  570. package/lib/harness/operations/dispatch.js +0 -298
  571. package/lib/harness/operations/init.js +0 -48
  572. package/lib/harness/operations/pack.js +0 -100
  573. package/lib/harness/operations/plan.js +0 -83
  574. package/lib/harness/operations/release.js +0 -170
  575. package/lib/harness/operations/resume.js +0 -44
  576. package/lib/harness/operations/verify.js +0 -177
  577. package/lib/harness/planner.js +0 -272
  578. package/lib/harness/query.js +0 -126
  579. 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