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
package/.claude/scripts/export-contracts.sh DELETED
@@ -1,117 +0,0 @@
1
- #!/usr/bin/env bash
2
- # shellcheck disable=SC2312
3
-
4
- set -euo pipefail
5
-
6
- usage() {
7
- cat <<'USAGE'
8
- Usage: scripts/bash/export-contracts.sh <requirement-dir>
9
-
10
- Extracts API contract definitions from TECH_DESIGN.md and writes them into
11
- contracts/openapi.yaml (or schema.graphql if GraphQL). Creates placeholders when
12
- structured data is unavailable.
13
- USAGE
14
- }
15
-
16
- if [[ "${1:-}" == "-h" || "${1:-}" == "--help" ]]; then
17
- usage
18
- exit 0
19
- fi
20
-
21
- if [[ $# -lt 1 ]]; then
22
- echo "Error: requirement directory is required." >&2
23
- usage
24
- exit 1
25
- fi
26
-
27
- REQ_DIR="$1"
28
- if [[ ! -d "$REQ_DIR" ]]; then
29
- echo "Error: requirement directory '$REQ_DIR' does not exist." >&2
30
- exit 1
31
- fi
32
-
33
- python3 - "$REQ_DIR" <<'PY'
34
- from __future__ import annotations
35
-
36
- import re
37
- import sys
38
- from datetime import datetime, timezone
39
- from pathlib import Path
40
-
41
- req_dir = Path(sys.argv[1]).resolve()
42
- tech_design = req_dir / "TECH_DESIGN.md"
43
- contracts_dir = req_dir / "contracts"
44
- contracts_dir.mkdir(exist_ok=True, parents=True)
45
- openapi_path = contracts_dir / "openapi.yaml"
46
- graphql_path = contracts_dir / "schema.graphql"
47
-
48
- if not tech_design.exists():
49
- print(f"Error: {tech_design} not found.", file=sys.stderr)
50
- sys.exit(1)
51
-
52
- content = tech_design.read_text(encoding="utf-8")
53
-
54
- api_patterns = [
55
- r"(^##\s+4\.\s*API.*?)(?=^##\s+\d+\.)",
56
- r"(^##\s+API Design.*?)(?=^##\s+)",
57
- ]
58
-
59
- api_section = None
60
- for pattern in api_patterns:
61
- match = re.search(pattern, content, re.MULTILINE | re.DOTALL)
62
- if match:
63
- api_section = match.group(1).strip()
64
- break
65
-
66
- generated_at = datetime.now(timezone.utc).isoformat()
67
-
68
- def extract_code_block(section: str, languages: tuple[str, ...]) -> str | None:
69
- fence_regex = re.compile(
70
- r"```(?P<lang>[^\n]*)\n(?P<body>.*?)```",
71
- re.DOTALL | re.IGNORECASE,
72
- )
73
- for match in fence_regex.finditer(section):
74
- lang = match.group("lang").strip().lower()
75
- body = match.group("body")
76
- if not languages or lang in languages:
77
- return body.strip()
78
- return None
79
-
80
- if api_section:
81
- openapi_block = extract_code_block(api_section, ("yaml", "yml", "openapi", "json"))
82
- graphql_block = extract_code_block(api_section, ("graphql",))
83
- else:
84
- openapi_block = graphql_block = None
85
-
86
- if graphql_block:
87
- graphql_path.write_text(graphql_block + "\n", encoding="utf-8")
88
- print(f"Wrote GraphQL schema → {graphql_path}")
89
- # If both exist, prefer OpenAPI as well; otherwise create stub below.
90
-
91
- if openapi_block:
92
- if not openapi_block.lstrip().startswith("openapi:"):
93
- openapi_block = f"# Generated {generated_at}\n{openapi_block}"
94
- openapi_path.write_text(openapi_block + "\n", encoding="utf-8")
95
- print(f"Wrote OpenAPI contract → {openapi_path}")
96
- else:
97
- placeholder = f"""# openapi.yaml generated {generated_at}
98
- openapi: 3.0.3
99
- info:
100
- title: {req_dir.name} API
101
- version: 0.1.0
102
- paths:
103
- /example:
104
- get:
105
- summary: TODO - replace with real endpoint
106
- responses:
107
- '200':
108
- description: OK
109
- components:
110
- schemas:
111
- TODO:
112
- type: object
113
- description: Replace with actual schema
114
- """
115
- openapi_path.write_text(placeholder, encoding="utf-8")
116
- print(f"Warning: No structured OpenAPI block found; wrote placeholder → {openapi_path}", file=sys.stderr)
117
- PY
package/.claude/scripts/extract-data-model.sh DELETED
@@ -1,78 +0,0 @@
1
- #!/usr/bin/env bash
2
- # shellcheck disable=SC2312
3
-
4
- set -euo pipefail
5
-
6
- usage() {
7
- cat <<'USAGE'
8
- Usage: scripts/bash/extract-data-model.sh <requirement-dir>
9
-
10
- Extracts the "Data Model" section from TECH_DESIGN.md into data-model.md.
11
- USAGE
12
- }
13
-
14
- if [[ "${1:-}" == "-h" || "${1:-}" == "--help" ]]; then
15
- usage
16
- exit 0
17
- fi
18
-
19
- if [[ $# -lt 1 ]]; then
20
- echo "Error: requirement directory is required." >&2
21
- usage
22
- exit 1
23
- fi
24
-
25
- REQ_DIR="$1"
26
- if [[ ! -d "$REQ_DIR" ]]; then
27
- echo "Error: requirement directory '$REQ_DIR' does not exist." >&2
28
- exit 1
29
- fi
30
-
31
- python3 - "$REQ_DIR" <<'PY'
32
- from __future__ import annotations
33
-
34
- import re
35
- import sys
36
- from datetime import datetime, timezone
37
- from pathlib import Path
38
-
39
- req_dir = Path(sys.argv[1]).resolve()
40
- tech_design = req_dir / "TECH_DESIGN.md"
41
- output_path = req_dir / "data-model.md"
42
-
43
- if not tech_design.exists():
44
- print(f"Error: {tech_design} not found.", file=sys.stderr)
45
- sys.exit(1)
46
-
47
- content = tech_design.read_text(encoding="utf-8")
48
-
49
- section_regexes = [
50
- r"(^##\s+3\.\s*Data Model.*?)(?=^##\s+\d+\.)",
51
- r"(^##\s+Data Model.*?)(?=^##\s+)",
52
- ]
53
-
54
- section = None
55
- for pattern in section_regexes:
56
- match = re.search(pattern, content, re.MULTILINE | re.DOTALL)
57
- if match:
58
- section = match.group(1).strip()
59
- break
60
-
61
- if section is None:
62
- print("Warning: Data Model section not found; creating placeholder.", file=sys.stderr)
63
- section = "## Data Model\n\n_TODO: populate data model details in TECH_DESIGN.md_"
64
-
65
- generated_at = datetime.now(timezone.utc).isoformat()
66
-
67
- lines = [
68
- f"# Data Model — {req_dir.name}",
69
- "",
70
- f"_Generated from TECH_DESIGN.md on {generated_at}_",
71
- "",
72
- section,
73
- "",
74
- ]
75
-
76
- output_path.write_text("\n".join(lines), encoding="utf-8")
77
- print(f"Wrote data model extract → {output_path}")
78
- PY
package/.claude/scripts/flow-context-add.sh DELETED
@@ -1,134 +0,0 @@
1
- #!/bin/bash
2
- # [INPUT]: 依赖 context/*.jsonl 文件
3
- # [OUTPUT]: 追加条目到指定的 jsonl 文件
4
- # [POS]: scripts 的 context 添加脚本，被 /flow-context add 调用
5
- # [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
6
-
7
- set -e
8
-
9
- # ============================================================================
10
- # Usage
11
- # ============================================================================
12
-
13
- usage() {
14
- cat << EOF
15
- Usage: flow-context-add.sh <agent> <path> <purpose> [--optional] [--type <file|directory|spec>]
16
-
17
- Add an entry to a context JSONL file.
18
-
19
- Arguments:
20
- agent Agent type (research, prd, tech, epic, dev, review)
21
- path File or directory path
22
- purpose Human-readable purpose
23
-
24
- Options:
25
- --optional Mark entry as optional
26
- --type Entry type (default: file)
27
- --depth Directory depth (only for directory type, default: 1)
28
-
29
- Examples:
30
- flow-context-add.sh dev "src/utils/auth.ts" "Authentication utilities"
31
- flow-context-add.sh dev "contracts/" "API contracts" --type directory --depth 2
32
- flow-context-add.sh dev "ERROR_LOG.md" "Previous errors" --optional
33
- EOF
34
- exit 1
35
- }
36
-
37
- # ============================================================================
38
- # Parse Arguments
39
- # ============================================================================
40
-
41
- AGENT=""
42
- PATH_ARG=""
43
- PURPOSE=""
44
- OPTIONAL="false"
45
- ENTRY_TYPE="file"
46
- DEPTH=1
47
-
48
- while [[ $# -gt 0 ]]; do
49
- case $1 in
50
- --optional)
51
- OPTIONAL="true"
52
- shift
53
- ;;
54
- --type)
55
- ENTRY_TYPE="$2"
56
- shift 2
57
- ;;
58
- --depth)
59
- DEPTH="$2"
60
- shift 2
61
- ;;
62
- --help|-h)
63
- usage
64
- ;;
65
- *)
66
- if [[ -z "$AGENT" ]]; then
67
- AGENT="$1"
68
- elif [[ -z "$PATH_ARG" ]]; then
69
- PATH_ARG="$1"
70
- elif [[ -z "$PURPOSE" ]]; then
71
- PURPOSE="$1"
72
- fi
73
- shift
74
- ;;
75
- esac
76
- done
77
-
78
- if [[ -z "$AGENT" || -z "$PATH_ARG" || -z "$PURPOSE" ]]; then
79
- echo "Error: agent, path, and purpose are required"
80
- usage
81
- fi
82
-
83
- # ============================================================================
84
- # Detect REQ-ID
85
- # ============================================================================
86
-
87
- # Try environment variable first
88
- REQ_ID="${DEVFLOW_REQ_ID:-}"
89
-
90
- # Try git branch
91
- if [[ -z "$REQ_ID" ]]; then
92
- BRANCH=$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "")
93
- REQ_ID=$(echo "$BRANCH" | grep -oE 'REQ-[0-9]+' | head -1 || echo "")
94
- fi
95
-
96
- if [[ -z "$REQ_ID" ]]; then
97
- echo "Error: Could not detect REQ-ID. Set DEVFLOW_REQ_ID or use a feature branch."
98
- exit 1
99
- fi
100
-
101
- # ============================================================================
102
- # Main Logic
103
- # ============================================================================
104
-
105
- SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
106
- PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
107
- CONTEXT_FILE="$PROJECT_ROOT/devflow/requirements/$REQ_ID/context/${AGENT}.jsonl"
108
-
109
- if [[ ! -f "$CONTEXT_FILE" ]]; then
110
- echo "Error: Context file not found: $CONTEXT_FILE"
111
- echo "Run '/flow-context init $REQ_ID' first."
112
- exit 1
113
- fi
114
-
115
- # Build JSON entry
116
- if [[ "$ENTRY_TYPE" == "directory" ]]; then
117
- if [[ "$OPTIONAL" == "true" ]]; then
118
- ENTRY="{\"type\": \"$ENTRY_TYPE\", \"path\": \"$PATH_ARG\", \"purpose\": \"$PURPOSE\", \"depth\": $DEPTH, \"optional\": true}"
119
- else
120
- ENTRY="{\"type\": \"$ENTRY_TYPE\", \"path\": \"$PATH_ARG\", \"purpose\": \"$PURPOSE\", \"depth\": $DEPTH}"
121
- fi
122
- else
123
- if [[ "$OPTIONAL" == "true" ]]; then
124
- ENTRY="{\"type\": \"$ENTRY_TYPE\", \"path\": \"$PATH_ARG\", \"purpose\": \"$PURPOSE\", \"optional\": true}"
125
- else
126
- ENTRY="{\"type\": \"$ENTRY_TYPE\", \"path\": \"$PATH_ARG\", \"purpose\": \"$PURPOSE\"}"
127
- fi
128
- fi
129
-
130
- # Append to file
131
- echo "$ENTRY" >> "$CONTEXT_FILE"
132
-
133
- echo "✅ Added entry to $CONTEXT_FILE:"
134
- echo " $ENTRY"
package/.claude/scripts/flow-context-init.sh DELETED
@@ -1,133 +0,0 @@
1
- #!/bin/bash
2
- # [INPUT]: 依赖 .claude/docs/templates/context/*.jsonl.template
3
- # [OUTPUT]: 创建 devflow/requirements/{REQ}/context/ 目录
4
- # [POS]: scripts 的 context 初始化脚本，被 /flow-context init 调用
5
- # [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
6
-
7
- set -e
8
-
9
- # ============================================================================
10
- # Configuration
11
- # ============================================================================
12
-
13
- SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
14
- PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
15
- TEMPLATES_DIR="$PROJECT_ROOT/.claude/docs/templates/context"
16
-
17
- # ============================================================================
18
- # Usage
19
- # ============================================================================
20
-
21
- usage() {
22
- cat << EOF
23
- Usage: flow-context-init.sh <REQ-ID> [--type <backend|frontend|fullstack>]
24
-
25
- Initialize context directory for a requirement.
26
-
27
- Arguments:
28
- REQ-ID Requirement ID (e.g., REQ-007)
29
-
30
- Options:
31
- --type Project type (default: fullstack)
32
- - backend: Exclude frontend specs
33
- - frontend: Exclude backend specs
34
- - fullstack: Include all specs
35
-
36
- Examples:
37
- flow-context-init.sh REQ-007
38
- flow-context-init.sh REQ-007 --type backend
39
- EOF
40
- exit 1
41
- }
42
-
43
- # ============================================================================
44
- # Parse Arguments
45
- # ============================================================================
46
-
47
- REQ_ID=""
48
- PROJECT_TYPE="fullstack"
49
-
50
- while [[ $# -gt 0 ]]; do
51
- case $1 in
52
- --type)
53
- PROJECT_TYPE="$2"
54
- shift 2
55
- ;;
56
- --help|-h)
57
- usage
58
- ;;
59
- *)
60
- if [[ -z "$REQ_ID" ]]; then
61
- REQ_ID="$1"
62
- fi
63
- shift
64
- ;;
65
- esac
66
- done
67
-
68
- if [[ -z "$REQ_ID" ]]; then
69
- echo "Error: REQ-ID is required"
70
- usage
71
- fi
72
-
73
- # Validate REQ-ID format
74
- if [[ ! "$REQ_ID" =~ ^REQ-[0-9]+$ ]]; then
75
- echo "Error: Invalid REQ-ID format. Expected REQ-XXX (e.g., REQ-007)"
76
- exit 1
77
- fi
78
-
79
- # ============================================================================
80
- # Main Logic
81
- # ============================================================================
82
-
83
- REQ_DIR="$PROJECT_ROOT/devflow/requirements/$REQ_ID"
84
- CONTEXT_DIR="$REQ_DIR/context"
85
-
86
- # Check if requirement directory exists
87
- if [[ ! -d "$REQ_DIR" ]]; then
88
- echo "Error: Requirement directory not found: $REQ_DIR"
89
- exit 1
90
- fi
91
-
92
- # Create context directory
93
- mkdir -p "$CONTEXT_DIR"
94
-
95
- echo "Initializing context for $REQ_ID (type: $PROJECT_TYPE)..."
96
-
97
- # Copy templates
98
- for template in "$TEMPLATES_DIR"/*.jsonl.template; do
99
- if [[ -f "$template" ]]; then
100
- filename=$(basename "$template" .template)
101
- target="$CONTEXT_DIR/$filename"
102
-
103
- # Skip if already exists
104
- if [[ -f "$target" ]]; then
105
- echo " ⏭️ Skipping $filename (already exists)"
106
- continue
107
- fi
108
-
109
- # Copy and filter based on project type
110
- case $PROJECT_TYPE in
111
- backend)
112
- # Remove frontend spec entries
113
- grep -v 'devflow/spec/frontend' "$template" > "$target" || cp "$template" "$target"
114
- ;;
115
- frontend)
116
- # Remove backend spec entries
117
- grep -v 'devflow/spec/backend' "$template" > "$target" || cp "$template" "$target"
118
- ;;
119
- *)
120
- # Copy as-is
121
- cp "$template" "$target"
122
- ;;
123
- esac
124
-
125
- echo " ✅ Created $filename"
126
- fi
127
- done
128
-
129
- echo ""
130
- echo "Context initialized at: $CONTEXT_DIR"
131
- echo ""
132
- echo "Files created:"
133
- ls -la "$CONTEXT_DIR"
package/.claude/scripts/flow-context-validate.sh DELETED
@@ -1,144 +0,0 @@
1
- #!/bin/bash
2
- # [INPUT]: 依赖 context/*.jsonl 文件
3
- # [OUTPUT]: 验证结果输出到 stdout
4
- # [POS]: scripts 的 context 验证脚本，被 /flow-context validate 调用
5
- # [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
6
-
7
- set -e
8
-
9
- # ============================================================================
10
- # Usage
11
- # ============================================================================
12
-
13
- usage() {
14
- cat << EOF
15
- Usage: flow-context-validate.sh [REQ-ID]
16
-
17
- Validate all context paths exist for a requirement.
18
-
19
- Arguments:
20
- REQ-ID Requirement ID (optional, auto-detected from branch)
21
-
22
- Examples:
23
- flow-context-validate.sh REQ-007
24
- flow-context-validate.sh
25
- EOF
26
- exit 1
27
- }
28
-
29
- # ============================================================================
30
- # Parse Arguments
31
- # ============================================================================
32
-
33
- REQ_ID="$1"
34
-
35
- # Auto-detect REQ-ID if not provided
36
- if [[ -z "$REQ_ID" ]]; then
37
- REQ_ID="${DEVFLOW_REQ_ID:-}"
38
-
39
- if [[ -z "$REQ_ID" ]]; then
40
- BRANCH=$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "")
41
- REQ_ID=$(echo "$BRANCH" | grep -oE 'REQ-[0-9]+' | head -1 || echo "")
42
- fi
43
- fi
44
-
45
- if [[ -z "$REQ_ID" ]]; then
46
- echo "Error: Could not detect REQ-ID. Provide it as argument or set DEVFLOW_REQ_ID."
47
- usage
48
- fi
49
-
50
- # ============================================================================
51
- # Main Logic
52
- # ============================================================================
53
-
54
- SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
55
- PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
56
- REQ_DIR="$PROJECT_ROOT/devflow/requirements/$REQ_ID"
57
- CONTEXT_DIR="$REQ_DIR/context"
58
-
59
- if [[ ! -d "$CONTEXT_DIR" ]]; then
60
- echo "Error: Context directory not found: $CONTEXT_DIR"
61
- echo "Run '/flow-context init $REQ_ID' first."
62
- exit 1
63
- fi
64
-
65
- echo "Validating context for $REQ_ID..."
66
- echo ""
67
-
68
- TOTAL_VALID=0
69
- TOTAL_INVALID=0
70
- TOTAL_OPTIONAL_MISSING=0
71
-
72
- for jsonl_file in "$CONTEXT_DIR"/*.jsonl; do
73
- if [[ ! -f "$jsonl_file" ]]; then
74
- continue
75
- fi
76
-
77
- filename=$(basename "$jsonl_file")
78
- valid=0
79
- invalid=0
80
- missing_paths=()
81
-
82
- while IFS= read -r line || [[ -n "$line" ]]; do
83
- # Skip empty lines and comments
84
- [[ -z "$line" || "$line" =~ ^[[:space:]]*# || "$line" =~ ^[[:space:]]*// ]] && continue
85
-
86
- # Parse JSON (basic extraction)
87
- path=$(echo "$line" | grep -oP '"path"\s*:\s*"\K[^"]+' || echo "")
88
- type=$(echo "$line" | grep -oP '"type"\s*:\s*"\K[^"]+' || echo "file")
89
- optional=$(echo "$line" | grep -oP '"optional"\s*:\s*\K(true|false)' || echo "false")
90
-
91
- if [[ -z "$path" ]]; then
92
- continue
93
- fi
94
-
95
- # Resolve path
96
- if [[ "$type" == "spec" ]]; then
97
- full_path="$PROJECT_ROOT/$path"
98
- else
99
- full_path="$REQ_DIR/$path"
100
- fi
101
-
102
- # Check existence
103
- if [[ -e "$full_path" ]]; then
104
- ((valid++))
105
- else
106
- if [[ "$optional" == "true" ]]; then
107
- ((TOTAL_OPTIONAL_MISSING++))
108
- else
109
- ((invalid++))
110
- missing_paths+=("$path")
111
- fi
112
- fi
113
- done < "$jsonl_file"
114
-
115
- TOTAL_VALID=$((TOTAL_VALID + valid))
116
- TOTAL_INVALID=$((TOTAL_INVALID + invalid))
117
-
118
- total=$((valid + invalid))
119
- if [[ $invalid -eq 0 ]]; then
120
- echo " ✓ $filename: $valid/$total paths valid"
121
- else
122
- echo " ✗ $filename: $valid/$total paths valid"
123
- for mp in "${missing_paths[@]}"; do
124
- echo " - Missing: $mp"
125
- done
126
- fi
127
- done
128
-
129
- echo ""
130
- GRAND_TOTAL=$((TOTAL_VALID + TOTAL_INVALID))
131
- if [[ $GRAND_TOTAL -gt 0 ]]; then
132
- PERCENT=$((TOTAL_VALID * 100 / GRAND_TOTAL))
133
- echo "Overall: $TOTAL_VALID/$GRAND_TOTAL paths valid ($PERCENT%)"
134
- if [[ $TOTAL_OPTIONAL_MISSING -gt 0 ]]; then
135
- echo "Optional missing: $TOTAL_OPTIONAL_MISSING (not counted in validation)"
136
- fi
137
- else
138
- echo "No context entries found."
139
- fi
140
-
141
- # Exit with error if any required paths are missing
142
- if [[ $TOTAL_INVALID -gt 0 ]]; then
143
- exit 1
144
- fi