cc-devflow 4.3.0 → 4.5.0

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