cc-devflow 4.3.0 → 4.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (575) hide show
  1. package/.claude/skills/cc-act/CHANGELOG.md +64 -0
  2. package/.claude/skills/cc-act/PLAYBOOK.md +212 -0
  3. package/.claude/skills/cc-act/SKILL.md +322 -0
  4. package/.claude/skills/cc-act/assets/PR_BRIEF_TEMPLATE.md +64 -0
  5. package/.claude/skills/cc-act/assets/RELEASE_NOTE_TEMPLATE.md +25 -0
  6. package/.claude/skills/cc-act/references/closure-contract.md +49 -0
  7. package/.claude/skills/cc-act/references/git-commit-guidelines.md +83 -0
  8. package/.claude/skills/cc-act/scripts/archive-requirement.sh +49 -0
  9. package/.claude/skills/cc-act/scripts/cc-act-common.sh +240 -0
  10. package/.claude/skills/cc-act/scripts/detect-ship-target.sh +82 -0
  11. package/.claude/skills/cc-act/scripts/generate-status-report.sh +83 -0
  12. package/.claude/skills/cc-act/scripts/render-pr-brief.sh +195 -0
  13. package/.claude/skills/cc-act/scripts/sync-act-docs.sh +315 -0
  14. package/.claude/skills/cc-act/scripts/verify-act-gate.sh +63 -0
  15. package/.claude/skills/cc-check/CHANGELOG.md +73 -0
  16. package/.claude/skills/cc-check/PLAYBOOK.md +153 -0
  17. package/.claude/skills/cc-check/SKILL.md +345 -0
  18. package/.claude/skills/cc-check/assets/REPORT_CARD_TEMPLATE.json +50 -0
  19. package/.claude/skills/cc-check/references/gate-contract.md +29 -0
  20. package/.claude/skills/cc-check/references/review-contract.md +45 -0
  21. package/.claude/skills/cc-check/scripts/render-report-card.js +229 -0
  22. package/.claude/skills/cc-check/scripts/run-quality-gates.sh +86 -0
  23. package/.claude/skills/cc-check/scripts/verify-gate.sh +57 -0
  24. package/.claude/skills/cc-do/CHANGELOG.md +49 -0
  25. package/.claude/skills/cc-do/PLAYBOOK.md +119 -0
  26. package/.claude/skills/cc-do/SKILL.md +216 -0
  27. package/.claude/skills/cc-do/references/execution-recovery.md +86 -0
  28. package/.claude/skills/cc-do/references/parallel-dispatch.md +80 -0
  29. package/.claude/skills/cc-do/scripts/build-task-context.sh +184 -0
  30. package/.claude/skills/cc-do/scripts/cc-do-common.sh +79 -0
  31. package/.claude/skills/cc-do/scripts/check-task-status.sh +92 -0
  32. package/.claude/skills/cc-do/scripts/detect-file-conflicts.sh +87 -0
  33. package/.claude/skills/cc-do/scripts/mark-task-complete.sh +119 -0
  34. package/.claude/skills/cc-do/scripts/record-review-decision.sh +89 -0
  35. package/.claude/skills/cc-do/scripts/recover-workflow.sh +84 -0
  36. package/.claude/skills/cc-do/scripts/run-problem-analysis.sh +70 -0
  37. package/.claude/skills/cc-do/scripts/select-ready-tasks.sh +135 -0
  38. package/.claude/skills/cc-do/scripts/verify-task-gates.sh +94 -0
  39. package/.claude/skills/cc-do/scripts/write-task-checkpoint.sh +102 -0
  40. package/.claude/skills/cc-investigate/CHANGELOG.md +26 -0
  41. package/.claude/skills/cc-investigate/PLAYBOOK.md +49 -0
  42. package/.claude/skills/cc-investigate/SKILL.md +221 -0
  43. package/.claude/skills/cc-investigate/assets/ANALYSIS_TEMPLATE.md +55 -0
  44. package/.claude/skills/cc-investigate/assets/TASKS_TEMPLATE.md +52 -0
  45. package/.claude/skills/cc-investigate/assets/TASK_MANIFEST_TEMPLATE.json +103 -0
  46. package/.claude/skills/cc-investigate/references/investigation-contract.md +28 -0
  47. package/.claude/skills/cc-investigate/scripts/bootstrap-analysis.sh +38 -0
  48. package/.claude/skills/cc-plan/CHANGELOG.md +99 -0
  49. package/.claude/skills/cc-plan/PLAYBOOK.md +106 -0
  50. package/.claude/skills/cc-plan/SKILL.md +325 -0
  51. package/.claude/skills/cc-plan/assets/DESIGN_TEMPLATE.md +155 -0
  52. package/.claude/skills/cc-plan/assets/TASKS_TEMPLATE.md +98 -0
  53. package/.claude/skills/cc-plan/assets/TASK_MANIFEST_TEMPLATE.json +108 -0
  54. package/.claude/skills/cc-plan/assets/TINY_DESIGN_TEMPLATE.md +79 -0
  55. package/.claude/skills/cc-plan/references/planning-contract.md +82 -0
  56. package/.claude/skills/cc-plan/scripts/bump-skill-version.sh +103 -0
  57. package/.claude/skills/cc-plan/scripts/parse-task-dependencies.js +75 -0
  58. package/.claude/skills/cc-plan/scripts/validate-scope.sh +78 -0
  59. package/.claude/skills/cc-roadmap/CHANGELOG.md +114 -0
  60. package/.claude/skills/cc-roadmap/PLAYBOOK.md +136 -0
  61. package/.claude/skills/cc-roadmap/SKILL.md +259 -0
  62. package/.claude/skills/cc-roadmap/assets/BACKLOG_TEMPLATE.md +45 -0
  63. package/.claude/skills/cc-roadmap/assets/ROADMAP_TEMPLATE.md +153 -0
  64. package/.claude/skills/cc-roadmap/assets/TRACKING_TEMPLATE.json +48 -0
  65. package/.claude/skills/cc-roadmap/references/roadmap-dialogue.md +37 -0
  66. package/.claude/skills/cc-roadmap/scripts/bump-skill-version.sh +103 -0
  67. package/.claude/skills/cc-roadmap/scripts/lib/roadmap-tracking/markdown.js +604 -0
  68. package/.claude/skills/cc-roadmap/scripts/lib/roadmap-tracking/query.js +63 -0
  69. package/.claude/skills/cc-roadmap/scripts/lib/roadmap-tracking/schema.js +245 -0
  70. package/.claude/skills/cc-roadmap/scripts/lib/roadmap-tracking/store.js +139 -0
  71. package/.claude/skills/cc-roadmap/scripts/locate-roadmap-item.sh +109 -0
  72. package/.claude/skills/cc-roadmap/scripts/roadmap-tracking.js +153 -0
  73. package/.claude/skills/cc-roadmap/scripts/sync-roadmap-progress.sh +100 -0
  74. package/.claude/skills/cc-simplify/CHANGELOG.md +10 -0
  75. package/.claude/skills/cc-simplify/SKILL.md +55 -0
  76. package/.claude/skills/cc-spec-init/CHANGELOG.md +7 -0
  77. package/.claude/skills/cc-spec-init/PLAYBOOK.md +55 -0
  78. package/.claude/skills/cc-spec-init/SKILL.md +127 -0
  79. package/.claude/skills/cc-spec-init/assets/CAPABILITY_TEMPLATE.md +63 -0
  80. package/.claude/skills/cc-spec-init/assets/CHANGE_META_TEMPLATE.json +25 -0
  81. package/.claude/skills/cc-spec-init/assets/INDEX_TEMPLATE.md +34 -0
  82. package/.claude/skills/cc-spec-init/references/spec-contract.md +22 -0
  83. package/.claude/skills/cc-spec-init/scripts/bootstrap-specs.sh +31 -0
  84. package/.claude/skills/cc-spec-init/scripts/validate-spec-links.sh +45 -0
  85. package/CHANGELOG.md +61 -4
  86. package/README.md +120 -756
  87. package/README.zh-CN.md +119 -756
  88. package/bin/adapt.js +2 -6
  89. package/bin/cc-devflow-cli.js +72 -177
  90. package/config/distributable-skills.json +24 -0
  91. package/docs/CLAUDE.md +10 -6
  92. package/docs/commands/README.md +19 -46
  93. package/docs/commands/README.zh-CN.md +25 -48
  94. package/docs/examples/BY-ARTIFACT.md +7 -0
  95. package/docs/examples/README.md +38 -0
  96. package/docs/examples/START-HERE.md +149 -0
  97. package/docs/examples/example-bindings.json +38 -0
  98. package/docs/examples/full-design-blocked/BACKLOG.md +45 -0
  99. package/docs/examples/full-design-blocked/README.md +55 -0
  100. package/docs/examples/full-design-blocked/ROADMAP.md +53 -0
  101. package/docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/planning/design.md +154 -0
  102. package/docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/planning/task-manifest.json +146 -0
  103. package/docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/planning/tasks.md +78 -0
  104. package/docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/review/report-card.json +52 -0
  105. package/docs/examples/full-design-blocked/roadmap-tracking.json +50 -0
  106. package/docs/examples/local-handoff/BACKLOG.md +45 -0
  107. package/docs/examples/local-handoff/README.md +56 -0
  108. package/docs/examples/local-handoff/ROADMAP.md +45 -0
  109. package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/handoff/resume-index.md +39 -0
  110. package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/handoff/status.md +29 -0
  111. package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/planning/design.md +71 -0
  112. package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/planning/task-manifest.json +98 -0
  113. package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/planning/tasks.md +59 -0
  114. package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/review/report-card.json +44 -0
  115. package/docs/examples/local-handoff/roadmap-tracking.json +48 -0
  116. package/docs/examples/pdca-loop/BACKLOG.md +46 -0
  117. package/docs/examples/pdca-loop/README.md +58 -0
  118. package/docs/examples/pdca-loop/ROADMAP.md +133 -0
  119. package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/handoff/pr-brief.md +72 -0
  120. package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/handoff/status.md +29 -0
  121. package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/design.md +72 -0
  122. package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/task-manifest.json +201 -0
  123. package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/tasks.md +73 -0
  124. package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/review/report-card.json +44 -0
  125. package/docs/examples/pdca-loop/roadmap-tracking.json +114 -0
  126. package/docs/examples/scripts/check-example-bindings.sh +116 -0
  127. package/docs/guides/getting-started.md +94 -129
  128. package/docs/guides/getting-started.zh-CN.md +103 -84
  129. package/docs/skill-runtime-migration.md +46 -0
  130. package/docs/v4.3.0-migration-guide.md +60 -225
  131. package/lib/compiler/CLAUDE.md +55 -84
  132. package/lib/compiler/__tests__/drift.test.js +1 -1
  133. package/lib/compiler/__tests__/errors.test.js +0 -1
  134. package/lib/compiler/__tests__/integration.test.js +49 -3
  135. package/lib/compiler/__tests__/manifest.test.js +0 -156
  136. package/lib/compiler/__tests__/parser.test.js +33 -104
  137. package/lib/compiler/__tests__/schemas.test.js +30 -34
  138. package/lib/compiler/__tests__/skills-registry.test.js +114 -0
  139. package/lib/compiler/__tests__/transformer.test.js +5 -9
  140. package/lib/compiler/emitters/antigravity-emitter.js +5 -213
  141. package/lib/compiler/emitters/base-emitter.js +3 -298
  142. package/lib/compiler/emitters/codex-emitter.js +4 -202
  143. package/lib/compiler/emitters/cursor-emitter.js +3 -287
  144. package/lib/compiler/emitters/qwen-emitter.js +4 -176
  145. package/lib/compiler/index.js +65 -345
  146. package/lib/compiler/manifest.js +6 -68
  147. package/lib/compiler/parser.js +31 -63
  148. package/lib/compiler/platforms.js +32 -277
  149. package/lib/compiler/resource-copier.js +176 -6
  150. package/lib/compiler/rules-emitters/__tests__/antigravity-rules-emitter.test.js +3 -3
  151. package/lib/compiler/rules-emitters/__tests__/cursor-rules-emitter.test.js +14 -4
  152. package/lib/compiler/rules-emitters/__tests__/qwen-rules-emitter.test.js +16 -7
  153. package/lib/compiler/rules-emitters/antigravity-rules-emitter.js +10 -15
  154. package/lib/compiler/rules-emitters/base-rules-emitter.js +5 -5
  155. package/lib/compiler/rules-emitters/cursor-rules-emitter.js +7 -12
  156. package/lib/compiler/rules-emitters/index.js +6 -3
  157. package/lib/compiler/rules-emitters/qwen-rules-emitter.js +7 -7
  158. package/lib/compiler/schemas.js +8 -4
  159. package/lib/compiler/skills-registry.js +213 -15
  160. package/lib/compiler/transformer.js +1 -1
  161. package/lib/skill-runtime/CLAUDE.md +19 -0
  162. package/lib/skill-runtime/__tests__/autopilot.test.js +210 -0
  163. package/lib/skill-runtime/__tests__/cli-bootstrap.integration.test.js +181 -0
  164. package/lib/skill-runtime/__tests__/delegation.test.js +97 -0
  165. package/lib/skill-runtime/__tests__/dispatch.test.js +267 -0
  166. package/lib/skill-runtime/__tests__/intent.test.js +219 -0
  167. package/lib/skill-runtime/__tests__/lifecycle.test.js +169 -0
  168. package/lib/skill-runtime/__tests__/paths.test.js +42 -0
  169. package/lib/skill-runtime/__tests__/planner.tdd.test.js +250 -0
  170. package/lib/skill-runtime/__tests__/prepare-pr.test.js +139 -0
  171. package/lib/skill-runtime/__tests__/query.test.js +284 -0
  172. package/lib/skill-runtime/__tests__/runtime.integration.test.js +279 -0
  173. package/lib/skill-runtime/__tests__/schemas.test.js +207 -0
  174. package/lib/skill-runtime/__tests__/team-state.test.js +51 -0
  175. package/lib/skill-runtime/__tests__/worker-run.test.js +253 -0
  176. package/lib/skill-runtime/__tests__/worker.test.js +56 -0
  177. package/lib/skill-runtime/artifacts.js +93 -0
  178. package/lib/skill-runtime/delegation.js +533 -0
  179. package/lib/skill-runtime/index.js +34 -0
  180. package/lib/skill-runtime/intent.js +333 -0
  181. package/lib/skill-runtime/lifecycle.js +294 -0
  182. package/lib/skill-runtime/operations/CLAUDE.md +19 -0
  183. package/lib/skill-runtime/operations/approve.js +66 -0
  184. package/lib/skill-runtime/operations/autopilot-core.js +337 -0
  185. package/lib/skill-runtime/operations/autopilot-execution.js +307 -0
  186. package/lib/skill-runtime/operations/autopilot-shared.js +48 -0
  187. package/lib/skill-runtime/operations/autopilot.js +163 -0
  188. package/lib/skill-runtime/operations/dispatch.js +454 -0
  189. package/lib/skill-runtime/operations/init.js +64 -0
  190. package/lib/{harness → skill-runtime}/operations/janitor.js +9 -6
  191. package/lib/skill-runtime/operations/plan.js +59 -0
  192. package/lib/skill-runtime/operations/prepare-pr.js +25 -0
  193. package/lib/skill-runtime/operations/release.js +96 -0
  194. package/lib/skill-runtime/operations/resume.js +143 -0
  195. package/lib/skill-runtime/operations/snapshot.js +45 -0
  196. package/lib/skill-runtime/operations/verify.js +170 -0
  197. package/lib/skill-runtime/operations/worker-run.js +529 -0
  198. package/lib/skill-runtime/operations/worker.js +33 -0
  199. package/lib/skill-runtime/paths.js +213 -0
  200. package/lib/skill-runtime/planner.js +519 -0
  201. package/lib/skill-runtime/query.js +157 -0
  202. package/lib/skill-runtime/review.js +557 -0
  203. package/lib/skill-runtime/schemas.js +400 -0
  204. package/lib/{harness → skill-runtime}/store.js +45 -30
  205. package/lib/skill-runtime/team-state.js +122 -0
  206. package/package.json +13 -11
  207. package/.claude/CLAUDE.md +0 -125
  208. package/.claude/agents/architecture-designer.md +0 -443
  209. package/.claude/agents/bug-analyzer.md +0 -381
  210. package/.claude/agents/checklist-agent.md +0 -175
  211. package/.claude/agents/clarify-analyst.md +0 -50
  212. package/.claude/agents/code-quality-reviewer.md +0 -205
  213. package/.claude/agents/code-reviewer.md +0 -71
  214. package/.claude/agents/codex-analyzer.md +0 -39
  215. package/.claude/agents/compatibility-checker.md +0 -579
  216. package/.claude/agents/consistency-checker.md +0 -532
  217. package/.claude/agents/dev-implementer.md +0 -195
  218. package/.claude/agents/flow-researcher.md +0 -132
  219. package/.claude/agents/impact-analyzer.md +0 -440
  220. package/.claude/agents/planner.md +0 -230
  221. package/.claude/agents/prd-writer.md +0 -320
  222. package/.claude/agents/project-guidelines-generator.md +0 -1329
  223. package/.claude/agents/qa-tester.md +0 -313
  224. package/.claude/agents/release-manager.md +0 -295
  225. package/.claude/agents/security-reviewer.md +0 -314
  226. package/.claude/agents/spec-reviewer.md +0 -221
  227. package/.claude/agents/style-guide-generator.md +0 -458
  228. package/.claude/agents/tech-architect.md +0 -516
  229. package/.claude/agents/ui-designer.md +0 -485
  230. package/.claude/commands/core/architecture.md +0 -459
  231. package/.claude/commands/core/guidelines.md +0 -511
  232. package/.claude/commands/core/roadmap.md +0 -468
  233. package/.claude/commands/core/style.md +0 -83
  234. package/.claude/commands/flow/CLAUDE.md +0 -24
  235. package/.claude/commands/flow/archive.md +0 -280
  236. package/.claude/commands/flow/constitution.md +0 -82
  237. package/.claude/commands/flow/context.md +0 -150
  238. package/.claude/commands/flow/delta.md +0 -245
  239. package/.claude/commands/flow/dev.md +0 -40
  240. package/.claude/commands/flow/fix.md +0 -217
  241. package/.claude/commands/flow/ideate.md +0 -214
  242. package/.claude/commands/flow/init.md +0 -38
  243. package/.claude/commands/flow/release.md +0 -36
  244. package/.claude/commands/flow/restart.md +0 -97
  245. package/.claude/commands/flow/spec.md +0 -36
  246. package/.claude/commands/flow/status.md +0 -64
  247. package/.claude/commands/flow/update.md +0 -111
  248. package/.claude/commands/flow/upgrade.md +0 -115
  249. package/.claude/commands/flow/verify.md +0 -37
  250. package/.claude/commands/flow/workspace.md +0 -155
  251. package/.claude/commands/util/cancel-ralph.md +0 -60
  252. package/.claude/commands/util/code-review.md +0 -58
  253. package/.claude/commands/util/git-commit.md +0 -422
  254. package/.claude/commands/util/problem-analyzer.md +0 -60
  255. package/.claude/config/quality-gates.yml +0 -305
  256. package/.claude/config/quality-rules.yml +0 -161
  257. package/.claude/docs/SPEC_KIT_CONSTITUTION_ANALYSIS.md +0 -426
  258. package/.claude/docs/design/consistency-conflict-detection-algorithms.md +0 -658
  259. package/.claude/docs/design/intent-driven-input-design.md +0 -380
  260. package/.claude/docs/design/prd-version-management-design.md +0 -437
  261. package/.claude/docs/examples/design-inspiration-pool.md +0 -59
  262. package/.claude/docs/examples/ui-prototype-constitution-checklist.md +0 -75
  263. package/.claude/docs/guides/INIT_TROUBLESHOOTING.md +0 -117
  264. package/.claude/docs/guides/NEW_TROUBLESHOOTING.md +0 -99
  265. package/.claude/docs/guides/ROADMAP_TROUBLESHOOTING.md +0 -188
  266. package/.claude/docs/guides/TASK_COMPLETION_MARKING.md +0 -338
  267. package/.claude/docs/guides/TEAM_MODE_GUIDE.md +0 -312
  268. package/.claude/docs/implementation-summary-v7.md +0 -449
  269. package/.claude/docs/spec-format-guide.md +0 -349
  270. package/.claude/docs/state-consolidation-design.md +0 -323
  271. package/.claude/docs/templates/ARCHITECTURE_TEMPLATE.md +0 -332
  272. package/.claude/docs/templates/ATTEMPT_TEMPLATE.md +0 -156
  273. package/.claude/docs/templates/BACKLOG_TEMPLATE.md +0 -261
  274. package/.claude/docs/templates/BRAINSTORM_TEMPLATE.md +0 -148
  275. package/.claude/docs/templates/CHECKLIST_TEMPLATE.md +0 -52
  276. package/.claude/docs/templates/CLARIFICATION_REPORT_TEMPLATE.md +0 -206
  277. package/.claude/docs/templates/CODE_REVIEW_TEMPLATE.md +0 -71
  278. package/.claude/docs/templates/DELTA_SPEC_TEMPLATE.md +0 -91
  279. package/.claude/docs/templates/DESIGN_DECISIONS_TEMPLATE.md +0 -151
  280. package/.claude/docs/templates/DESIGN_TEMPLATE.md +0 -157
  281. package/.claude/docs/templates/ERROR_LOG_TEMPLATE.md +0 -80
  282. package/.claude/docs/templates/INIT_FLOW_TEMPLATE.md +0 -198
  283. package/.claude/docs/templates/INTENT_CLARIFICATION_TEMPLATE.md +0 -57
  284. package/.claude/docs/templates/JOURNAL_TEMPLATE.md +0 -75
  285. package/.claude/docs/templates/NEW_ORCHESTRATION_TEMPLATE.md +0 -76
  286. package/.claude/docs/templates/PROPOSAL_TEMPLATE.md +0 -91
  287. package/.claude/docs/templates/RESEARCH_TEMPLATE.md +0 -276
  288. package/.claude/docs/templates/REVIEW-HIGH.md +0 -57
  289. package/.claude/docs/templates/ROADMAP_DIALOGUE_TEMPLATE.md +0 -198
  290. package/.claude/docs/templates/ROADMAP_TEMPLATE.md +0 -310
  291. package/.claude/docs/templates/SPEC_TEMPLATE_DELTA.md +0 -139
  292. package/.claude/docs/templates/SPEC_TEMPLATE_PROJECT.md +0 -93
  293. package/.claude/docs/templates/STYLE_TEMPLATE.md +0 -479
  294. package/.claude/docs/templates/UI_PROTOTYPE_TEMPLATE.md +0 -373
  295. package/.claude/docs/templates/_shared/CLAUDE.md +0 -36
  296. package/.claude/docs/templates/_shared/CONSTITUTION_CHECK.md +0 -125
  297. package/.claude/docs/templates/_shared/VALIDATION_CHECKLIST.md +0 -187
  298. package/.claude/docs/templates/_shared/YAML_FRONTMATTER.md +0 -164
  299. package/.claude/docs/templates/context/dev.jsonl.template +0 -6
  300. package/.claude/docs/templates/context/epic.jsonl.template +0 -5
  301. package/.claude/docs/templates/context/prd.jsonl.template +0 -4
  302. package/.claude/docs/templates/context/research.jsonl.template +0 -4
  303. package/.claude/docs/templates/context/review.jsonl.template +0 -5
  304. package/.claude/docs/templates/context/tech.jsonl.template +0 -5
  305. package/.claude/guides/agent-guides/agent-coordination-guide.md +0 -459
  306. package/.claude/guides/project-guidelines-system.md +0 -463
  307. package/.claude/guides/technical-guides/datetime-handling-guide.md +0 -563
  308. package/.claude/guides/technical-guides/git-github-guide.md +0 -642
  309. package/.claude/guides/technical-guides/test-execution-guide.md +0 -618
  310. package/.claude/guides/workflow-guides/bug-fix-orchestrator.md +0 -217
  311. package/.claude/guides/workflow-guides/flow-orchestrator.md +0 -48
  312. package/.claude/hooks/CLAUDE.md +0 -342
  313. package/.claude/hooks/checklist-gate.js +0 -397
  314. package/.claude/hooks/error-handling-reminder.sh +0 -12
  315. package/.claude/hooks/error-handling-reminder.ts +0 -459
  316. package/.claude/hooks/hooks.json +0 -15
  317. package/.claude/hooks/inject-agent-context.ts +0 -480
  318. package/.claude/hooks/inject-skill-context.ts +0 -359
  319. package/.claude/hooks/post-tool-use-tracker.sh +0 -280
  320. package/.claude/hooks/pre-tool-use-guardrail.sh +0 -36
  321. package/.claude/hooks/pre-tool-use-guardrail.ts +0 -342
  322. package/.claude/hooks/ralph-loop.ts +0 -931
  323. package/.claude/hooks/ralph-stop-hook.sh +0 -190
  324. package/.claude/hooks/skill-activation-prompt.sh +0 -36
  325. package/.claude/hooks/skill-activation-prompt.ts +0 -214
  326. package/.claude/hooks/state/skills-used-test-guard.json +0 -3
  327. package/.claude/hooks/task-completed-hook.ts +0 -593
  328. package/.claude/hooks/teammate-idle-hook.ts +0 -690
  329. package/.claude/hooks/types/team-types.d.ts +0 -238
  330. package/.claude/rules/devflow-conventions.md +0 -286
  331. package/.claude/rules/project-constitution.md +0 -1002
  332. package/.claude/rules/rationalization-library.md +0 -282
  333. package/.claude/schemas/constitution.schema.json +0 -43
  334. package/.claude/scripts/.claude/commands/flow/export-openspec.md +0 -221
  335. package/.claude/scripts/.claude/commands/flow/import-openspec.md +0 -171
  336. package/.claude/scripts/CLAUDE.md +0 -76
  337. package/.claude/scripts/__tests__/openspec.test.js +0 -212
  338. package/.claude/scripts/analyze-upgrade-impact.sh +0 -200
  339. package/.claude/scripts/archive-requirement.sh +0 -394
  340. package/.claude/scripts/calculate-checklist-completion.sh +0 -243
  341. package/.claude/scripts/calculate-quarter.sh +0 -206
  342. package/.claude/scripts/check-dependencies.sh +0 -409
  343. package/.claude/scripts/check-prerequisites.sh +0 -232
  344. package/.claude/scripts/check-task-status.sh +0 -288
  345. package/.claude/scripts/checklist-errors.sh +0 -131
  346. package/.claude/scripts/common.sh +0 -1102
  347. package/.claude/scripts/consolidate-research.sh +0 -182
  348. package/.claude/scripts/create-requirement.sh +0 -451
  349. package/.claude/scripts/delta-parser.ts +0 -637
  350. package/.claude/scripts/detect-file-conflicts.sh +0 -151
  351. package/.claude/scripts/export-contracts.sh +0 -117
  352. package/.claude/scripts/export-openspec.js +0 -222
  353. package/.claude/scripts/extract-data-model.sh +0 -78
  354. package/.claude/scripts/flow-context-add.sh +0 -134
  355. package/.claude/scripts/flow-context-init.sh +0 -133
  356. package/.claude/scripts/flow-context-validate.sh +0 -144
  357. package/.claude/scripts/flow-delta-apply.sh +0 -297
  358. package/.claude/scripts/flow-delta-archive.sh +0 -71
  359. package/.claude/scripts/flow-delta-create.sh +0 -202
  360. package/.claude/scripts/flow-delta-list.sh +0 -142
  361. package/.claude/scripts/flow-delta-status.sh +0 -235
  362. package/.claude/scripts/flow-quality-full.sh +0 -215
  363. package/.claude/scripts/flow-quality-quick.sh +0 -119
  364. package/.claude/scripts/flow-workspace-init.sh +0 -117
  365. package/.claude/scripts/flow-workspace-record.sh +0 -164
  366. package/.claude/scripts/generate-clarification-questions.sh +0 -377
  367. package/.claude/scripts/generate-clarification-report.sh +0 -463
  368. package/.claude/scripts/generate-quickstart.sh +0 -146
  369. package/.claude/scripts/generate-research-tasks.sh +0 -157
  370. package/.claude/scripts/generate-status-report.sh +0 -523
  371. package/.claude/scripts/generate-tech-analysis.sh +0 -46
  372. package/.claude/scripts/get-workflow-status.sh +0 -415
  373. package/.claude/scripts/import-openspec.js +0 -272
  374. package/.claude/scripts/locate-requirement-in-roadmap.sh +0 -233
  375. package/.claude/scripts/manage-constitution.sh +0 -602
  376. package/.claude/scripts/mark-task-complete.sh +0 -198
  377. package/.claude/scripts/parse-task-dependencies.js +0 -334
  378. package/.claude/scripts/populate-research-tasks.sh +0 -284
  379. package/.claude/scripts/record-quality-error.sh +0 -165
  380. package/.claude/scripts/recover-workflow.sh +0 -463
  381. package/.claude/scripts/run-clarify-scan.sh +0 -601
  382. package/.claude/scripts/run-high-review.sh +0 -62
  383. package/.claude/scripts/run-problem-analysis.sh +0 -68
  384. package/.claude/scripts/run-quality-gates.sh +0 -242
  385. package/.claude/scripts/setup-epic.sh +0 -173
  386. package/.claude/scripts/setup-ralph-loop.sh +0 -155
  387. package/.claude/scripts/sync-roadmap-progress.sh +0 -300
  388. package/.claude/scripts/sync-task-marks.sh +0 -199
  389. package/.claude/scripts/team-dev-init.sh +0 -319
  390. package/.claude/scripts/team-state-recovery.sh +0 -229
  391. package/.claude/scripts/test-clarify-scan.sh +0 -515
  392. package/.claude/scripts/update-agent-context.sh +0 -806
  393. package/.claude/scripts/validate-constitution.sh +0 -567
  394. package/.claude/scripts/validate-hooks.sh +0 -487
  395. package/.claude/scripts/validate-research.sh +0 -332
  396. package/.claude/scripts/validate-scope-boundary.sh +0 -493
  397. package/.claude/scripts/validate-scope.sh +0 -200
  398. package/.claude/scripts/verify-gate.sh +0 -269
  399. package/.claude/scripts/verify-setup.sh +0 -37
  400. package/.claude/scripts/workflow-status.ts +0 -433
  401. package/.claude/settings.json +0 -95
  402. package/.claude/skills/_reference-implementations/README.md +0 -96
  403. package/.claude/skills/_reference-implementations/backend-express-prisma/SKILL.md +0 -302
  404. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/architecture-overview.md +0 -451
  405. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/async-and-errors.md +0 -307
  406. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/complete-examples.md +0 -638
  407. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/configuration.md +0 -275
  408. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/database-patterns.md +0 -224
  409. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/middleware-guide.md +0 -213
  410. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/routing-and-controllers.md +0 -756
  411. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/sentry-and-monitoring.md +0 -336
  412. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/services-and-repositories.md +0 -789
  413. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/testing-guide.md +0 -235
  414. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/validation-patterns.md +0 -754
  415. package/.claude/skills/_reference-implementations/frontend-react-mui/SKILL.md +0 -399
  416. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/common-patterns.md +0 -331
  417. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/complete-examples.md +0 -872
  418. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/component-patterns.md +0 -502
  419. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/data-fetching.md +0 -767
  420. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/file-organization.md +0 -502
  421. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/loading-and-error-states.md +0 -501
  422. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/performance.md +0 -406
  423. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/routing-guide.md +0 -364
  424. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/styling-guide.md +0 -428
  425. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/typescript-standards.md +0 -418
  426. package/.claude/skills/attention-refresh/SKILL.md +0 -170
  427. package/.claude/skills/brainstorming/SKILL.md +0 -161
  428. package/.claude/skills/cc-devflow-orchestrator/SKILL.md +0 -169
  429. package/.claude/skills/constitution-guardian/SKILL.md +0 -306
  430. package/.claude/skills/constitution-quick-ref/SKILL.md +0 -374
  431. package/.claude/skills/debugging/SKILL.md +0 -221
  432. package/.claude/skills/file-standards/SKILL.md +0 -353
  433. package/.claude/skills/finishing-branch/SKILL.md +0 -189
  434. package/.claude/skills/flow-dev/CLAUDE.md +0 -16
  435. package/.claude/skills/flow-dev/SKILL.md +0 -94
  436. package/.claude/skills/flow-dev/assets/IMPLEMENTATION_PLAN_TEMPLATE.md +0 -71
  437. package/.claude/skills/flow-dev/context.jsonl +0 -4
  438. package/.claude/skills/flow-dev/dev-implementer.jsonl +0 -8
  439. package/.claude/skills/flow-dev/scripts/entry-gate.sh +0 -116
  440. package/.claude/skills/flow-dev/scripts/exit-gate.sh +0 -101
  441. package/.claude/skills/flow-dev/scripts/task-orchestrator.sh +0 -106
  442. package/.claude/skills/flow-fix/SKILL.md +0 -105
  443. package/.claude/skills/flow-fix/context.jsonl +0 -6
  444. package/.claude/skills/flow-fix/references/bug-analyzer.md +0 -381
  445. package/.claude/skills/flow-init/SKILL.md +0 -105
  446. package/.claude/skills/flow-init/assets/BRAINSTORM_TEMPLATE.md +0 -148
  447. package/.claude/skills/flow-init/assets/INIT_FLOW_TEMPLATE.md +0 -198
  448. package/.claude/skills/flow-init/assets/RESEARCH_TEMPLATE.md +0 -276
  449. package/.claude/skills/flow-init/context.jsonl +0 -5
  450. package/.claude/skills/flow-init/references/flow-researcher.md +0 -132
  451. package/.claude/skills/flow-init/scripts/check-prerequisites.sh +0 -240
  452. package/.claude/skills/flow-init/scripts/consolidate-research.sh +0 -182
  453. package/.claude/skills/flow-init/scripts/create-requirement.sh +0 -404
  454. package/.claude/skills/flow-init/scripts/generate-research-tasks.sh +0 -157
  455. package/.claude/skills/flow-init/scripts/populate-research-tasks.sh +0 -284
  456. package/.claude/skills/flow-init/scripts/validate-research.sh +0 -340
  457. package/.claude/skills/flow-quality/SKILL.md +0 -98
  458. package/.claude/skills/flow-quality/context.jsonl +0 -6
  459. package/.claude/skills/flow-quality/references/code-quality-reviewer.md +0 -205
  460. package/.claude/skills/flow-quality/references/qa-tester.md +0 -313
  461. package/.claude/skills/flow-quality/references/security-reviewer.md +0 -314
  462. package/.claude/skills/flow-quality/references/spec-reviewer.md +0 -221
  463. package/.claude/skills/flow-release/SKILL.md +0 -60
  464. package/.claude/skills/flow-release/context.jsonl +0 -5
  465. package/.claude/skills/flow-release/references/release-manager.md +0 -295
  466. package/.claude/skills/flow-spec/CLAUDE.md +0 -17
  467. package/.claude/skills/flow-spec/SKILL.md +0 -102
  468. package/.claude/skills/flow-spec/context.jsonl +0 -5
  469. package/.claude/skills/flow-spec/scripts/entry-gate.sh +0 -194
  470. package/.claude/skills/flow-spec/scripts/exit-gate.sh +0 -244
  471. package/.claude/skills/flow-spec/scripts/parallel-orchestrator.sh +0 -205
  472. package/.claude/skills/flow-spec/scripts/team-communication.sh +0 -353
  473. package/.claude/skills/flow-spec/scripts/team-init.sh +0 -195
  474. package/.claude/skills/flow-spec/scripts/test-team-mode.sh +0 -496
  475. package/.claude/skills/flow-spec/team-config.json +0 -165
  476. package/.claude/skills/flow-verify/CLAUDE.md +0 -10
  477. package/.claude/skills/flow-verify/SKILL.md +0 -53
  478. package/.claude/skills/flow-verify/context.jsonl +0 -5
  479. package/.claude/skills/fractal-docs/SKILL.md +0 -45
  480. package/.claude/skills/journey-checker/SKILL.md +0 -199
  481. package/.claude/skills/journey-checker/pressure-scenarios.md +0 -164
  482. package/.claude/skills/receiving-review/SKILL.md +0 -153
  483. package/.claude/skills/skill-creator/LICENSE.txt +0 -202
  484. package/.claude/skills/skill-creator/SKILL.md +0 -356
  485. package/.claude/skills/skill-creator/references/output-patterns.md +0 -82
  486. package/.claude/skills/skill-creator/references/workflows.md +0 -28
  487. package/.claude/skills/skill-creator/scripts/init_skill.py +0 -303
  488. package/.claude/skills/skill-creator/scripts/package_skill.py +0 -110
  489. package/.claude/skills/skill-creator/scripts/quick_validate.py +0 -95
  490. package/.claude/skills/skill-rules.json +0 -359
  491. package/.claude/skills/tdd/SKILL.md +0 -218
  492. package/.claude/skills/tdd-enforcer/SKILL.md +0 -192
  493. package/.claude/skills/utility/npm-release/CLAUDE.md +0 -55
  494. package/.claude/skills/utility/npm-release/SKILL.md +0 -379
  495. package/.claude/skills/utility/npm-release/references/version-decision-guide.md +0 -134
  496. package/.claude/skills/utility/npm-release/scripts/atomic-version-bump.sh +0 -95
  497. package/.claude/skills/utility/npm-release/scripts/validate-version-sync.sh +0 -82
  498. package/.claude/skills/utility/npm-release/scripts/version-decision-tree.sh +0 -44
  499. package/.claude/skills/verification/SKILL.md +0 -158
  500. package/.claude/skills/workflow.yaml +0 -219
  501. package/.claude/tests/README.md +0 -300
  502. package/.claude/tests/TODO.md +0 -69
  503. package/.claude/tests/__pycache__/test_analyze_upgrade_impact.cpython-311-pytest-7.2.2.pyc +0 -0
  504. package/.claude/tests/__pycache__/test_consolidate_research.cpython-311-pytest-7.2.2.pyc +0 -0
  505. package/.claude/tests/__pycache__/test_export_contracts.cpython-311-pytest-7.2.2.pyc +0 -0
  506. package/.claude/tests/__pycache__/test_extract_data_model.cpython-311-pytest-7.2.2.pyc +0 -0
  507. package/.claude/tests/__pycache__/test_generate_quickstart.cpython-311-pytest-7.2.2.pyc +0 -0
  508. package/.claude/tests/__pycache__/test_generate_research_tasks.cpython-311-pytest-7.2.2.pyc +0 -0
  509. package/.claude/tests/constitution/run_all_constitution_tests.sh +0 -111
  510. package/.claude/tests/constitution/test_agent_assignment.sh +0 -207
  511. package/.claude/tests/constitution/test_article_coverage.sh +0 -201
  512. package/.claude/tests/constitution/test_template_completeness.sh +0 -150
  513. package/.claude/tests/constitution/test_version_consistency.sh +0 -120
  514. package/.claude/tests/fixtures/spec_delta_full.md +0 -16
  515. package/.claude/tests/fixtures/tasks_progress_sample.md +0 -5
  516. package/.claude/tests/run-all-tests.sh +0 -229
  517. package/.claude/tests/scripts/run.sh +0 -30
  518. package/.claude/tests/scripts/test-framework.sh +0 -128
  519. package/.claude/tests/scripts/test_check_prerequisites.sh +0 -511
  520. package/.claude/tests/scripts/test_check_prerequisites.sh.bak +0 -504
  521. package/.claude/tests/scripts/test_check_prerequisites.sh.bak2 +0 -505
  522. package/.claude/tests/scripts/test_check_prerequisites.sh.bak3 +0 -506
  523. package/.claude/tests/scripts/test_check_prerequisites.sh.bak4 +0 -507
  524. package/.claude/tests/scripts/test_check_prerequisites.sh.bak5 +0 -508
  525. package/.claude/tests/scripts/test_check_task_status.sh +0 -499
  526. package/.claude/tests/scripts/test_common.sh +0 -244
  527. package/.claude/tests/scripts/test_generate_status_report.sh +0 -71
  528. package/.claude/tests/scripts/test_mark_task_complete.sh +0 -441
  529. package/.claude/tests/scripts/test_mark_task_complete.sh.backup +0 -410
  530. package/.claude/tests/scripts/test_recover_workflow.sh +0 -304
  531. package/.claude/tests/scripts/test_setup_epic.sh +0 -437
  532. package/.claude/tests/scripts/test_sync_task_marks.sh +0 -196
  533. package/.claude/tests/scripts/test_validate_constitution.sh +0 -74
  534. package/.claude/tests/scripts/test_validate_research.sh +0 -462
  535. package/.claude/tests/slugify.bats +0 -82
  536. package/.claude/tests/test-framework.sh +0 -732
  537. package/.claude/tests/test_analyze_upgrade_impact.py +0 -34
  538. package/.claude/tests/test_consolidate_research.py +0 -48
  539. package/.claude/tests/test_export_contracts.py +0 -43
  540. package/.claude/tests/test_extract_data_model.py +0 -33
  541. package/.claude/tests/test_generate_quickstart.py +0 -50
  542. package/.claude/tests/test_generate_research_tasks.py +0 -52
  543. package/.claude/tsc-cache/70d2fc6d-2936-429b-b529-429f1aae8c88/affected-repos.txt +0 -1
  544. package/.claude/tsc-cache/70d2fc6d-2936-429b-b529-429f1aae8c88/edited-files.log +0 -2
  545. package/bin/harness.js +0 -22
  546. package/docs/commands/core-roadmap.md +0 -106
  547. package/docs/commands/core-roadmap.zh-CN.md +0 -102
  548. package/docs/commands/core-style.md +0 -53
  549. package/docs/commands/core-style.zh-CN.md +0 -53
  550. package/docs/commands/flow-init.md +0 -140
  551. package/docs/commands/flow-init.zh-CN.md +0 -169
  552. package/docs/commands/flow-new.md +0 -39
  553. package/docs/commands/flow-new.zh-CN.md +0 -39
  554. package/lib/compiler/__tests__/compile-regression.test.js +0 -103
  555. package/lib/compiler/__tests__/multi-module-emitters.test.js +0 -534
  556. package/lib/compiler/__tests__/resource-copier.test.js +0 -26
  557. package/lib/compiler/__tests__/skill-discovery.test.js +0 -72
  558. package/lib/compiler/context-expander.js +0 -179
  559. package/lib/compiler/rules-emitters/__tests__/codex-rules-emitter.test.js +0 -109
  560. package/lib/compiler/rules-emitters/codex-rules-emitter.js +0 -116
  561. package/lib/compiler/skill-discovery.js +0 -68
  562. package/lib/harness/CLAUDE.md +0 -22
  563. package/lib/harness/__tests__/planner.tdd.test.js +0 -125
  564. package/lib/harness/cli.js +0 -208
  565. package/lib/harness/index.js +0 -18
  566. package/lib/harness/operations/dispatch.js +0 -298
  567. package/lib/harness/operations/init.js +0 -48
  568. package/lib/harness/operations/pack.js +0 -100
  569. package/lib/harness/operations/plan.js +0 -83
  570. package/lib/harness/operations/release.js +0 -170
  571. package/lib/harness/operations/resume.js +0 -44
  572. package/lib/harness/operations/verify.js +0 -177
  573. package/lib/harness/planner.js +0 -272
  574. package/lib/harness/query.js +0 -126
  575. package/lib/harness/schemas.js +0 -129
package/.claude/docs/templates/UI_PROTOTYPE_TEMPLATE.md DELETED
@@ -1,373 +0,0 @@
1
- ---
2
- title: UI Prototype Template
3
- description: Self-executable template for generating interactive HTML prototypes from PRD
4
- version: 2.0.0
5
- created: 2025-01-10
6
- updated: 2026-03-12
7
- type: self-executable-template
8
- ---
9
-
10
- # UI Prototype Template - 自执行原型生成模板
11
-
12
- **目的**: 从PRD需求文档生成完整的HTML交互原型,融合艺术设计灵感,输出可直接用于开发实现的高质量原型。
13
-
14
- **使用者**: ui-designer研究型代理
15
- **输入**: PRD.md (产品需求文档)
16
- **输出**: UI_PROTOTYPE.html (完整单文件HTML原型)
17
-
18
- ---
19
-
20
- ## ⚠️ CRITICAL ANTI-GENERIC-DESIGN RULES
21
-
22
- ### 强制约束
23
- 1. **NO PLACEHOLDER IMAGES**: 必须使用Picsum真实图片资源
24
- 2. **NO GENERIC PURPLE/BLUE**: 禁止千篇一律的紫色/蓝色AI风格
25
- 3. **NO EMOJI ICONS**: 使用SVG图标或图标库(Lucide/Heroicons/Tabler)
26
- 4. **NO LOREM IPSUM**: 使用真实业务场景内容
27
- 5. **COMPLETE INTERACTIONS**: 所有交互元素必须有完整状态(hover/active/disabled/error)
28
- 6. **ARTISTIC INSPIRATION**: 必须从灵感池采样2位大师并转译风格
29
-
30
- ### 质量标准
31
- - [ ] HTML文件可独立运行(无外部依赖文件)
32
- - [ ] 响应式布局在三种断点正常显示(320px/768px/1024px)
33
- - [ ] 所有PRD用户故事都有对应UI页面或组件
34
- - [ ] 设计系统完整(色彩/字体/栅格/间距/组件)
35
- - [ ] 通过Constitution检查(NO PARTIAL IMPLEMENTATION)
36
-
37
- ---
38
-
39
- ## Execution Flow (10 Phases)
40
-
41
- 本模板的Execution Flow定义了ui-designer代理必须遵循的10个阶段。
42
-
43
- ---
44
-
45
- ### Phase 1: Product Analysis (产品经理分析)
46
-
47
- **目标**: 从PRD中提取核心功能、用户流程和UI需求
48
-
49
- **输入**: PRD.md
50
- **输出**: 产品分析报告(嵌入HTML注释)
51
-
52
- **执行步骤**:
53
- 1. 读取PRD.md文档
54
- 2. 提取关键信息: 用户画像、核心功能、任务流程、非功能需求
55
- 3. 识别页面类型: 认证/仪表盘/列表/详情/表单/设置
56
- 4. 构建信息架构草图
57
- 5. 输出产品分析报告
58
-
59
- **验证点**:
60
- - [x] 至少识别出3个核心功能
61
- - [x] 明确定义了主要用户角色
62
- - [x] 识别出至少2个关键任务流程
63
-
64
- ---
65
-
66
- ### Phase 2: Design Inspiration Sampling (设计灵感采样)
67
-
68
- **目标**: 从80+位艺术家/设计师/建筑师中随机采样2位,生成风格转译说明
69
-
70
- **输入**: 灵感来源池(见 `.claude/docs/examples/design-inspiration-pool.md`)
71
- **输出**: 设计灵感报告(2位大师+转译说明)
72
-
73
- **执行步骤**:
74
- 1. 随机采样策略: 从不同类别选择,避免风格过于相似
75
- 2. 为每位大师生成转译说明(色彩/版式/形态/动效)
76
- 3. 生成设计关键词(3-5个)
77
- 4. 定义配色方案基调(避免常见AI紫/蓝)
78
- 5. 输出设计灵感报告
79
-
80
- **验证点**:
81
- - [x] 采样了2位来自不同类别的大师
82
- - [x] 每位大师都有明确的转译说明
83
- - [x] 明确了禁止模仿的具体作品/元素
84
- - [x] 生成了配色方案基调(非常见AI紫/蓝)
85
-
86
- ---
87
-
88
- ### Phase 3: Design System Definition (设计系统定义)
89
-
90
- **目标**: 基于设计灵感,定义完整的设计系统
91
-
92
- **输入**: Phase 2的设计灵感报告
93
- **输出**: Design Tokens (CSS变量形式)
94
-
95
- **执行步骤**:
96
- 1. 色彩系统: 主色/辅色/中性色/状态色/表面色(禁止纯黑/纯白/常见AI紫蓝)
97
- 2. 字体系统: 字体栈/字号/字重/行高
98
- 3. 间距系统: 基于8px或4px栅格
99
- 4. 栅格系统: 12列/响应式断点
100
- 5. 圆角系统: 4-6级
101
- 6. 阴影系统: 3-5级
102
- 7. 过渡动效: 时长/缓动函数
103
- 8. 输出完整Design Tokens
104
-
105
- **验证点**:
106
- - [x] 色彩系统完整(至少5个主色变体+7个中性色)
107
- - [x] 字体系统完整(字体栈+字阶)
108
- - [x] 间距/栅格/圆角/阴影系统完整
109
- - [x] 所有Token使用CSS变量格式
110
-
111
- ---
112
-
113
- ### Phase 4: Information Architecture (信息架构设计)
114
-
115
- **目标**: 设计页面层级、导航结构和用户流程
116
-
117
- **输入**: Phase 1的产品分析报告
118
- **输出**: 站点地图(Sitemap) + 用户流程图
119
-
120
- **执行步骤**:
121
- 1. 页面层级设计: 一级/二级/三级页面
122
- 2. 导航结构设计: 主导航/侧边栏/面包屑
123
- 3. 用户流程设计: 关键任务路径
124
- 4. 页面间跳转逻辑
125
- 5. 输出站点地图
126
-
127
- **验证点**:
128
- - [x] 所有PRD用户故事都有对应页面
129
- - [x] 导航结构清晰
130
- - [x] 关键流程完整
131
-
132
- ---
133
-
134
- ### Phase 5: Component Inventory (组件清单生成)
135
-
136
- **目标**: 列出所有需要的UI组件
137
-
138
- **输入**: Phase 4的站点地图
139
- **输出**: 组件清单(按类别分组)
140
-
141
- **执行步骤**:
142
- 1. 基础组件: Button/Input/Select/Checkbox/Radio/Switch
143
- 2. 布局组件: Container/Grid/Stack/Divider
144
- 3. 导航组件: Navbar/Sidebar/Breadcrumb/Tabs/Pagination
145
- 4. 数据展示: Table/Card/List/Badge/Tag/Avatar
146
- 5. 反馈组件: Alert/Toast/Modal/Tooltip/Progress/Spinner
147
- 6. 表单组件: Form/FormField/FormError/FormHelp
148
- 7. 业务组件: 根据PRD定义的特定组件
149
- 8. 输出组件清单
150
-
151
- **验证点**:
152
- - [x] 组件清单完整
153
- - [x] 每个组件有明确的用途说明
154
- - [x] 组件按类别分组
155
-
156
- ---
157
-
158
- ### Phase 6: HTML Structure (HTML结构编写)
159
-
160
- **目标**: 编写完整的HTML结构
161
-
162
- **输入**: Phase 4的站点地图 + Phase 5的组件清单
163
- **输出**: HTML结构(嵌入<body>标签)
164
-
165
- **执行步骤**:
166
- 1. HTML5文档结构: <!DOCTYPE html> + <html lang="zh-CN">
167
- 2. <head>元数据: charset/viewport/title/meta
168
- 3. 设计系统元数据(HTML注释): Phase 1/2/3输出
169
- 4. <style>占位符(Phase 7填充)
170
- 5. <body>结构: 根据站点地图实例化所有页面
171
- 6. <script>占位符(Phase 8填充)
172
- 7. 使用语义化标签: <header>/<nav>/<main>/<section>/<article>/<aside>/<footer>
173
- 8. ARIA标签: role/aria-label/aria-labelledby/aria-describedby
174
- 9. 输出完整HTML结构
175
-
176
- **验证点**:
177
- - [x] HTML5语义化标签
178
- - [x] ARIA标签完整
179
- - [x] 所有页面都已实例化
180
- - [x] 设计系统元数据已嵌入注释
181
-
182
- ---
183
-
184
- ### Phase 7: CSS Styling (CSS样式实现)
185
-
186
- **目标**: 基于Phase 3的设计系统,编写完整的CSS样式
187
-
188
- **输入**: Phase 6的HTML结构 + Phase 3的Design Tokens
189
- **输出**: 完整的CSS样式(嵌入<style>标签)
190
-
191
- **执行步骤**:
192
- 1. CSS架构: Design System/Reset/Layout/Components/Pages/Utilities/Responsive/Animations
193
- 2. Design System (CSS Variables): 将Phase 3的Design Tokens写入:root
194
- 3. Reset & Base Styles
195
- 4. Layout System: Flexbox/Grid
196
- 5. Component Styles: 为Phase 5的每个组件编写样式,包含所有状态(hover/active/disabled/error)
197
- 6. Page-Specific Styles
198
- 7. Responsive Design: 三断点媒体查询(320px/768px/1024px)
199
- 8. Animations: 基于Phase 2的设计灵感
200
- 9. Dark Mode (可选)
201
- 10. 输出完整CSS
202
-
203
- **验证点**:
204
- - [x] Design Tokens已转换为CSS变量
205
- - [x] 所有组件有完整状态样式
206
- - [x] 响应式布局正常
207
- - [x] 动效符合设计灵感
208
-
209
- ---
210
-
211
- ### Phase 8: JavaScript Interactions (JavaScript交互实现)
212
-
213
- **目标**: 实现所有交互逻辑
214
-
215
- **输入**: Phase 6的HTML结构
216
- **输出**: 完整的JavaScript代码(嵌入<script>标签)
217
-
218
- **执行步骤**:
219
- 1. 页面路由: SPA单页应用路由逻辑
220
- 2. 表单验证: 实时验证+错误提示
221
- 3. 模态框/抽屉: 打开/关闭逻辑
222
- 4. 下拉菜单/工具提示: 显示/隐藏逻辑
223
- 5. 标签页/手风琴: 切换逻辑
224
- 6. 数据加载: 模拟API调用+加载状态
225
- 7. 搜索/过滤/排序: 列表操作逻辑
226
- 8. 通知/Toast: 显示/自动关闭
227
- 9. 键盘导航: Tab/Enter/Escape支持
228
- 10. 输出完整JavaScript
229
-
230
- **验证点**:
231
- - [x] 所有交互元素可用
232
- - [x] 表单验证完整
233
- - [x] 键盘导航可用
234
- - [x] 无console错误
235
-
236
- ---
237
-
238
- ### Phase 9: Responsive Adaptation (响应式适配)
239
-
240
- **目标**: 确保三断点响应式正常
241
-
242
- **输入**: Phase 7的CSS + Phase 8的JavaScript
243
- **输出**: 响应式优化后的代码
244
-
245
- **执行步骤**:
246
- 1. Mobile (320px-767px): 移动端优先设计
247
- 2. Tablet (768px-1023px): 平板适配
248
- 3. Desktop (1024px+): 桌面端适配
249
- 4. 触摸优化: 按钮最小44x44px
250
- 5. 字体缩放: 移动端基础字号14px,桌面端16px
251
- 6. 图片优化: srcset/loading="lazy"
252
- 7. 性能优化: CSS/JS压缩,关键CSS内联
253
- 8. 输出优化后的代码
254
-
255
- **验证点**:
256
- - [x] 三断点正常显示
257
- - [x] 触摸目标足够大
258
- - [x] 图片加载优化
259
- - [x] 性能达标
260
-
261
- ---
262
-
263
- ### Phase 10: Constitution & Quality Check (宪法与质量检查)
264
-
265
- **目标**: 确保符合Constitution和质量标准
266
-
267
- **输入**: 完整的UI_PROTOTYPE.html
268
- **输出**: 质量检查报告 + 最终HTML文件
269
-
270
- **执行步骤**:
271
- 1. Constitution检查: Article I/III/V/X
272
- 2. Anti-Generic-Design检查: 无占位图/常见AI配色/Emoji/Lorem Ipsum
273
- 3. HTML质量检查: 语义化/ARIA/无重复ID
274
- 4. CSS质量检查: CSS变量/响应式/无!important滥用
275
- 5. JavaScript质量检查: 无全局污染/事件监听器正确/无内存泄漏
276
- 6. 可访问性检查: 色彩对比度≥4.5:1/键盘导航/屏幕阅读器
277
- 7. 性能检查: CDN资源<1s/首屏<2s/交互<100ms
278
- 8. 输出质量检查报告
279
-
280
- **验证点**: 详见 `.claude/docs/examples/ui-prototype-constitution-checklist.md`
281
-
282
- ---
283
-
284
- ## Error Handling
285
-
286
- ### Phase 2失败: 设计灵感采样失败
287
- - **原因**: 灵感池文件不存在或格式错误
288
- - **解决**: 使用默认灵感(现代主义+生成艺术)
289
- - **重试**: 手动指定2位大师
290
-
291
- ### Phase 10失败: Constitution检查失败
292
- - **原因**: 存在占位符/硬编码密钥/不完整实现
293
- - **解决**: 修复违规项
294
- - **重试**: 重新运行Phase 10
295
-
296
- ---
297
-
298
- ## Data Flow
299
-
300
- ```text
301
- PRD.md (Input)
302
- ├─ 用户故事 → Phase 1 (产品分析) → 页面列表
303
- ├─ 非功能需求 → Phase 3 (设计系统) → 性能/可访问性约束
304
- └─ 验收标准 → Phase 8 (交互逻辑) → 验证规则
305
-
306
- UI_PROTOTYPE.html (Output)
307
- ├─ HTML注释 → EPIC生成时的参考资料
308
- ├─ Design System → TASKS生成时的技术约束
309
- └─ Component Inventory → DEV实现时的组件清单
310
- ```
311
-
312
- ---
313
-
314
- ## Best Practices
315
-
316
- ### For ui-designer Agent:
317
-
318
- 1. **严格遵循Execution Flow**: 不跳过任何Phase
319
- 2. **设计灵感采样**: 选择互补而非冲突的风格
320
- 3. **内容真实性**: 图片用Picsum,数据符合业务场景
321
- 4. **响应式优先**: 移动端优先设计(Mobile First)
322
- 5. **可访问性非可选**: ARIA标签/键盘导航/色彩对比度
323
-
324
- ### For Main Agent (Claude):
325
-
326
- 1. **条件触发**: 检测PRD关键词前使用grep -i(忽略大小写)
327
- 2. **状态管理**: 更新orchestration_status.json中的phase
328
- 3. **错误处理**: 记录详细错误到EXECUTION_LOG.md
329
-
330
- ---
331
-
332
- ## Validation Checklist (最终检查清单)
333
-
334
- 在输出UI_PROTOTYPE.html前,确保:
335
-
336
- ### Template Compliance
337
- - [x] 遵循了所有10个Phase的Execution Flow
338
- - [x] 每个Phase的输出都已生成并嵌入HTML注释
339
-
340
- ### Anti-Generic-Design
341
- - [x] 无占位图片(所有图片使用Picsum URL)
342
- - [x] 无常见AI紫色/蓝色配色
343
- - [x] 无Emoji图标(使用SVG或图标库)
344
- - [x] 无Lorem Ipsum占位文本
345
-
346
- ### Constitution Compliance
347
- - [x] Article I - 完整实现,无占位符
348
- - [x] Article III - 无硬编码密钥
349
- - [x] Article V - HTML注释完整,代码可维护
350
- - [x] Article X - 仅实现PRD明确的需求
351
-
352
- ### Quality Standards
353
- - [x] HTML5语义化标签
354
- - [x] ARIA标签完整
355
- - [x] 响应式布局(三断点)
356
- - [x] 交互逻辑完整
357
- - [x] 设计系统完整
358
- - [x] 所有PRD用户故事对齐
359
-
360
- ### Ready for Handoff
361
- - [x] 文件可独立运行(浏览器打开即可查看)
362
- - [x] 开发人员可直接参考实现代码
363
- - [x] 产品经理可用于需求验证
364
- - [x] 设计师可用于设计评审
365
-
366
- ---
367
-
368
- **Template Version**: 2.0.0 (Slimmed from 1375 lines to ~400 lines, -71%)
369
- **Last Updated**: 2026-03-12
370
- **Maintainer**: CC-DevFlow Team
371
- **License**: MIT
372
-
373
- **[PROTOCOL]**: 变更时更新此头部，然后检查 CLAUDE.md
package/.claude/docs/templates/_shared/CLAUDE.md DELETED
@@ -1,36 +0,0 @@
1
- # _shared/ - Shared Template Components
2
-
3
- > L2 | 父级: `.claude/docs/templates/CLAUDE.md`
4
-
5
- ## Purpose
6
-
7
- Reusable template components extracted from PRD/EPIC/TECH_DESIGN/UI_PROTOTYPE templates to reduce duplication and ensure consistency.
8
-
9
- ## Members
10
-
11
- | File | Purpose | Lines | Used By |
12
- |------|---------|-------|---------|
13
- | `CONSTITUTION_CHECK.md` | Constitution compliance check section | ~150 | PRD, EPIC, TECH_DESIGN |
14
- | `VALIDATION_CHECKLIST.md` | Validation checklist patterns | ~100 | All templates |
15
- | `YAML_FRONTMATTER.md` | YAML frontmatter patterns | ~50 | All templates |
16
-
17
- ## Usage Pattern
18
-
19
- Templates reference these components via include syntax:
20
- ```markdown
21
- {{INCLUDE: _shared/CONSTITUTION_CHECK.md}}
22
- {{INCLUDE: _shared/VALIDATION_CHECKLIST.md#prd}}
23
- ```
24
-
25
- Or copy relevant sections based on document type.
26
-
27
- ## Design Principles
28
-
29
- 1. **DRY**: Extract repeated content once, reference everywhere
30
- 2. **Consistency**: Single source of truth for Constitution checks
31
- 3. **Modularity**: Each component is self-contained
32
- 4. **Versioned**: Components track Constitution version
33
-
34
- ---
35
-
36
- [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
package/.claude/docs/templates/_shared/CONSTITUTION_CHECK.md DELETED
@@ -1,125 +0,0 @@
1
- # Constitution Check Template Component
2
-
3
- > **Purpose**: Shared Constitution compliance check section for PRD/EPIC/TECH_DESIGN templates
4
- > **Version**: 1.0.0
5
- > **Reference**: `.claude/rules/project-constitution.md` (v2.1.0)
6
-
7
- ---
8
-
9
- ## Usage
10
-
11
- Include this component in templates via reference:
12
- ```markdown
13
- {{INCLUDE: _shared/CONSTITUTION_CHECK.md}}
14
- ```
15
-
16
- Or copy relevant sections based on document type.
17
-
18
- ---
19
-
20
- ## Constitution Check (宪法符合性检查)
21
-
22
- *GATE: 必须在下一阶段前通过*
23
-
24
- ### Article I: Quality First (质量至上)
25
-
26
- - [ ] **I.1 - NO PARTIAL IMPLEMENTATION**: 内容完整且明确？无占位符和模糊表述？
27
- - [ ] **I.2 - Testing Mandate**: 测试策略明确？覆盖率目标 ≥80%？
28
- - [ ] **I.3 - No Simplification**: 避免"暂时简化，后续完善"的描述？
29
- - [ ] **I.4 - Quality Gates**: 验收标准具体、可测试、可衡量？
30
-
31
- ### Article II: Architectural Consistency (架构一致性)
32
-
33
- - [ ] **II.1 - NO CODE DUPLICATION**: 识别可复用的现有系统和组件？
34
- - [ ] **II.2 - Consistent Naming**: 命名约定遵循现有代码库模式？
35
- - [ ] **II.3 - Anti-Over-Engineering**: 解决方案适合问题规模？无过度设计？
36
- - [ ] **II.4 - Single Responsibility**: 清晰的边界和职责划分？
37
-
38
- ### Article III: Security First (安全优先)
39
-
40
- - [ ] **III.1 - NO HARDCODED SECRETS**: 定义了密钥管理策略（环境变量/密钥服务）？
41
- - [ ] **III.2 - Input Validation**: 输入验证需求明确？
42
- - [ ] **III.3 - Least Privilege**: 身份验证/授权机制清晰？
43
- - [ ] **III.4 - Secure by Default**: 数据加密策略定义？
44
-
45
- ### Article IV: Performance Accountability (性能责任)
46
-
47
- - [ ] **IV.1 - NO RESOURCE LEAKS**: 考虑了资源管理（连接、文件句柄等）？
48
- - [ ] **IV.2 - Algorithm Efficiency**: 性能目标现实且可测量？
49
- - [ ] **IV.3 - Lazy Loading**: 按需加载策略规划？
50
- - [ ] **IV.4 - Caching Strategy**: 规划了监控和缓存策略？
51
-
52
- ### Article V: Maintainability (可维护性)
53
-
54
- - [ ] **V.1 - NO DEAD CODE**: 避免不必要的功能？仅实现明确需求？
55
- - [ ] **V.2 - Separation of Concerns**: 代码易于理解和修改？
56
- - [ ] **V.3 - Documentation**: 文档完整（架构、API、配置）？
57
- - [ ] **V.4 - File Size Limits**: 遵循单一职责原则？单文件 ≤500行？
58
-
59
- ### Article VI: Test-First Development (测试优先开发)
60
-
61
- - [ ] **VI.1 - TDD Mandate**: TDD 流程明确定义？
62
- - [ ] **VI.2 - Test Independence**: 测试隔离策略定义？
63
- - [ ] **VI.3 - Meaningful Tests**: 测试质量标准明确？
64
-
65
- ### Article X: Requirement Boundary (需求边界)
66
-
67
- - [ ] **X.1 - Forced Clarification**: 所有不明确之处标记 `[NEEDS CLARIFICATION]`？
68
- - [ ] **X.2 - No Speculative Features**: 无"可能需要"、"未来会"、"建议添加"的功能？
69
- - [ ] **X.3 - User Story Independence**: 每个故事有明确优先级和独立测试标准？
70
-
71
- ---
72
-
73
- ## Phase -1 Gates (前置闸门)
74
-
75
- *仅适用于 EPIC/TECH_DESIGN*
76
-
77
- ### Simplicity Gate (Article VII)
78
-
79
- - [ ] **项目数量**: 使用 ≤3 个项目/模块？
80
- - [ ] **NO FUTURE-PROOFING**: 没有为"未来可能需要"的功能做准备？
81
- - [ ] **Minimal Dependencies**: 只使用必需的依赖库？
82
-
83
- ### Anti-Abstraction Gate (Article VIII)
84
-
85
- - [ ] **Framework Trust**: 直接使用框架功能，没有封装？
86
- - [ ] **Single Model Representation**: 实体只有一种数据表示？
87
- - [ ] **No Unnecessary Interfaces**: 没有单一实现的接口？
88
-
89
- ### Integration-First Gate (Article IX)
90
-
91
- - [ ] **Contracts Defined First**: API contracts 在实现前定义？
92
- - [ ] **Contract Tests Planned**: Contract tests 在 Phase 2 计划？
93
- - [ ] **Real Environment**: 使用真实数据库而非 mocks？
94
-
95
- ---
96
-
97
- ## Constitutional Violations (宪法违规记录)
98
-
99
- *仅在有需要说明的宪法违规时填写*
100
-
101
- **重要**: 任何违规都必须有充分理由，否则文档不通过
102
-
103
- | 违规的 Article | 具体违规内容 | 为何需要 | 缓解措施 |
104
- |----------------|-------------|----------|----------|
105
- | {{ARTICLE_NUM}} | {{VIOLATION_DETAIL}} | {{JUSTIFICATION}} | {{MITIGATION}} |
106
-
107
- ---
108
-
109
- ## Gate Status Summary
110
-
111
- | Gate | Status | Notes |
112
- |------|--------|-------|
113
- | Article I-V Core | {{PASS/FAIL}} | {{NOTES}} |
114
- | Article VI TDD | {{PASS/FAIL}} | {{NOTES}} |
115
- | Article VII Simplicity | {{PASS/FAIL}} | {{NOTES}} |
116
- | Article VIII Anti-Abstraction | {{PASS/FAIL}} | {{NOTES}} |
117
- | Article IX Integration-First | {{PASS/FAIL}} | {{NOTES}} |
118
- | Article X Boundary | {{PASS/FAIL}} | {{NOTES}} |
119
-
120
- **Overall Status**: {{PASS/FAIL}}
121
- **Ready for Next Phase**: {{YES/NO}}
122
-
123
- ---
124
-
125
- [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md