cc-devflow 4.2.0 → 4.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (559) hide show
  1. package/.claude/skills/cc-act/CHANGELOG.md +64 -0
  2. package/.claude/skills/cc-act/PLAYBOOK.md +212 -0
  3. package/.claude/skills/cc-act/SKILL.md +322 -0
  4. package/.claude/skills/cc-act/assets/PR_BRIEF_TEMPLATE.md +64 -0
  5. package/.claude/skills/cc-act/assets/RELEASE_NOTE_TEMPLATE.md +25 -0
  6. package/.claude/skills/cc-act/references/closure-contract.md +49 -0
  7. package/.claude/skills/cc-act/references/git-commit-guidelines.md +83 -0
  8. package/.claude/skills/cc-act/scripts/archive-requirement.sh +49 -0
  9. package/.claude/skills/cc-act/scripts/cc-act-common.sh +240 -0
  10. package/.claude/skills/cc-act/scripts/detect-ship-target.sh +82 -0
  11. package/.claude/skills/cc-act/scripts/generate-status-report.sh +83 -0
  12. package/.claude/skills/cc-act/scripts/render-pr-brief.sh +195 -0
  13. package/.claude/skills/cc-act/scripts/sync-act-docs.sh +315 -0
  14. package/.claude/skills/cc-act/scripts/verify-act-gate.sh +63 -0
  15. package/.claude/skills/cc-check/CHANGELOG.md +73 -0
  16. package/.claude/skills/cc-check/PLAYBOOK.md +153 -0
  17. package/.claude/skills/cc-check/SKILL.md +345 -0
  18. package/.claude/skills/cc-check/assets/REPORT_CARD_TEMPLATE.json +50 -0
  19. package/.claude/skills/cc-check/references/gate-contract.md +29 -0
  20. package/.claude/skills/cc-check/references/review-contract.md +45 -0
  21. package/.claude/skills/cc-check/scripts/render-report-card.js +229 -0
  22. package/.claude/skills/cc-check/scripts/run-quality-gates.sh +86 -0
  23. package/.claude/skills/cc-check/scripts/verify-gate.sh +57 -0
  24. package/.claude/skills/cc-do/CHANGELOG.md +49 -0
  25. package/.claude/skills/cc-do/PLAYBOOK.md +119 -0
  26. package/.claude/skills/cc-do/SKILL.md +216 -0
  27. package/.claude/skills/cc-do/references/execution-recovery.md +86 -0
  28. package/.claude/skills/cc-do/references/parallel-dispatch.md +80 -0
  29. package/.claude/skills/cc-do/scripts/build-task-context.sh +184 -0
  30. package/.claude/skills/cc-do/scripts/cc-do-common.sh +79 -0
  31. package/.claude/skills/cc-do/scripts/check-task-status.sh +92 -0
  32. package/.claude/skills/cc-do/scripts/detect-file-conflicts.sh +87 -0
  33. package/.claude/skills/cc-do/scripts/mark-task-complete.sh +119 -0
  34. package/.claude/skills/cc-do/scripts/record-review-decision.sh +89 -0
  35. package/.claude/skills/cc-do/scripts/recover-workflow.sh +84 -0
  36. package/.claude/skills/cc-do/scripts/run-problem-analysis.sh +70 -0
  37. package/.claude/skills/cc-do/scripts/select-ready-tasks.sh +135 -0
  38. package/.claude/skills/cc-do/scripts/verify-task-gates.sh +94 -0
  39. package/.claude/skills/cc-do/scripts/write-task-checkpoint.sh +102 -0
  40. package/.claude/skills/cc-investigate/CHANGELOG.md +26 -0
  41. package/.claude/skills/cc-investigate/PLAYBOOK.md +49 -0
  42. package/.claude/skills/cc-investigate/SKILL.md +221 -0
  43. package/.claude/skills/cc-investigate/assets/ANALYSIS_TEMPLATE.md +55 -0
  44. package/.claude/skills/cc-investigate/assets/TASKS_TEMPLATE.md +52 -0
  45. package/.claude/skills/cc-investigate/assets/TASK_MANIFEST_TEMPLATE.json +103 -0
  46. package/.claude/skills/cc-investigate/references/investigation-contract.md +28 -0
  47. package/.claude/skills/cc-investigate/scripts/bootstrap-analysis.sh +38 -0
  48. package/.claude/skills/cc-plan/CHANGELOG.md +99 -0
  49. package/.claude/skills/cc-plan/PLAYBOOK.md +106 -0
  50. package/.claude/skills/cc-plan/SKILL.md +325 -0
  51. package/.claude/skills/cc-plan/assets/DESIGN_TEMPLATE.md +155 -0
  52. package/.claude/skills/cc-plan/assets/TASKS_TEMPLATE.md +98 -0
  53. package/.claude/skills/cc-plan/assets/TASK_MANIFEST_TEMPLATE.json +108 -0
  54. package/.claude/skills/cc-plan/assets/TINY_DESIGN_TEMPLATE.md +79 -0
  55. package/.claude/skills/cc-plan/references/planning-contract.md +82 -0
  56. package/.claude/skills/cc-plan/scripts/bump-skill-version.sh +103 -0
  57. package/.claude/skills/cc-plan/scripts/parse-task-dependencies.js +75 -0
  58. package/.claude/skills/cc-plan/scripts/validate-scope.sh +78 -0
  59. package/.claude/skills/cc-roadmap/CHANGELOG.md +114 -0
  60. package/.claude/skills/cc-roadmap/PLAYBOOK.md +136 -0
  61. package/.claude/skills/cc-roadmap/SKILL.md +259 -0
  62. package/.claude/skills/cc-roadmap/assets/BACKLOG_TEMPLATE.md +45 -0
  63. package/.claude/skills/cc-roadmap/assets/ROADMAP_TEMPLATE.md +153 -0
  64. package/.claude/skills/cc-roadmap/assets/TRACKING_TEMPLATE.json +48 -0
  65. package/.claude/skills/cc-roadmap/references/roadmap-dialogue.md +37 -0
  66. package/.claude/skills/cc-roadmap/scripts/bump-skill-version.sh +103 -0
  67. package/.claude/skills/cc-roadmap/scripts/lib/roadmap-tracking/markdown.js +604 -0
  68. package/.claude/skills/cc-roadmap/scripts/lib/roadmap-tracking/query.js +63 -0
  69. package/.claude/skills/cc-roadmap/scripts/lib/roadmap-tracking/schema.js +245 -0
  70. package/.claude/skills/cc-roadmap/scripts/lib/roadmap-tracking/store.js +139 -0
  71. package/.claude/skills/cc-roadmap/scripts/locate-roadmap-item.sh +109 -0
  72. package/.claude/skills/cc-roadmap/scripts/roadmap-tracking.js +153 -0
  73. package/.claude/skills/cc-roadmap/scripts/sync-roadmap-progress.sh +100 -0
  74. package/.claude/skills/cc-simplify/CHANGELOG.md +10 -0
  75. package/.claude/skills/cc-simplify/SKILL.md +55 -0
  76. package/.claude/skills/cc-spec-init/CHANGELOG.md +7 -0
  77. package/.claude/skills/cc-spec-init/PLAYBOOK.md +55 -0
  78. package/.claude/skills/cc-spec-init/SKILL.md +127 -0
  79. package/.claude/skills/cc-spec-init/assets/CAPABILITY_TEMPLATE.md +63 -0
  80. package/.claude/skills/cc-spec-init/assets/CHANGE_META_TEMPLATE.json +25 -0
  81. package/.claude/skills/cc-spec-init/assets/INDEX_TEMPLATE.md +34 -0
  82. package/.claude/skills/cc-spec-init/references/spec-contract.md +22 -0
  83. package/.claude/skills/cc-spec-init/scripts/bootstrap-specs.sh +31 -0
  84. package/.claude/skills/cc-spec-init/scripts/validate-spec-links.sh +45 -0
  85. package/CHANGELOG.md +101 -4
  86. package/README.md +120 -755
  87. package/README.zh-CN.md +119 -755
  88. package/bin/adapt.js +2 -6
  89. package/bin/cc-devflow-cli.js +72 -177
  90. package/config/distributable-skills.json +24 -0
  91. package/docs/CLAUDE.md +10 -6
  92. package/docs/commands/README.md +19 -46
  93. package/docs/commands/README.zh-CN.md +25 -48
  94. package/docs/examples/BY-ARTIFACT.md +7 -0
  95. package/docs/examples/README.md +38 -0
  96. package/docs/examples/START-HERE.md +149 -0
  97. package/docs/examples/example-bindings.json +38 -0
  98. package/docs/examples/full-design-blocked/BACKLOG.md +45 -0
  99. package/docs/examples/full-design-blocked/README.md +55 -0
  100. package/docs/examples/full-design-blocked/ROADMAP.md +53 -0
  101. package/docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/planning/design.md +154 -0
  102. package/docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/planning/task-manifest.json +146 -0
  103. package/docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/planning/tasks.md +78 -0
  104. package/docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/review/report-card.json +52 -0
  105. package/docs/examples/full-design-blocked/roadmap-tracking.json +50 -0
  106. package/docs/examples/local-handoff/BACKLOG.md +45 -0
  107. package/docs/examples/local-handoff/README.md +56 -0
  108. package/docs/examples/local-handoff/ROADMAP.md +45 -0
  109. package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/handoff/resume-index.md +39 -0
  110. package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/handoff/status.md +29 -0
  111. package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/planning/design.md +71 -0
  112. package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/planning/task-manifest.json +98 -0
  113. package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/planning/tasks.md +59 -0
  114. package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/review/report-card.json +44 -0
  115. package/docs/examples/local-handoff/roadmap-tracking.json +48 -0
  116. package/docs/examples/pdca-loop/BACKLOG.md +46 -0
  117. package/docs/examples/pdca-loop/README.md +58 -0
  118. package/docs/examples/pdca-loop/ROADMAP.md +133 -0
  119. package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/handoff/pr-brief.md +72 -0
  120. package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/handoff/status.md +29 -0
  121. package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/design.md +72 -0
  122. package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/task-manifest.json +201 -0
  123. package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/tasks.md +73 -0
  124. package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/review/report-card.json +44 -0
  125. package/docs/examples/pdca-loop/roadmap-tracking.json +114 -0
  126. package/docs/examples/scripts/check-example-bindings.sh +116 -0
  127. package/docs/guides/getting-started.md +94 -129
  128. package/docs/guides/getting-started.zh-CN.md +103 -84
  129. package/docs/skill-runtime-migration.md +46 -0
  130. package/docs/v4.3.0-migration-guide.md +111 -0
  131. package/lib/compiler/CLAUDE.md +55 -84
  132. package/lib/compiler/__tests__/drift.test.js +1 -1
  133. package/lib/compiler/__tests__/errors.test.js +0 -1
  134. package/lib/compiler/__tests__/integration.test.js +49 -3
  135. package/lib/compiler/__tests__/manifest.test.js +0 -156
  136. package/lib/compiler/__tests__/parser.test.js +33 -104
  137. package/lib/compiler/__tests__/schemas.test.js +30 -34
  138. package/lib/compiler/__tests__/skills-registry.test.js +114 -0
  139. package/lib/compiler/__tests__/transformer.test.js +5 -9
  140. package/lib/compiler/emitters/antigravity-emitter.js +5 -213
  141. package/lib/compiler/emitters/base-emitter.js +3 -298
  142. package/lib/compiler/emitters/codex-emitter.js +4 -202
  143. package/lib/compiler/emitters/cursor-emitter.js +3 -287
  144. package/lib/compiler/emitters/qwen-emitter.js +4 -176
  145. package/lib/compiler/index.js +65 -345
  146. package/lib/compiler/manifest.js +6 -68
  147. package/lib/compiler/parser.js +31 -63
  148. package/lib/compiler/platforms.js +32 -277
  149. package/lib/compiler/resource-copier.js +176 -6
  150. package/lib/compiler/rules-emitters/__tests__/antigravity-rules-emitter.test.js +3 -3
  151. package/lib/compiler/rules-emitters/__tests__/cursor-rules-emitter.test.js +14 -4
  152. package/lib/compiler/rules-emitters/__tests__/qwen-rules-emitter.test.js +16 -7
  153. package/lib/compiler/rules-emitters/antigravity-rules-emitter.js +10 -15
  154. package/lib/compiler/rules-emitters/base-rules-emitter.js +5 -5
  155. package/lib/compiler/rules-emitters/cursor-rules-emitter.js +7 -12
  156. package/lib/compiler/rules-emitters/index.js +6 -3
  157. package/lib/compiler/rules-emitters/qwen-rules-emitter.js +7 -7
  158. package/lib/compiler/schemas.js +8 -4
  159. package/lib/compiler/skills-registry.js +213 -15
  160. package/lib/compiler/transformer.js +1 -1
  161. package/lib/skill-runtime/CLAUDE.md +19 -0
  162. package/lib/skill-runtime/__tests__/autopilot.test.js +210 -0
  163. package/lib/skill-runtime/__tests__/cli-bootstrap.integration.test.js +181 -0
  164. package/lib/skill-runtime/__tests__/delegation.test.js +97 -0
  165. package/lib/skill-runtime/__tests__/dispatch.test.js +267 -0
  166. package/lib/skill-runtime/__tests__/intent.test.js +219 -0
  167. package/lib/skill-runtime/__tests__/lifecycle.test.js +169 -0
  168. package/lib/skill-runtime/__tests__/paths.test.js +42 -0
  169. package/lib/skill-runtime/__tests__/planner.tdd.test.js +250 -0
  170. package/lib/skill-runtime/__tests__/prepare-pr.test.js +139 -0
  171. package/lib/skill-runtime/__tests__/query.test.js +284 -0
  172. package/lib/skill-runtime/__tests__/runtime.integration.test.js +279 -0
  173. package/lib/skill-runtime/__tests__/schemas.test.js +207 -0
  174. package/lib/skill-runtime/__tests__/team-state.test.js +51 -0
  175. package/lib/skill-runtime/__tests__/worker-run.test.js +253 -0
  176. package/lib/skill-runtime/__tests__/worker.test.js +56 -0
  177. package/lib/skill-runtime/artifacts.js +93 -0
  178. package/lib/skill-runtime/delegation.js +533 -0
  179. package/lib/skill-runtime/index.js +34 -0
  180. package/lib/skill-runtime/intent.js +333 -0
  181. package/lib/skill-runtime/lifecycle.js +294 -0
  182. package/lib/skill-runtime/operations/CLAUDE.md +19 -0
  183. package/lib/skill-runtime/operations/approve.js +66 -0
  184. package/lib/skill-runtime/operations/autopilot-core.js +337 -0
  185. package/lib/skill-runtime/operations/autopilot-execution.js +307 -0
  186. package/lib/skill-runtime/operations/autopilot-shared.js +48 -0
  187. package/lib/skill-runtime/operations/autopilot.js +163 -0
  188. package/lib/skill-runtime/operations/dispatch.js +454 -0
  189. package/lib/skill-runtime/operations/init.js +64 -0
  190. package/lib/{harness → skill-runtime}/operations/janitor.js +9 -6
  191. package/lib/skill-runtime/operations/plan.js +59 -0
  192. package/lib/skill-runtime/operations/prepare-pr.js +25 -0
  193. package/lib/{harness → skill-runtime}/operations/release.js +18 -5
  194. package/lib/skill-runtime/operations/resume.js +143 -0
  195. package/lib/skill-runtime/operations/snapshot.js +45 -0
  196. package/lib/skill-runtime/operations/verify.js +170 -0
  197. package/lib/skill-runtime/operations/worker-run.js +529 -0
  198. package/lib/skill-runtime/operations/worker.js +33 -0
  199. package/lib/skill-runtime/paths.js +213 -0
  200. package/lib/skill-runtime/planner.js +519 -0
  201. package/lib/skill-runtime/query.js +157 -0
  202. package/lib/skill-runtime/review.js +557 -0
  203. package/lib/skill-runtime/schemas.js +400 -0
  204. package/lib/{harness → skill-runtime}/store.js +45 -30
  205. package/lib/skill-runtime/team-state.js +122 -0
  206. package/package.json +13 -11
  207. package/.claude/CLAUDE.md +0 -125
  208. package/.claude/agents/architecture-designer.md +0 -443
  209. package/.claude/agents/bug-analyzer.md +0 -381
  210. package/.claude/agents/checklist-agent.md +0 -175
  211. package/.claude/agents/clarify-analyst.md +0 -50
  212. package/.claude/agents/code-quality-reviewer.md +0 -205
  213. package/.claude/agents/code-reviewer.md +0 -71
  214. package/.claude/agents/codex-analyzer.md +0 -39
  215. package/.claude/agents/compatibility-checker.md +0 -579
  216. package/.claude/agents/consistency-checker.md +0 -532
  217. package/.claude/agents/dev-implementer.md +0 -195
  218. package/.claude/agents/flow-researcher.md +0 -132
  219. package/.claude/agents/impact-analyzer.md +0 -440
  220. package/.claude/agents/planner.md +0 -230
  221. package/.claude/agents/prd-writer.md +0 -320
  222. package/.claude/agents/project-guidelines-generator.md +0 -1329
  223. package/.claude/agents/qa-tester.md +0 -313
  224. package/.claude/agents/release-manager.md +0 -295
  225. package/.claude/agents/security-reviewer.md +0 -314
  226. package/.claude/agents/spec-reviewer.md +0 -221
  227. package/.claude/agents/style-guide-generator.md +0 -458
  228. package/.claude/agents/tech-architect.md +0 -516
  229. package/.claude/agents/ui-designer.md +0 -485
  230. package/.claude/commands/core/architecture.md +0 -459
  231. package/.claude/commands/core/guidelines.md +0 -511
  232. package/.claude/commands/core/roadmap.md +0 -468
  233. package/.claude/commands/core/style.md +0 -83
  234. package/.claude/commands/flow/CLAUDE.md +0 -28
  235. package/.claude/commands/flow/archive.md +0 -280
  236. package/.claude/commands/flow/checklist.md +0 -18
  237. package/.claude/commands/flow/clarify.md +0 -18
  238. package/.claude/commands/flow/constitution.md +0 -82
  239. package/.claude/commands/flow/context.md +0 -150
  240. package/.claude/commands/flow/delta.md +0 -245
  241. package/.claude/commands/flow/dev.md +0 -40
  242. package/.claude/commands/flow/fix.md +0 -217
  243. package/.claude/commands/flow/ideate.md +0 -214
  244. package/.claude/commands/flow/init.md +0 -38
  245. package/.claude/commands/flow/new.md +0 -23
  246. package/.claude/commands/flow/quality.md +0 -21
  247. package/.claude/commands/flow/release.md +0 -36
  248. package/.claude/commands/flow/restart.md +0 -97
  249. package/.claude/commands/flow/spec.md +0 -36
  250. package/.claude/commands/flow/status.md +0 -64
  251. package/.claude/commands/flow/update.md +0 -111
  252. package/.claude/commands/flow/upgrade.md +0 -115
  253. package/.claude/commands/flow/verify.md +0 -37
  254. package/.claude/commands/flow/workspace.md +0 -155
  255. package/.claude/commands/util/cancel-ralph.md +0 -60
  256. package/.claude/commands/util/code-review.md +0 -58
  257. package/.claude/commands/util/git-commit.md +0 -422
  258. package/.claude/commands/util/problem-analyzer.md +0 -60
  259. package/.claude/config/quality-gates.yml +0 -305
  260. package/.claude/config/quality-rules.yml +0 -161
  261. package/.claude/docs/SPEC_KIT_CONSTITUTION_ANALYSIS.md +0 -426
  262. package/.claude/docs/design/consistency-conflict-detection-algorithms.md +0 -658
  263. package/.claude/docs/design/intent-driven-input-design.md +0 -380
  264. package/.claude/docs/design/prd-version-management-design.md +0 -437
  265. package/.claude/docs/guides/INIT_TROUBLESHOOTING.md +0 -117
  266. package/.claude/docs/guides/NEW_TROUBLESHOOTING.md +0 -99
  267. package/.claude/docs/guides/ROADMAP_TROUBLESHOOTING.md +0 -188
  268. package/.claude/docs/guides/TASK_COMPLETION_MARKING.md +0 -338
  269. package/.claude/docs/guides/TEAM_MODE_GUIDE.md +0 -312
  270. package/.claude/docs/templates/ARCHITECTURE_TEMPLATE.md +0 -633
  271. package/.claude/docs/templates/ATTEMPT_TEMPLATE.md +0 -156
  272. package/.claude/docs/templates/BACKLOG_TEMPLATE.md +0 -261
  273. package/.claude/docs/templates/BRAINSTORM_TEMPLATE.md +0 -148
  274. package/.claude/docs/templates/CHECKLIST_TEMPLATE.md +0 -52
  275. package/.claude/docs/templates/CLARIFICATION_REPORT_TEMPLATE.md +0 -206
  276. package/.claude/docs/templates/CODE_REVIEW_TEMPLATE.md +0 -71
  277. package/.claude/docs/templates/DELTA_SPEC_TEMPLATE.md +0 -91
  278. package/.claude/docs/templates/DESIGN_DECISIONS_TEMPLATE.md +0 -151
  279. package/.claude/docs/templates/EPIC_TEMPLATE.md +0 -805
  280. package/.claude/docs/templates/ERROR_LOG_TEMPLATE.md +0 -80
  281. package/.claude/docs/templates/INIT_FLOW_TEMPLATE.md +0 -198
  282. package/.claude/docs/templates/INTENT_CLARIFICATION_TEMPLATE.md +0 -57
  283. package/.claude/docs/templates/JOURNAL_TEMPLATE.md +0 -75
  284. package/.claude/docs/templates/NEW_ORCHESTRATION_TEMPLATE.md +0 -76
  285. package/.claude/docs/templates/PRD_TEMPLATE.md +0 -562
  286. package/.claude/docs/templates/RESEARCH_TEMPLATE.md +0 -276
  287. package/.claude/docs/templates/REVIEW-HIGH.md +0 -57
  288. package/.claude/docs/templates/ROADMAP_DIALOGUE_TEMPLATE.md +0 -198
  289. package/.claude/docs/templates/ROADMAP_TEMPLATE.md +0 -310
  290. package/.claude/docs/templates/STYLE_TEMPLATE.md +0 -1266
  291. package/.claude/docs/templates/TASKS_TEMPLATE.md +0 -523
  292. package/.claude/docs/templates/TECH_DESIGN_TEMPLATE.md +0 -1019
  293. package/.claude/docs/templates/UI_PROTOTYPE_TEMPLATE.md +0 -1435
  294. package/.claude/docs/templates/_shared/CLAUDE.md +0 -36
  295. package/.claude/docs/templates/_shared/CONSTITUTION_CHECK.md +0 -125
  296. package/.claude/docs/templates/_shared/VALIDATION_CHECKLIST.md +0 -187
  297. package/.claude/docs/templates/_shared/YAML_FRONTMATTER.md +0 -164
  298. package/.claude/docs/templates/context/dev.jsonl.template +0 -6
  299. package/.claude/docs/templates/context/epic.jsonl.template +0 -5
  300. package/.claude/docs/templates/context/prd.jsonl.template +0 -4
  301. package/.claude/docs/templates/context/research.jsonl.template +0 -4
  302. package/.claude/docs/templates/context/review.jsonl.template +0 -5
  303. package/.claude/docs/templates/context/tech.jsonl.template +0 -5
  304. package/.claude/guides/agent-guides/agent-coordination-guide.md +0 -459
  305. package/.claude/guides/project-guidelines-system.md +0 -463
  306. package/.claude/guides/technical-guides/datetime-handling-guide.md +0 -563
  307. package/.claude/guides/technical-guides/git-github-guide.md +0 -642
  308. package/.claude/guides/technical-guides/test-execution-guide.md +0 -618
  309. package/.claude/guides/workflow-guides/bug-fix-orchestrator.md +0 -217
  310. package/.claude/guides/workflow-guides/flow-orchestrator.md +0 -48
  311. package/.claude/hooks/CLAUDE.md +0 -342
  312. package/.claude/hooks/checklist-gate.js +0 -397
  313. package/.claude/hooks/error-handling-reminder.sh +0 -12
  314. package/.claude/hooks/error-handling-reminder.ts +0 -459
  315. package/.claude/hooks/hooks.json +0 -15
  316. package/.claude/hooks/inject-agent-context.ts +0 -480
  317. package/.claude/hooks/inject-skill-context.ts +0 -359
  318. package/.claude/hooks/post-tool-use-tracker.sh +0 -280
  319. package/.claude/hooks/pre-tool-use-guardrail.sh +0 -36
  320. package/.claude/hooks/pre-tool-use-guardrail.ts +0 -342
  321. package/.claude/hooks/ralph-loop.ts +0 -931
  322. package/.claude/hooks/ralph-stop-hook.sh +0 -190
  323. package/.claude/hooks/skill-activation-prompt.sh +0 -36
  324. package/.claude/hooks/skill-activation-prompt.ts +0 -214
  325. package/.claude/hooks/state/skills-used-test-guard.json +0 -3
  326. package/.claude/hooks/task-completed-hook.ts +0 -593
  327. package/.claude/hooks/teammate-idle-hook.ts +0 -690
  328. package/.claude/hooks/types/team-types.d.ts +0 -238
  329. package/.claude/rules/devflow-conventions.md +0 -286
  330. package/.claude/rules/project-constitution.md +0 -1002
  331. package/.claude/rules/rationalization-library.md +0 -282
  332. package/.claude/schemas/constitution.schema.json +0 -43
  333. package/.claude/scripts/CLAUDE.md +0 -76
  334. package/.claude/scripts/analyze-upgrade-impact.sh +0 -200
  335. package/.claude/scripts/archive-requirement.sh +0 -394
  336. package/.claude/scripts/calculate-checklist-completion.sh +0 -243
  337. package/.claude/scripts/calculate-quarter.sh +0 -206
  338. package/.claude/scripts/check-dependencies.sh +0 -409
  339. package/.claude/scripts/check-prerequisites.sh +0 -232
  340. package/.claude/scripts/check-task-status.sh +0 -288
  341. package/.claude/scripts/checklist-errors.sh +0 -131
  342. package/.claude/scripts/common.sh +0 -1102
  343. package/.claude/scripts/consolidate-research.sh +0 -182
  344. package/.claude/scripts/create-requirement.sh +0 -451
  345. package/.claude/scripts/delta-parser.ts +0 -527
  346. package/.claude/scripts/detect-file-conflicts.sh +0 -151
  347. package/.claude/scripts/export-contracts.sh +0 -117
  348. package/.claude/scripts/extract-data-model.sh +0 -78
  349. package/.claude/scripts/flow-context-add.sh +0 -134
  350. package/.claude/scripts/flow-context-init.sh +0 -133
  351. package/.claude/scripts/flow-context-validate.sh +0 -144
  352. package/.claude/scripts/flow-delta-apply.sh +0 -297
  353. package/.claude/scripts/flow-delta-archive.sh +0 -71
  354. package/.claude/scripts/flow-delta-create.sh +0 -202
  355. package/.claude/scripts/flow-delta-list.sh +0 -142
  356. package/.claude/scripts/flow-delta-status.sh +0 -235
  357. package/.claude/scripts/flow-quality-full.sh +0 -215
  358. package/.claude/scripts/flow-quality-quick.sh +0 -119
  359. package/.claude/scripts/flow-workspace-init.sh +0 -117
  360. package/.claude/scripts/flow-workspace-record.sh +0 -164
  361. package/.claude/scripts/generate-clarification-questions.sh +0 -377
  362. package/.claude/scripts/generate-clarification-report.sh +0 -463
  363. package/.claude/scripts/generate-quickstart.sh +0 -146
  364. package/.claude/scripts/generate-research-tasks.sh +0 -157
  365. package/.claude/scripts/generate-status-report.sh +0 -523
  366. package/.claude/scripts/generate-tech-analysis.sh +0 -46
  367. package/.claude/scripts/get-workflow-status.sh +0 -415
  368. package/.claude/scripts/locate-requirement-in-roadmap.sh +0 -233
  369. package/.claude/scripts/manage-constitution.sh +0 -602
  370. package/.claude/scripts/mark-task-complete.sh +0 -198
  371. package/.claude/scripts/parse-task-dependencies.js +0 -334
  372. package/.claude/scripts/populate-research-tasks.sh +0 -284
  373. package/.claude/scripts/record-quality-error.sh +0 -165
  374. package/.claude/scripts/recover-workflow.sh +0 -463
  375. package/.claude/scripts/run-clarify-scan.sh +0 -601
  376. package/.claude/scripts/run-high-review.sh +0 -62
  377. package/.claude/scripts/run-problem-analysis.sh +0 -68
  378. package/.claude/scripts/run-quality-gates.sh +0 -242
  379. package/.claude/scripts/setup-epic.sh +0 -173
  380. package/.claude/scripts/setup-ralph-loop.sh +0 -155
  381. package/.claude/scripts/sync-roadmap-progress.sh +0 -300
  382. package/.claude/scripts/sync-task-marks.sh +0 -199
  383. package/.claude/scripts/team-dev-init.sh +0 -319
  384. package/.claude/scripts/team-state-recovery.sh +0 -229
  385. package/.claude/scripts/test-clarify-scan.sh +0 -515
  386. package/.claude/scripts/update-agent-context.sh +0 -806
  387. package/.claude/scripts/validate-constitution.sh +0 -567
  388. package/.claude/scripts/validate-hooks.sh +0 -487
  389. package/.claude/scripts/validate-research.sh +0 -332
  390. package/.claude/scripts/validate-scope-boundary.sh +0 -493
  391. package/.claude/scripts/verify-gate.sh +0 -269
  392. package/.claude/scripts/verify-setup.sh +0 -37
  393. package/.claude/scripts/workflow-status.ts +0 -433
  394. package/.claude/settings.json +0 -95
  395. package/.claude/skills/_reference-implementations/README.md +0 -96
  396. package/.claude/skills/_reference-implementations/backend-express-prisma/SKILL.md +0 -302
  397. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/architecture-overview.md +0 -451
  398. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/async-and-errors.md +0 -307
  399. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/complete-examples.md +0 -638
  400. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/configuration.md +0 -275
  401. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/database-patterns.md +0 -224
  402. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/middleware-guide.md +0 -213
  403. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/routing-and-controllers.md +0 -756
  404. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/sentry-and-monitoring.md +0 -336
  405. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/services-and-repositories.md +0 -789
  406. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/testing-guide.md +0 -235
  407. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/validation-patterns.md +0 -754
  408. package/.claude/skills/_reference-implementations/frontend-react-mui/SKILL.md +0 -399
  409. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/common-patterns.md +0 -331
  410. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/complete-examples.md +0 -872
  411. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/component-patterns.md +0 -502
  412. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/data-fetching.md +0 -767
  413. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/file-organization.md +0 -502
  414. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/loading-and-error-states.md +0 -501
  415. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/performance.md +0 -406
  416. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/routing-guide.md +0 -364
  417. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/styling-guide.md +0 -428
  418. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/typescript-standards.md +0 -418
  419. package/.claude/skills/cc-devflow-orchestrator/SKILL.md +0 -169
  420. package/.claude/skills/domain/attention-refresh/SKILL.md +0 -170
  421. package/.claude/skills/domain/brainstorming/SKILL.md +0 -161
  422. package/.claude/skills/domain/debugging/SKILL.md +0 -221
  423. package/.claude/skills/domain/finishing-branch/SKILL.md +0 -189
  424. package/.claude/skills/domain/receiving-review/SKILL.md +0 -153
  425. package/.claude/skills/domain/tdd/SKILL.md +0 -218
  426. package/.claude/skills/domain/verification/SKILL.md +0 -158
  427. package/.claude/skills/guardrail/constitution-guardian/SKILL.md +0 -306
  428. package/.claude/skills/guardrail/tdd-enforcer/SKILL.md +0 -192
  429. package/.claude/skills/skill-rules.json +0 -359
  430. package/.claude/skills/utility/constitution-quick-ref/SKILL.md +0 -374
  431. package/.claude/skills/utility/file-standards/SKILL.md +0 -353
  432. package/.claude/skills/utility/fractal-docs/SKILL.md +0 -45
  433. package/.claude/skills/utility/journey-checker/SKILL.md +0 -199
  434. package/.claude/skills/utility/journey-checker/pressure-scenarios.md +0 -164
  435. package/.claude/skills/utility/npm-release/SKILL.md +0 -314
  436. package/.claude/skills/utility/skill-creator/LICENSE.txt +0 -202
  437. package/.claude/skills/utility/skill-creator/SKILL.md +0 -356
  438. package/.claude/skills/utility/skill-creator/references/output-patterns.md +0 -82
  439. package/.claude/skills/utility/skill-creator/references/workflows.md +0 -28
  440. package/.claude/skills/utility/skill-creator/scripts/init_skill.py +0 -303
  441. package/.claude/skills/utility/skill-creator/scripts/package_skill.py +0 -110
  442. package/.claude/skills/utility/skill-creator/scripts/quick_validate.py +0 -95
  443. package/.claude/skills/workflow/CLAUDE.md +0 -24
  444. package/.claude/skills/workflow/flow-dev/CLAUDE.md +0 -16
  445. package/.claude/skills/workflow/flow-dev/SKILL.md +0 -94
  446. package/.claude/skills/workflow/flow-dev/assets/IMPLEMENTATION_PLAN_TEMPLATE.md +0 -71
  447. package/.claude/skills/workflow/flow-dev/context.jsonl +0 -4
  448. package/.claude/skills/workflow/flow-dev/dev-implementer.jsonl +0 -8
  449. package/.claude/skills/workflow/flow-dev/scripts/entry-gate.sh +0 -116
  450. package/.claude/skills/workflow/flow-dev/scripts/exit-gate.sh +0 -101
  451. package/.claude/skills/workflow/flow-dev/scripts/task-orchestrator.sh +0 -106
  452. package/.claude/skills/workflow/flow-fix/SKILL.md +0 -105
  453. package/.claude/skills/workflow/flow-fix/context.jsonl +0 -6
  454. package/.claude/skills/workflow/flow-fix/references/bug-analyzer.md +0 -381
  455. package/.claude/skills/workflow/flow-init/SKILL.md +0 -84
  456. package/.claude/skills/workflow/flow-init/assets/BRAINSTORM_TEMPLATE.md +0 -148
  457. package/.claude/skills/workflow/flow-init/assets/INIT_FLOW_TEMPLATE.md +0 -198
  458. package/.claude/skills/workflow/flow-init/assets/RESEARCH_TEMPLATE.md +0 -276
  459. package/.claude/skills/workflow/flow-init/context.jsonl +0 -5
  460. package/.claude/skills/workflow/flow-init/references/flow-researcher.md +0 -132
  461. package/.claude/skills/workflow/flow-init/scripts/check-prerequisites.sh +0 -240
  462. package/.claude/skills/workflow/flow-init/scripts/consolidate-research.sh +0 -182
  463. package/.claude/skills/workflow/flow-init/scripts/create-requirement.sh +0 -404
  464. package/.claude/skills/workflow/flow-init/scripts/generate-research-tasks.sh +0 -157
  465. package/.claude/skills/workflow/flow-init/scripts/populate-research-tasks.sh +0 -284
  466. package/.claude/skills/workflow/flow-init/scripts/validate-research.sh +0 -340
  467. package/.claude/skills/workflow/flow-quality/SKILL.md +0 -98
  468. package/.claude/skills/workflow/flow-quality/context.jsonl +0 -6
  469. package/.claude/skills/workflow/flow-quality/references/code-quality-reviewer.md +0 -205
  470. package/.claude/skills/workflow/flow-quality/references/qa-tester.md +0 -313
  471. package/.claude/skills/workflow/flow-quality/references/security-reviewer.md +0 -314
  472. package/.claude/skills/workflow/flow-quality/references/spec-reviewer.md +0 -221
  473. package/.claude/skills/workflow/flow-release/SKILL.md +0 -49
  474. package/.claude/skills/workflow/flow-release/context.jsonl +0 -5
  475. package/.claude/skills/workflow/flow-release/references/release-manager.md +0 -295
  476. package/.claude/skills/workflow/flow-spec/CLAUDE.md +0 -17
  477. package/.claude/skills/workflow/flow-spec/SKILL.md +0 -74
  478. package/.claude/skills/workflow/flow-spec/context.jsonl +0 -5
  479. package/.claude/skills/workflow/flow-spec/scripts/entry-gate.sh +0 -194
  480. package/.claude/skills/workflow/flow-spec/scripts/exit-gate.sh +0 -244
  481. package/.claude/skills/workflow/flow-spec/scripts/parallel-orchestrator.sh +0 -205
  482. package/.claude/skills/workflow/flow-spec/scripts/team-communication.sh +0 -353
  483. package/.claude/skills/workflow/flow-spec/scripts/team-init.sh +0 -195
  484. package/.claude/skills/workflow/flow-spec/scripts/test-team-mode.sh +0 -496
  485. package/.claude/skills/workflow/flow-spec/team-config.json +0 -165
  486. package/.claude/skills/workflow/flow-verify/CLAUDE.md +0 -10
  487. package/.claude/skills/workflow/flow-verify/SKILL.md +0 -53
  488. package/.claude/skills/workflow/flow-verify/context.jsonl +0 -5
  489. package/.claude/skills/workflow.yaml +0 -219
  490. package/.claude/tests/README.md +0 -300
  491. package/.claude/tests/TODO.md +0 -69
  492. package/.claude/tests/__pycache__/test_analyze_upgrade_impact.cpython-311-pytest-7.2.2.pyc +0 -0
  493. package/.claude/tests/__pycache__/test_consolidate_research.cpython-311-pytest-7.2.2.pyc +0 -0
  494. package/.claude/tests/__pycache__/test_export_contracts.cpython-311-pytest-7.2.2.pyc +0 -0
  495. package/.claude/tests/__pycache__/test_extract_data_model.cpython-311-pytest-7.2.2.pyc +0 -0
  496. package/.claude/tests/__pycache__/test_generate_quickstart.cpython-311-pytest-7.2.2.pyc +0 -0
  497. package/.claude/tests/__pycache__/test_generate_research_tasks.cpython-311-pytest-7.2.2.pyc +0 -0
  498. package/.claude/tests/constitution/run_all_constitution_tests.sh +0 -111
  499. package/.claude/tests/constitution/test_agent_assignment.sh +0 -207
  500. package/.claude/tests/constitution/test_article_coverage.sh +0 -201
  501. package/.claude/tests/constitution/test_template_completeness.sh +0 -150
  502. package/.claude/tests/constitution/test_version_consistency.sh +0 -120
  503. package/.claude/tests/fixtures/spec_delta_full.md +0 -16
  504. package/.claude/tests/fixtures/tasks_progress_sample.md +0 -5
  505. package/.claude/tests/run-all-tests.sh +0 -229
  506. package/.claude/tests/scripts/run.sh +0 -30
  507. package/.claude/tests/scripts/test-framework.sh +0 -128
  508. package/.claude/tests/scripts/test_check_prerequisites.sh +0 -511
  509. package/.claude/tests/scripts/test_check_prerequisites.sh.bak +0 -504
  510. package/.claude/tests/scripts/test_check_prerequisites.sh.bak2 +0 -505
  511. package/.claude/tests/scripts/test_check_prerequisites.sh.bak3 +0 -506
  512. package/.claude/tests/scripts/test_check_prerequisites.sh.bak4 +0 -507
  513. package/.claude/tests/scripts/test_check_prerequisites.sh.bak5 +0 -508
  514. package/.claude/tests/scripts/test_check_task_status.sh +0 -499
  515. package/.claude/tests/scripts/test_common.sh +0 -244
  516. package/.claude/tests/scripts/test_generate_status_report.sh +0 -71
  517. package/.claude/tests/scripts/test_mark_task_complete.sh +0 -441
  518. package/.claude/tests/scripts/test_mark_task_complete.sh.backup +0 -410
  519. package/.claude/tests/scripts/test_recover_workflow.sh +0 -304
  520. package/.claude/tests/scripts/test_setup_epic.sh +0 -437
  521. package/.claude/tests/scripts/test_sync_task_marks.sh +0 -196
  522. package/.claude/tests/scripts/test_validate_constitution.sh +0 -74
  523. package/.claude/tests/scripts/test_validate_research.sh +0 -462
  524. package/.claude/tests/slugify.bats +0 -82
  525. package/.claude/tests/test-framework.sh +0 -732
  526. package/.claude/tests/test_analyze_upgrade_impact.py +0 -34
  527. package/.claude/tests/test_consolidate_research.py +0 -48
  528. package/.claude/tests/test_export_contracts.py +0 -43
  529. package/.claude/tests/test_extract_data_model.py +0 -33
  530. package/.claude/tests/test_generate_quickstart.py +0 -50
  531. package/.claude/tests/test_generate_research_tasks.py +0 -52
  532. package/bin/harness.js +0 -22
  533. package/docs/commands/core-roadmap.md +0 -106
  534. package/docs/commands/core-roadmap.zh-CN.md +0 -102
  535. package/docs/commands/core-style.md +0 -53
  536. package/docs/commands/core-style.zh-CN.md +0 -53
  537. package/docs/commands/flow-init.md +0 -140
  538. package/docs/commands/flow-init.zh-CN.md +0 -169
  539. package/docs/commands/flow-new.md +0 -39
  540. package/docs/commands/flow-new.zh-CN.md +0 -39
  541. package/lib/compiler/__tests__/compile-regression.test.js +0 -103
  542. package/lib/compiler/__tests__/multi-module-emitters.test.js +0 -534
  543. package/lib/compiler/__tests__/resource-copier.test.js +0 -26
  544. package/lib/compiler/__tests__/skill-discovery.test.js +0 -72
  545. package/lib/compiler/context-expander.js +0 -179
  546. package/lib/compiler/rules-emitters/__tests__/codex-rules-emitter.test.js +0 -109
  547. package/lib/compiler/rules-emitters/codex-rules-emitter.js +0 -116
  548. package/lib/compiler/skill-discovery.js +0 -68
  549. package/lib/harness/CLAUDE.md +0 -21
  550. package/lib/harness/cli.js +0 -208
  551. package/lib/harness/index.js +0 -16
  552. package/lib/harness/operations/dispatch.js +0 -285
  553. package/lib/harness/operations/init.js +0 -48
  554. package/lib/harness/operations/pack.js +0 -100
  555. package/lib/harness/operations/plan.js +0 -29
  556. package/lib/harness/operations/resume.js +0 -44
  557. package/lib/harness/operations/verify.js +0 -163
  558. package/lib/harness/planner.js +0 -141
  559. package/lib/harness/schemas.js +0 -108
@@ -1,232 +0,0 @@
1
- #!/usr/bin/env bash
2
-
3
- # Consolidated prerequisite checking script for cc-devflow
4
- #
5
- # This script provides unified prerequisite checking for development workflow.
6
- # Based on spec-kit design principles with cc-devflow enhancements.
7
- #
8
- # Usage: ./check-prerequisites.sh [OPTIONS]
9
- #
10
- # OPTIONS:
11
- # --json Output in JSON format
12
- # --require-epic Require EPIC.md to exist (for task generation phase)
13
- # --require-tasks Require tasks/ to exist (for implementation phase)
14
- # --include-tasks Include tasks/ in AVAILABLE_DOCS list
15
- # --paths-only Only output path variables (no validation)
16
- # --help, -h Show help message
17
- #
18
- # OUTPUTS:
19
- # JSON mode: {"REQ_ID":"...", "REQ_DIR":"...", "AVAILABLE_DOCS":["..."]}
20
- # Text mode: REQ_ID:... \n REQ_DIR:... \n AVAILABLE_DOCS: \n ✓/✗ file.md
21
- # Paths only: REPO_ROOT: ... \n REQ_ID: ... \n REQ_DIR: ... etc.
22
-
23
- set -e
24
-
25
- # Parse command line arguments
26
- JSON_MODE=false
27
- REQUIRE_EPIC=false
28
- REQUIRE_TASKS=false
29
- INCLUDE_TASKS=false
30
- PATHS_ONLY=false
31
-
32
- for arg in "$@"; do
33
- case "$arg" in
34
- --json)
35
- JSON_MODE=true
36
- ;;
37
- --require-epic)
38
- REQUIRE_EPIC=true
39
- ;;
40
- --require-tasks)
41
- REQUIRE_TASKS=true
42
- ;;
43
- --include-tasks)
44
- INCLUDE_TASKS=true
45
- ;;
46
- --paths-only)
47
- PATHS_ONLY=true
48
- ;;
49
- --help|-h)
50
- cat << 'EOF'
51
- Usage: check-prerequisites.sh [OPTIONS]
52
-
53
- Consolidated prerequisite checking for cc-devflow workflow.
54
-
55
- OPTIONS:
56
- --json Output in JSON format
57
- --require-epic Require EPIC.md to exist (for task generation phase)
58
- --require-tasks Require tasks/ to exist (for implementation phase)
59
- --include-tasks Include tasks/ in AVAILABLE_DOCS list
60
- --paths-only Only output path variables (no prerequisite validation)
61
- --help, -h Show this help message
62
-
63
- EXAMPLES:
64
- # Check planning prerequisites (PRD.md required)
65
- ./check-prerequisites.sh --json
66
-
67
- # Check task generation prerequisites (PRD.md + EPIC.md required)
68
- ./check-prerequisites.sh --json --require-epic
69
-
70
- # Check implementation prerequisites (PRD.md + EPIC.md + tasks/ required)
71
- ./check-prerequisites.sh --json --require-epic --require-tasks --include-tasks
72
-
73
- # Get requirement paths only (no validation)
74
- ./check-prerequisites.sh --paths-only
75
-
76
- EOF
77
- exit 0
78
- ;;
79
- *)
80
- echo "ERROR: Unknown option '$arg'. Use --help for usage information." >&2
81
- exit 1
82
- ;;
83
- esac
84
- done
85
-
86
- # Source common functions
87
- SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
88
- source "$SCRIPT_DIR/common.sh"
89
-
90
- # Get requirement paths
91
- eval $(get_requirement_paths)
92
-
93
- # Validate requirement ID exists
94
- if [[ -z "$REQ_ID" ]]; then
95
- echo "ERROR: No requirement ID found" >&2
96
- echo "Please ensure you are on a feature branch (feature/REQ-XXX-title)" >&2
97
- echo "Or set DEVFLOW_REQ_ID environment variable" >&2
98
- exit 1
99
- fi
100
-
101
- # Validate requirement ID format
102
- validate_req_id "$REQ_ID" || exit 1
103
-
104
- # If paths-only mode, output paths and exit (support JSON + paths-only combined)
105
- if $PATHS_ONLY; then
106
- if $JSON_MODE; then
107
- # Minimal JSON paths payload (no validation performed)
108
- printf '{"%s":"%s","%s":"%s","%s":"%s","%s":"%s","%s":"%s","%s":"%s"}\n' \
109
- "REPO_ROOT" "$REPO_ROOT" \
110
- "REQ_ID" "$REQ_ID" \
111
- "REQ_TYPE" "$REQ_TYPE" \
112
- "REQ_DIR" "$REQ_DIR" \
113
- "PRD_FILE" "$PRD_FILE" \
114
- "EPIC_FILE" "$EPIC_FILE"
115
- else
116
- echo "REPO_ROOT: $REPO_ROOT"
117
- echo "REQ_ID: $REQ_ID"
118
- echo "REQ_TYPE: $REQ_TYPE"
119
- echo "REQ_DIR: $REQ_DIR"
120
- echo "PRD_FILE: $PRD_FILE"
121
- echo "EPIC_FILE: $EPIC_FILE"
122
- fi
123
- exit 0
124
- fi
125
-
126
- # Validate required directories and files
127
- if [[ ! -d "$REQ_DIR" ]]; then
128
- echo "ERROR: Requirement directory not found: $REQ_DIR" >&2
129
- echo "Run /flow:init first to create the requirement structure." >&2
130
- exit 1
131
- fi
132
-
133
- if [[ ! -f "$PRD_FILE" ]]; then
134
- echo "ERROR: PRD.md not found in $REQ_DIR" >&2
135
- echo "Run prd-writer agent first to create the PRD." >&2
136
- exit 1
137
- fi
138
-
139
- # Check for EPIC.md if required
140
- if $REQUIRE_EPIC && [[ ! -f "$EPIC_FILE" ]]; then
141
- echo "ERROR: EPIC.md not found in $REQ_DIR" >&2
142
- echo "Run planner agent first to create the Epic." >&2
143
- exit 1
144
- fi
145
-
146
- # Check for tasks/ or TASKS.md if required
147
- # Support both tasks/ directory (old format) and TASKS.md file (new format)
148
- if $REQUIRE_TASKS; then
149
- TASKS_FILE="$REQ_DIR/TASKS.md"
150
- if [[ ! -d "$TASKS_DIR" || -z "$(ls -A "$TASKS_DIR" 2>/dev/null)" ]] && [[ ! -f "$TASKS_FILE" ]]; then
151
- echo "ERROR: Neither tasks/ directory nor TASKS.md file found in $REQ_DIR" >&2
152
- echo "Run planner agent first to create the task breakdown." >&2
153
- exit 1
154
- fi
155
- fi
156
-
157
- # Build list of available documents
158
- docs=()
159
-
160
- # Check optional docs
161
- [[ -d "$RESEARCH_DIR" && -n "$(ls -A "$RESEARCH_DIR" 2>/dev/null)" ]] && docs+=("research/")
162
- [[ -f "$TEST_PLAN_FILE" ]] && docs+=("TEST_PLAN.md")
163
- [[ -f "$SECURITY_PLAN_FILE" ]] && docs+=("SECURITY_PLAN.md")
164
- [[ -f "$TEST_REPORT_FILE" ]] && docs+=("TEST_REPORT.md")
165
- [[ -f "$SECURITY_REPORT_FILE" ]] && docs+=("SECURITY_REPORT.md")
166
- [[ -f "$RELEASE_PLAN_FILE" ]] && docs+=("RELEASE_PLAN.md")
167
- [[ -f "$LOG_FILE" ]] && docs+=("EXECUTION_LOG.md")
168
-
169
- # Include tasks/ or TASKS.md if requested and it exists
170
- # Support both tasks/ directory (old format) and TASKS.md file (new format)
171
- if $INCLUDE_TASKS; then
172
- TASKS_FILE="$REQ_DIR/TASKS.md"
173
- if [[ -d "$TASKS_DIR" && -n "$(ls -A "$TASKS_DIR" 2>/dev/null)" ]]; then
174
- docs+=("tasks/")
175
- elif [[ -f "$TASKS_FILE" ]]; then
176
- docs+=("TASKS.md")
177
- fi
178
- fi
179
-
180
- # For BUG type, check BUG-specific files
181
- if [[ "$REQ_TYPE" == "bug" ]]; then
182
- [[ -f "$ANALYSIS_FILE" ]] && docs+=("ANALYSIS.md")
183
- [[ -f "$PLAN_FILE" ]] && docs+=("PLAN.md")
184
- fi
185
-
186
- # Output results
187
- if $JSON_MODE; then
188
- # Build JSON array of documents
189
- if [[ ${#docs[@]} -eq 0 ]]; then
190
- json_docs="[]"
191
- else
192
- json_docs=$(printf '"%s",' "${docs[@]}")
193
- json_docs="[${json_docs%,}]"
194
- fi
195
-
196
- printf '{"%s":"%s","%s":"%s","%s":"%s","%s":%s}\n' \
197
- "REQ_ID" "$REQ_ID" \
198
- "REQ_TYPE" "$REQ_TYPE" \
199
- "REQ_DIR" "$REQ_DIR" \
200
- "AVAILABLE_DOCS" "$json_docs"
201
- else
202
- # Text output
203
- echo "REQ_ID: $REQ_ID"
204
- echo "REQ_TYPE: $REQ_TYPE"
205
- echo "REQ_DIR: $REQ_DIR"
206
- echo "AVAILABLE_DOCS:"
207
-
208
- # Show status of each potential document
209
- check_dir "$RESEARCH_DIR" "research/"
210
- check_file "$TEST_PLAN_FILE" "TEST_PLAN.md"
211
- check_file "$SECURITY_PLAN_FILE" "SECURITY_PLAN.md"
212
- check_file "$TEST_REPORT_FILE" "TEST_REPORT.md"
213
- check_file "$SECURITY_REPORT_FILE" "SECURITY_REPORT.md"
214
- check_file "$RELEASE_PLAN_FILE" "RELEASE_PLAN.md"
215
- check_file "$LOG_FILE" "EXECUTION_LOG.md"
216
-
217
- if $INCLUDE_TASKS; then
218
- TASKS_FILE="$REQ_DIR/TASKS.md"
219
- # Check for tasks/ directory first, fallback to TASKS.md
220
- if [[ -d "$TASKS_DIR" && -n "$(ls -A "$TASKS_DIR" 2>/dev/null)" ]]; then
221
- check_dir "$TASKS_DIR" "tasks/"
222
- else
223
- check_file "$TASKS_FILE" "TASKS.md"
224
- fi
225
- fi
226
-
227
- # BUG-specific files
228
- if [[ "$REQ_TYPE" == "bug" ]]; then
229
- check_file "$ANALYSIS_FILE" "ANALYSIS.md"
230
- check_file "$PLAN_FILE" "PLAN.md"
231
- fi
232
- fi
@@ -1,288 +0,0 @@
1
- #!/usr/bin/env bash
2
-
3
- # Check task completion status in TASKS.md
4
- #
5
- # This script checks the status of tasks in TASKS.md and provides
6
- # progress information.
7
- #
8
- # Usage: ./check-task-status.sh [TASK_ID] [OPTIONS]
9
- #
10
- # ARGUMENTS:
11
- # TASK_ID Optional specific task ID to check (e.g., T001)
12
- #
13
- # OPTIONS:
14
- # --json Output in JSON format
15
- # --verbose Show detailed task information
16
- # --help, -h Show help message
17
- #
18
- # EXAMPLES:
19
- # ./check-task-status.sh # Show overall progress
20
- # ./check-task-status.sh T001 # Check specific task
21
- # ./check-task-status.sh --json # JSON output
22
- # ./check-task-status.sh --verbose # Detailed task list
23
-
24
- set -e
25
-
26
- # Parse command line arguments
27
- TASK_ID=""
28
- JSON_MODE=false
29
- VERBOSE=false
30
-
31
- count_matches() {
32
- local pattern="$1"
33
- local file="$2"
34
- local count
35
- count=$(grep -c "$pattern" "$file" 2>/dev/null || true)
36
- count=${count//[[:space:]]/}
37
- printf '%s' "${count:-0}"
38
- }
39
-
40
- count_phase_tasks() {
41
- local header="$1"
42
- local mode="$2"
43
- local file="$3"
44
- awk -v header="$header" -v mode="$mode" '
45
- $0 ~ header {in_section=1; next}
46
- in_section && /^## / {exit}
47
- in_section {
48
- if (mode == "all" && $0 ~ /^- \[/) {count++}
49
- if (mode == "complete" && $0 ~ /^- \[x\]/) {count++}
50
- }
51
- END {print count+0}
52
- ' "$file"
53
- }
54
-
55
- while [[ $# -gt 0 ]]; do
56
- case "$1" in
57
- --json)
58
- JSON_MODE=true
59
- shift
60
- ;;
61
- --verbose|-v)
62
- VERBOSE=true
63
- shift
64
- ;;
65
- --help|-h)
66
- cat << 'EOF'
67
- Usage: check-task-status.sh [TASK_ID] [OPTIONS]
68
-
69
- Check task completion status in TASKS.md.
70
-
71
- ARGUMENTS:
72
- TASK_ID Optional specific task ID to check (e.g., T001)
73
-
74
- OPTIONS:
75
- --json Output results in JSON format
76
- --verbose, -v Show detailed task information
77
- --help, -h Show this help message
78
-
79
- EXAMPLES:
80
- # Show overall progress
81
- ./check-task-status.sh
82
-
83
- # Check specific task status
84
- ./check-task-status.sh T001
85
-
86
- # JSON output for automation
87
- ./check-task-status.sh --json
88
-
89
- # Detailed task list
90
- ./check-task-status.sh --verbose
91
-
92
- OUTPUT:
93
- - Overall progress (completed vs remaining)
94
- - Phase breakdown
95
- - Next pending task
96
- - Specific task status (if TASK_ID provided)
97
-
98
- EOF
99
- exit 0
100
- ;;
101
- -*)
102
- echo "ERROR: Unknown option '$1'. Use --help for usage information." >&2
103
- exit 1
104
- ;;
105
- *)
106
- if [[ -z "$TASK_ID" ]]; then
107
- TASK_ID="$1"
108
- else
109
- echo "ERROR: Too many arguments. Use --help for usage information." >&2
110
- exit 1
111
- fi
112
- shift
113
- ;;
114
- esac
115
- done
116
-
117
- # Normalize task ID to uppercase if provided
118
- if [[ -n "$TASK_ID" ]]; then
119
- TASK_ID=$(echo "$TASK_ID" | tr '[:lower:]' '[:upper:]')
120
-
121
- # Validate task ID format
122
- if [[ ! "$TASK_ID" =~ ^T[0-9]+$ ]]; then
123
- echo "ERROR: Invalid task ID format: $TASK_ID" >&2
124
- echo "Expected format: T001, T002, T003..." >&2
125
- exit 1
126
- fi
127
- fi
128
-
129
- # Source common functions
130
- SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
131
- source "$SCRIPT_DIR/common.sh"
132
-
133
- # Get all paths
134
- eval $(get_requirement_paths)
135
-
136
- # Validate requirement ID exists
137
- if [[ -z "$REQ_ID" ]]; then
138
- echo "ERROR: No requirement ID found" >&2
139
- echo "Please ensure you are on a feature branch (feature/REQ-XXX-title)" >&2
140
- echo "Or set DEVFLOW_REQ_ID environment variable" >&2
141
- exit 1
142
- fi
143
-
144
- # Validate requirement directory exists
145
- if [[ ! -d "$REQ_DIR" ]]; then
146
- echo "ERROR: Requirement directory not found: $REQ_DIR" >&2
147
- exit 1
148
- fi
149
-
150
- # Check for TASKS.md file
151
- TASKS_FILE="$REQ_DIR/TASKS.md"
152
- if [[ ! -f "$TASKS_FILE" ]]; then
153
- echo "ERROR: TASKS.md not found at $TASKS_FILE" >&2
154
- echo "Run planner agent first to create tasks." >&2
155
- exit 1
156
- fi
157
-
158
- # Count tasks
159
- TOTAL_INCOMPLETE=$(count_matches "^\- \[ \]" "$TASKS_FILE")
160
- TOTAL_COMPLETE=$(count_matches "^\- \[x\]" "$TASKS_FILE")
161
- TOTAL_TASKS=$((TOTAL_INCOMPLETE + TOTAL_COMPLETE))
162
-
163
- # Calculate percentage
164
- if [[ $TOTAL_TASKS -gt 0 ]]; then
165
- PERCENTAGE=$((TOTAL_COMPLETE * 100 / TOTAL_TASKS))
166
- else
167
- PERCENTAGE=0
168
- fi
169
-
170
- # If specific task requested, check its status
171
- if [[ -n "$TASK_ID" ]]; then
172
- if grep -q "^\- \[x\] .*$TASK_ID" "$TASKS_FILE"; then
173
- STATUS="complete"
174
- TASK_LINE=$(grep "^\- \[x\] .*$TASK_ID" "$TASKS_FILE" | head -1)
175
- elif grep -q "^\- \[ \] .*$TASK_ID" "$TASKS_FILE"; then
176
- STATUS="pending"
177
- TASK_LINE=$(grep "^\- \[ \] .*$TASK_ID" "$TASKS_FILE" | head -1)
178
- else
179
- STATUS="not_found"
180
- TASK_LINE=""
181
- fi
182
-
183
- if $JSON_MODE; then
184
- printf '{"task_id":"%s","status":"%s","task_line":"%s"}\n' \
185
- "$TASK_ID" "$STATUS" "$TASK_LINE"
186
- else
187
- case "$STATUS" in
188
- complete)
189
- echo "✅ Task $TASK_ID is complete"
190
- echo " $TASK_LINE"
191
- ;;
192
- pending)
193
- echo "⏳ Task $TASK_ID is pending"
194
- echo " $TASK_LINE"
195
- ;;
196
- not_found)
197
- echo "❌ Task $TASK_ID not found"
198
- exit 1
199
- ;;
200
- esac
201
- fi
202
- exit 0
203
- fi
204
-
205
- # Find next pending task
206
- NEXT_TASK=$(grep "^\- \[ \]" "$TASKS_FILE" | head -1 || echo "")
207
- if [[ -n "$NEXT_TASK" ]]; then
208
- # Extract task ID from line (matches T001, T002, etc.)
209
- NEXT_TASK_ID=$(echo "$NEXT_TASK" | grep -o 'T[0-9]\+' | head -1)
210
- else
211
- NEXT_TASK_ID=""
212
- fi
213
-
214
- # Get phase breakdown - ensure all values are clean integers
215
- if grep -q "^## Phase 1:" "$TASKS_FILE" 2>/dev/null; then
216
- PHASE_1_TOTAL=$(count_phase_tasks "^## Phase 1:" "all" "$TASKS_FILE")
217
- PHASE_1_COMPLETE=$(count_phase_tasks "^## Phase 1:" "complete" "$TASKS_FILE")
218
- else
219
- PHASE_1_TOTAL=0
220
- PHASE_1_COMPLETE=0
221
- fi
222
-
223
- if grep -q "^## Phase 2:" "$TASKS_FILE" 2>/dev/null; then
224
- PHASE_2_TOTAL=$(count_phase_tasks "^## Phase 2:" "all" "$TASKS_FILE")
225
- PHASE_2_COMPLETE=$(count_phase_tasks "^## Phase 2:" "complete" "$TASKS_FILE")
226
- else
227
- PHASE_2_TOTAL=0
228
- PHASE_2_COMPLETE=0
229
- fi
230
-
231
- if grep -q "^## Phase 3:" "$TASKS_FILE" 2>/dev/null; then
232
- PHASE_3_TOTAL=$(count_phase_tasks "^## Phase 3:" "all" "$TASKS_FILE")
233
- PHASE_3_COMPLETE=$(count_phase_tasks "^## Phase 3:" "complete" "$TASKS_FILE")
234
- else
235
- PHASE_3_TOTAL=0
236
- PHASE_3_COMPLETE=0
237
- fi
238
-
239
- # Output results
240
- if $JSON_MODE; then
241
- # JSON output
242
- printf '{"req_id":"%s","total_tasks":%d,"completed":%d,"remaining":%d,"percentage":%d,"next_task_id":"%s","phases":{"phase_1":{"total":%d,"complete":%d},"phase_2":{"total":%d,"complete":%d},"phase_3":{"total":%d,"complete":%d}}}\n' \
243
- "$REQ_ID" "$TOTAL_TASKS" "$TOTAL_COMPLETE" "$TOTAL_INCOMPLETE" "$PERCENTAGE" "$NEXT_TASK_ID" \
244
- "$PHASE_1_TOTAL" "$PHASE_1_COMPLETE" \
245
- "$PHASE_2_TOTAL" "$PHASE_2_COMPLETE" \
246
- "$PHASE_3_TOTAL" "$PHASE_3_COMPLETE"
247
- else
248
- # Human-readable output
249
- echo "Task Status for $REQ_ID"
250
- echo "════════════════════════════════════════"
251
- echo ""
252
- echo "Overall Progress:"
253
- echo " ✅ Completed: $TOTAL_COMPLETE"
254
- echo " ⏳ Remaining: $TOTAL_INCOMPLETE"
255
- echo " 📊 Progress: $PERCENTAGE%"
256
- echo ""
257
-
258
- if [[ -n "$NEXT_TASK_ID" ]]; then
259
- echo "Next Task: $NEXT_TASK_ID"
260
- echo " $NEXT_TASK"
261
- echo ""
262
- else
263
- echo "🎉 All tasks complete!"
264
- echo ""
265
- fi
266
-
267
- # Phase breakdown
268
- if [[ $PHASE_1_TOTAL -gt 0 || $PHASE_2_TOTAL -gt 0 || $PHASE_3_TOTAL -gt 0 ]]; then
269
- echo "Phase Breakdown:"
270
- if [[ $PHASE_1_TOTAL -gt 0 ]]; then
271
- echo " Phase 1 (Setup): $PHASE_1_COMPLETE / $PHASE_1_TOTAL"
272
- fi
273
- if [[ $PHASE_2_TOTAL -gt 0 ]]; then
274
- echo " Phase 2 (Tests First): $PHASE_2_COMPLETE / $PHASE_2_TOTAL"
275
- fi
276
- if [[ $PHASE_3_TOTAL -gt 0 ]]; then
277
- echo " Phase 3 (Implementation): $PHASE_3_COMPLETE / $PHASE_3_TOTAL"
278
- fi
279
- echo ""
280
- fi
281
-
282
- # Verbose mode: show all tasks
283
- if $VERBOSE; then
284
- echo "All Tasks:"
285
- echo "────────────────────────────────────────"
286
- grep "^\- \[" "$TASKS_FILE"
287
- fi
288
- fi
@@ -1,131 +0,0 @@
1
- #!/usr/bin/env bash
2
- # ============================================================================
3
- # checklist-errors.sh
4
- # ============================================================================
5
- # Error codes and messages for checklist gate and related hooks
6
- #
7
- # Usage: source this file in scripts that need checklist error handling
8
- #
9
- # Reference: TECH_DESIGN.md Section 4.4, contracts/command-interface.md Section 4
10
- # ============================================================================
11
-
12
- # ============================================================================
13
- # Error Codes
14
- # ============================================================================
15
-
16
- # PRD.md not found in requirement directory
17
- export ERR_MISSING_PRD="MISSING_PRD"
18
-
19
- # Invalid checklist type specified
20
- export ERR_INVALID_TYPE="INVALID_TYPE"
21
-
22
- # No checklists found in directory
23
- export ERR_NO_CHECKLISTS="NO_CHECKLISTS"
24
-
25
- # Checklist item ID not found
26
- export ERR_ITEM_NOT_FOUND="ITEM_NOT_FOUND"
27
-
28
- # Checklist completion below gate threshold
29
- export ERR_GATE_FAILED="GATE_FAILED"
30
-
31
- # Skip reason required but not provided
32
- export ERR_SKIP_REASON_REQUIRED="SKIP_REASON_REQUIRED"
33
-
34
- # ============================================================================
35
- # Valid Checklist Types (R001 Decision)
36
- # ============================================================================
37
- export VALID_CHECKLIST_TYPES="ux,api,security,performance,data,general"
38
-
39
- # ============================================================================
40
- # Error Message Functions
41
- # ============================================================================
42
-
43
- # Print error message to stderr
44
- # Usage: print_error "ERROR_CODE" "additional message"
45
- print_checklist_error() {
46
- local code="$1"
47
- local extra="${2:-}"
48
-
49
- case "$code" in
50
- "$ERR_MISSING_PRD")
51
- echo "ERROR: $code" >&2
52
- echo "PRD.md not found in requirement directory." >&2
53
- echo "" >&2
54
- echo "Run /flow:spec first." >&2
55
- ;;
56
- "$ERR_INVALID_TYPE")
57
- echo "ERROR: $code" >&2
58
- echo "Invalid checklist type: $extra" >&2
59
- echo "" >&2
60
- echo "Valid types: $VALID_CHECKLIST_TYPES" >&2
61
- ;;
62
- "$ERR_NO_CHECKLISTS")
63
- echo "ERROR: $code" >&2
64
- echo "No checklists found in checklists/ directory." >&2
65
- echo "" >&2
66
- echo "Run /flow:verify --strict first." >&2
67
- ;;
68
- "$ERR_ITEM_NOT_FOUND")
69
- echo "WARNING: $code" >&2
70
- echo "Checklist item not found: $extra. Skipped." >&2
71
- ;;
72
- "$ERR_GATE_FAILED")
73
- echo "ERROR: $code" >&2
74
- echo "Checklist completion $extra" >&2
75
- echo "" >&2
76
- echo "Run /flow:verify --strict to review incomplete items." >&2
77
- echo "Or use --skip-gate --reason \"your reason\" to bypass." >&2
78
- ;;
79
- "$ERR_SKIP_REASON_REQUIRED")
80
- echo "ERROR: $code" >&2
81
- echo "--reason is required when using --skip-gate" >&2
82
- echo "" >&2
83
- echo "Usage: --skip-gate --reason \"your reason\"" >&2
84
- ;;
85
- *)
86
- echo "ERROR: Unknown error code: $code" >&2
87
- if [[ -n "$extra" ]]; then
88
- echo "$extra" >&2
89
- fi
90
- ;;
91
- esac
92
- }
93
-
94
- # Return JSON error object
95
- # Usage: json_error "ERROR_CODE" "message"
96
- json_checklist_error() {
97
- local code="$1"
98
- local message="$2"
99
- echo "{\"error\": \"$code\", \"message\": \"$message\"}"
100
- }
101
-
102
- # ============================================================================
103
- # Validation Functions
104
- # ============================================================================
105
-
106
- # Validate checklist type
107
- # Usage: validate_checklist_type "ux" && echo "valid"
108
- validate_checklist_type() {
109
- local type="$1"
110
- if [[ ",$VALID_CHECKLIST_TYPES," == *",$type,"* ]]; then
111
- return 0
112
- else
113
- return 1
114
- fi
115
- }
116
-
117
- # Validate checklist item ID format (CHK + 3 digits)
118
- # Usage: validate_item_id "CHK001" && echo "valid"
119
- validate_item_id() {
120
- local id="$1"
121
- if [[ "$id" =~ ^CHK[0-9]{3}$ ]]; then
122
- return 0
123
- else
124
- return 1
125
- fi
126
- }
127
-
128
- # ============================================================================
129
- # Gate Threshold Constants
130
- # ============================================================================
131
- export DEFAULT_GATE_THRESHOLD=80