claude-code-workflow 6.0.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 (350) hide show
  1. package/.claude/agents/action-planning-agent.md +778 -0
  2. package/.claude/agents/cli-execution-agent.md +270 -0
  3. package/.claude/agents/cli-explore-agent.md +182 -0
  4. package/.claude/agents/cli-lite-planning-agent.md +396 -0
  5. package/.claude/agents/cli-planning-agent.md +558 -0
  6. package/.claude/agents/code-developer.md +310 -0
  7. package/.claude/agents/conceptual-planning-agent.md +308 -0
  8. package/.claude/agents/context-search-agent.md +582 -0
  9. package/.claude/agents/doc-generator.md +330 -0
  10. package/.claude/agents/memory-bridge.md +94 -0
  11. package/.claude/agents/test-context-search-agent.md +399 -0
  12. package/.claude/agents/test-fix-agent.md +343 -0
  13. package/.claude/agents/ui-design-agent.md +593 -0
  14. package/.claude/agents/universal-executor.md +131 -0
  15. package/.claude/commands/cli/cli-init.md +440 -0
  16. package/.claude/commands/enhance-prompt.md +93 -0
  17. package/.claude/commands/memory/code-map-memory.md +687 -0
  18. package/.claude/commands/memory/docs-full-cli.md +471 -0
  19. package/.claude/commands/memory/docs-related-cli.md +386 -0
  20. package/.claude/commands/memory/docs.md +615 -0
  21. package/.claude/commands/memory/load-skill-memory.md +182 -0
  22. package/.claude/commands/memory/load.md +240 -0
  23. package/.claude/commands/memory/skill-memory.md +525 -0
  24. package/.claude/commands/memory/style-skill-memory.md +396 -0
  25. package/.claude/commands/memory/tech-research.md +477 -0
  26. package/.claude/commands/memory/update-full.md +332 -0
  27. package/.claude/commands/memory/update-related.md +332 -0
  28. package/.claude/commands/memory/workflow-skill-memory.md +517 -0
  29. package/.claude/commands/task/breakdown.md +204 -0
  30. package/.claude/commands/task/create.md +152 -0
  31. package/.claude/commands/task/execute.md +270 -0
  32. package/.claude/commands/task/replan.md +437 -0
  33. package/.claude/commands/version.md +254 -0
  34. package/.claude/commands/workflow/action-plan-verify.md +447 -0
  35. package/.claude/commands/workflow/brainstorm/api-designer.md +585 -0
  36. package/.claude/commands/workflow/brainstorm/artifacts.md +452 -0
  37. package/.claude/commands/workflow/brainstorm/auto-parallel.md +443 -0
  38. package/.claude/commands/workflow/brainstorm/data-architect.md +220 -0
  39. package/.claude/commands/workflow/brainstorm/product-manager.md +200 -0
  40. package/.claude/commands/workflow/brainstorm/product-owner.md +200 -0
  41. package/.claude/commands/workflow/brainstorm/scrum-master.md +200 -0
  42. package/.claude/commands/workflow/brainstorm/subject-matter-expert.md +200 -0
  43. package/.claude/commands/workflow/brainstorm/synthesis.md +398 -0
  44. package/.claude/commands/workflow/brainstorm/system-architect.md +387 -0
  45. package/.claude/commands/workflow/brainstorm/ui-designer.md +221 -0
  46. package/.claude/commands/workflow/brainstorm/ux-expert.md +221 -0
  47. package/.claude/commands/workflow/execute.md +460 -0
  48. package/.claude/commands/workflow/init.md +164 -0
  49. package/.claude/commands/workflow/lite-execute.md +686 -0
  50. package/.claude/commands/workflow/lite-fix.md +621 -0
  51. package/.claude/commands/workflow/lite-plan.md +592 -0
  52. package/.claude/commands/workflow/plan.md +551 -0
  53. package/.claude/commands/workflow/replan.md +515 -0
  54. package/.claude/commands/workflow/review-fix.md +646 -0
  55. package/.claude/commands/workflow/review-module-cycle.md +795 -0
  56. package/.claude/commands/workflow/review-session-cycle.md +805 -0
  57. package/.claude/commands/workflow/review.md +291 -0
  58. package/.claude/commands/workflow/session/complete.md +500 -0
  59. package/.claude/commands/workflow/session/list.md +96 -0
  60. package/.claude/commands/workflow/session/resume.md +61 -0
  61. package/.claude/commands/workflow/session/start.md +200 -0
  62. package/.claude/commands/workflow/status.md +352 -0
  63. package/.claude/commands/workflow/tdd-plan.md +460 -0
  64. package/.claude/commands/workflow/tdd-verify.md +386 -0
  65. package/.claude/commands/workflow/test-cycle-execute.md +498 -0
  66. package/.claude/commands/workflow/test-fix-gen.md +699 -0
  67. package/.claude/commands/workflow/test-gen.md +529 -0
  68. package/.claude/commands/workflow/tools/conflict-resolution.md +680 -0
  69. package/.claude/commands/workflow/tools/context-gather.md +434 -0
  70. package/.claude/commands/workflow/tools/task-generate-agent.md +291 -0
  71. package/.claude/commands/workflow/tools/task-generate-tdd.md +518 -0
  72. package/.claude/commands/workflow/tools/tdd-coverage-analysis.md +309 -0
  73. package/.claude/commands/workflow/tools/test-concept-enhanced.md +163 -0
  74. package/.claude/commands/workflow/tools/test-context-gather.md +235 -0
  75. package/.claude/commands/workflow/tools/test-task-generate.md +256 -0
  76. package/.claude/commands/workflow/ui-design/animation-extract.md +1150 -0
  77. package/.claude/commands/workflow/ui-design/codify-style.md +652 -0
  78. package/.claude/commands/workflow/ui-design/design-sync.md +454 -0
  79. package/.claude/commands/workflow/ui-design/explore-auto.md +678 -0
  80. package/.claude/commands/workflow/ui-design/generate.md +504 -0
  81. package/.claude/commands/workflow/ui-design/imitate-auto.md +745 -0
  82. package/.claude/commands/workflow/ui-design/import-from-code.md +537 -0
  83. package/.claude/commands/workflow/ui-design/layout-extract.md +788 -0
  84. package/.claude/commands/workflow/ui-design/reference-page-generator.md +356 -0
  85. package/.claude/commands/workflow/ui-design/style-extract.md +773 -0
  86. package/.claude/scripts/classify-folders.sh +35 -0
  87. package/.claude/scripts/convert_tokens_to_css.sh +225 -0
  88. package/.claude/scripts/detect_changed_modules.sh +157 -0
  89. package/.claude/scripts/discover-design-files.sh +83 -0
  90. package/.claude/scripts/extract-animations.js +243 -0
  91. package/.claude/scripts/extract-computed-styles.js +118 -0
  92. package/.claude/scripts/extract-layout-structure.js +411 -0
  93. package/.claude/scripts/generate_module_docs.sh +713 -0
  94. package/.claude/scripts/get_modules_by_depth.sh +166 -0
  95. package/.claude/scripts/ui-generate-preview.sh +391 -0
  96. package/.claude/scripts/ui-instantiate-prototypes.sh +811 -0
  97. package/.claude/scripts/update_module_claude.sh +333 -0
  98. package/.claude/skills/command-guide/SKILL.md +388 -0
  99. package/.claude/skills/command-guide/UPDATE-GUIDELINE.md +592 -0
  100. package/.claude/skills/command-guide/guides/cli-tools-guide.md +410 -0
  101. package/.claude/skills/command-guide/guides/examples.md +537 -0
  102. package/.claude/skills/command-guide/guides/getting-started.md +242 -0
  103. package/.claude/skills/command-guide/guides/implementation-details.md +1010 -0
  104. package/.claude/skills/command-guide/guides/index-structure.md +326 -0
  105. package/.claude/skills/command-guide/guides/troubleshooting.md +92 -0
  106. package/.claude/skills/command-guide/guides/ui-design-workflow-guide.md +316 -0
  107. package/.claude/skills/command-guide/guides/workflow-patterns.md +662 -0
  108. package/.claude/skills/command-guide/index/all-commands.json +783 -0
  109. package/.claude/skills/command-guide/index/by-category.json +811 -0
  110. package/.claude/skills/command-guide/index/by-use-case.json +797 -0
  111. package/.claude/skills/command-guide/index/command-relationships.json +307 -0
  112. package/.claude/skills/command-guide/index/essential-commands.json +123 -0
  113. package/.claude/skills/command-guide/reference/agents/action-planning-agent.md +722 -0
  114. package/.claude/skills/command-guide/reference/agents/cli-execution-agent.md +270 -0
  115. package/.claude/skills/command-guide/reference/agents/cli-explore-agent.md +182 -0
  116. package/.claude/skills/command-guide/reference/agents/cli-lite-planning-agent.md +396 -0
  117. package/.claude/skills/command-guide/reference/agents/cli-planning-agent.md +558 -0
  118. package/.claude/skills/command-guide/reference/agents/code-developer.md +310 -0
  119. package/.claude/skills/command-guide/reference/agents/conceptual-planning-agent.md +328 -0
  120. package/.claude/skills/command-guide/reference/agents/context-search-agent.md +577 -0
  121. package/.claude/skills/command-guide/reference/agents/doc-generator.md +330 -0
  122. package/.claude/skills/command-guide/reference/agents/memory-bridge.md +94 -0
  123. package/.claude/skills/command-guide/reference/agents/test-context-search-agent.md +399 -0
  124. package/.claude/skills/command-guide/reference/agents/test-fix-agent.md +343 -0
  125. package/.claude/skills/command-guide/reference/agents/ui-design-agent.md +593 -0
  126. package/.claude/skills/command-guide/reference/agents/universal-executor.md +131 -0
  127. package/.claude/skills/command-guide/reference/commands/cli/cli-init.md +440 -0
  128. package/.claude/skills/command-guide/reference/commands/enhance-prompt.md +93 -0
  129. package/.claude/skills/command-guide/reference/commands/memory/code-map-memory.md +687 -0
  130. package/.claude/skills/command-guide/reference/commands/memory/docs-full-cli.md +471 -0
  131. package/.claude/skills/command-guide/reference/commands/memory/docs-related-cli.md +386 -0
  132. package/.claude/skills/command-guide/reference/commands/memory/docs.md +610 -0
  133. package/.claude/skills/command-guide/reference/commands/memory/load-skill-memory.md +182 -0
  134. package/.claude/skills/command-guide/reference/commands/memory/load.md +240 -0
  135. package/.claude/skills/command-guide/reference/commands/memory/skill-memory.md +525 -0
  136. package/.claude/skills/command-guide/reference/commands/memory/style-skill-memory.md +396 -0
  137. package/.claude/skills/command-guide/reference/commands/memory/tech-research.md +477 -0
  138. package/.claude/skills/command-guide/reference/commands/memory/update-full.md +332 -0
  139. package/.claude/skills/command-guide/reference/commands/memory/update-related.md +332 -0
  140. package/.claude/skills/command-guide/reference/commands/memory/workflow-skill-memory.md +517 -0
  141. package/.claude/skills/command-guide/reference/commands/task/breakdown.md +204 -0
  142. package/.claude/skills/command-guide/reference/commands/task/create.md +152 -0
  143. package/.claude/skills/command-guide/reference/commands/task/execute.md +270 -0
  144. package/.claude/skills/command-guide/reference/commands/task/replan.md +437 -0
  145. package/.claude/skills/command-guide/reference/commands/version.md +254 -0
  146. package/.claude/skills/command-guide/reference/commands/workflow/action-plan-verify.md +447 -0
  147. package/.claude/skills/command-guide/reference/commands/workflow/brainstorm/api-designer.md +585 -0
  148. package/.claude/skills/command-guide/reference/commands/workflow/brainstorm/artifacts.md +604 -0
  149. package/.claude/skills/command-guide/reference/commands/workflow/brainstorm/auto-parallel.md +466 -0
  150. package/.claude/skills/command-guide/reference/commands/workflow/brainstorm/data-architect.md +220 -0
  151. package/.claude/skills/command-guide/reference/commands/workflow/brainstorm/product-manager.md +200 -0
  152. package/.claude/skills/command-guide/reference/commands/workflow/brainstorm/product-owner.md +200 -0
  153. package/.claude/skills/command-guide/reference/commands/workflow/brainstorm/scrum-master.md +200 -0
  154. package/.claude/skills/command-guide/reference/commands/workflow/brainstorm/subject-matter-expert.md +200 -0
  155. package/.claude/skills/command-guide/reference/commands/workflow/brainstorm/synthesis.md +496 -0
  156. package/.claude/skills/command-guide/reference/commands/workflow/brainstorm/system-architect.md +387 -0
  157. package/.claude/skills/command-guide/reference/commands/workflow/brainstorm/ui-designer.md +221 -0
  158. package/.claude/skills/command-guide/reference/commands/workflow/brainstorm/ux-expert.md +221 -0
  159. package/.claude/skills/command-guide/reference/commands/workflow/execute.md +460 -0
  160. package/.claude/skills/command-guide/reference/commands/workflow/init.md +164 -0
  161. package/.claude/skills/command-guide/reference/commands/workflow/lite-execute.md +634 -0
  162. package/.claude/skills/command-guide/reference/commands/workflow/lite-fix.md +602 -0
  163. package/.claude/skills/command-guide/reference/commands/workflow/lite-plan.md +582 -0
  164. package/.claude/skills/command-guide/reference/commands/workflow/plan.md +551 -0
  165. package/.claude/skills/command-guide/reference/commands/workflow/replan.md +515 -0
  166. package/.claude/skills/command-guide/reference/commands/workflow/review-fix.md +646 -0
  167. package/.claude/skills/command-guide/reference/commands/workflow/review-module-cycle.md +795 -0
  168. package/.claude/skills/command-guide/reference/commands/workflow/review-session-cycle.md +805 -0
  169. package/.claude/skills/command-guide/reference/commands/workflow/review.md +291 -0
  170. package/.claude/skills/command-guide/reference/commands/workflow/session/complete.md +500 -0
  171. package/.claude/skills/command-guide/reference/commands/workflow/session/list.md +96 -0
  172. package/.claude/skills/command-guide/reference/commands/workflow/session/resume.md +61 -0
  173. package/.claude/skills/command-guide/reference/commands/workflow/session/start.md +180 -0
  174. package/.claude/skills/command-guide/reference/commands/workflow/status.md +352 -0
  175. package/.claude/skills/command-guide/reference/commands/workflow/tdd-plan.md +460 -0
  176. package/.claude/skills/command-guide/reference/commands/workflow/tdd-verify.md +386 -0
  177. package/.claude/skills/command-guide/reference/commands/workflow/test-cycle-execute.md +498 -0
  178. package/.claude/skills/command-guide/reference/commands/workflow/test-fix-gen.md +699 -0
  179. package/.claude/skills/command-guide/reference/commands/workflow/test-gen.md +529 -0
  180. package/.claude/skills/command-guide/reference/commands/workflow/tools/conflict-resolution.md +680 -0
  181. package/.claude/skills/command-guide/reference/commands/workflow/tools/context-gather.md +434 -0
  182. package/.claude/skills/command-guide/reference/commands/workflow/tools/task-generate-agent.md +151 -0
  183. package/.claude/skills/command-guide/reference/commands/workflow/tools/task-generate-tdd.md +518 -0
  184. package/.claude/skills/command-guide/reference/commands/workflow/tools/tdd-coverage-analysis.md +309 -0
  185. package/.claude/skills/command-guide/reference/commands/workflow/tools/test-concept-enhanced.md +163 -0
  186. package/.claude/skills/command-guide/reference/commands/workflow/tools/test-context-gather.md +235 -0
  187. package/.claude/skills/command-guide/reference/commands/workflow/tools/test-task-generate.md +256 -0
  188. package/.claude/skills/command-guide/reference/commands/workflow/ui-design/animation-extract.md +1150 -0
  189. package/.claude/skills/command-guide/reference/commands/workflow/ui-design/codify-style.md +652 -0
  190. package/.claude/skills/command-guide/reference/commands/workflow/ui-design/design-sync.md +454 -0
  191. package/.claude/skills/command-guide/reference/commands/workflow/ui-design/explore-auto.md +678 -0
  192. package/.claude/skills/command-guide/reference/commands/workflow/ui-design/generate.md +504 -0
  193. package/.claude/skills/command-guide/reference/commands/workflow/ui-design/imitate-auto.md +745 -0
  194. package/.claude/skills/command-guide/reference/commands/workflow/ui-design/import-from-code.md +537 -0
  195. package/.claude/skills/command-guide/reference/commands/workflow/ui-design/layout-extract.md +788 -0
  196. package/.claude/skills/command-guide/reference/commands/workflow/ui-design/reference-page-generator.md +356 -0
  197. package/.claude/skills/command-guide/reference/commands/workflow/ui-design/style-extract.md +773 -0
  198. package/.claude/skills/command-guide/scripts/analyze_commands.py +502 -0
  199. package/.claude/skills/command-guide/scripts/update-index.sh +130 -0
  200. package/.claude/skills/command-guide/templates/issue-bug.md +104 -0
  201. package/.claude/skills/command-guide/templates/issue-diagnosis.md +275 -0
  202. package/.claude/skills/command-guide/templates/issue-feature.md +97 -0
  203. package/.claude/skills/command-guide/templates/issue-question.md +141 -0
  204. package/.claude/skills/prompt-enhancer/SKILL.md +124 -0
  205. package/.claude/workflows/_template-compare-matrix.html +692 -0
  206. package/.claude/workflows/cli-templates/fix-plan-template.json +75 -0
  207. package/.claude/workflows/cli-templates/fix-progress-template.json +48 -0
  208. package/.claude/workflows/cli-templates/memory/style-skill-memory/skill-md-template.md +299 -0
  209. package/.claude/workflows/cli-templates/planning-roles/data-architect.md +120 -0
  210. package/.claude/workflows/cli-templates/planning-roles/product-manager.md +119 -0
  211. package/.claude/workflows/cli-templates/planning-roles/product-owner.md +261 -0
  212. package/.claude/workflows/cli-templates/planning-roles/scrum-master.md +186 -0
  213. package/.claude/workflows/cli-templates/planning-roles/subject-matter-expert.md +281 -0
  214. package/.claude/workflows/cli-templates/planning-roles/synthesis-role.md +414 -0
  215. package/.claude/workflows/cli-templates/planning-roles/system-architect.md +106 -0
  216. package/.claude/workflows/cli-templates/planning-roles/test-strategist.md +124 -0
  217. package/.claude/workflows/cli-templates/planning-roles/ui-designer.md +379 -0
  218. package/.claude/workflows/cli-templates/planning-roles/ux-expert.md +240 -0
  219. package/.claude/workflows/cli-templates/prompts/analysis/01-diagnose-bug-root-cause.txt +127 -0
  220. package/.claude/workflows/cli-templates/prompts/analysis/01-trace-code-execution.txt +115 -0
  221. package/.claude/workflows/cli-templates/prompts/analysis/02-analyze-code-patterns.txt +37 -0
  222. package/.claude/workflows/cli-templates/prompts/analysis/02-analyze-technical-document.txt +33 -0
  223. package/.claude/workflows/cli-templates/prompts/analysis/02-review-architecture.txt +29 -0
  224. package/.claude/workflows/cli-templates/prompts/analysis/02-review-code-quality.txt +28 -0
  225. package/.claude/workflows/cli-templates/prompts/analysis/03-analyze-performance.txt +29 -0
  226. package/.claude/workflows/cli-templates/prompts/analysis/03-assess-security-risks.txt +29 -0
  227. package/.claude/workflows/cli-templates/prompts/analysis/03-review-quality-standards.txt +29 -0
  228. package/.claude/workflows/cli-templates/prompts/development/02-generate-tests.txt +70 -0
  229. package/.claude/workflows/cli-templates/prompts/development/02-implement-component-ui.txt +55 -0
  230. package/.claude/workflows/cli-templates/prompts/development/02-implement-feature.txt +58 -0
  231. package/.claude/workflows/cli-templates/prompts/development/02-refactor-codebase.txt +55 -0
  232. package/.claude/workflows/cli-templates/prompts/development/03-debug-runtime-issues.txt +55 -0
  233. package/.claude/workflows/cli-templates/prompts/documentation/api.txt +15 -0
  234. package/.claude/workflows/cli-templates/prompts/documentation/folder-navigation.txt +27 -0
  235. package/.claude/workflows/cli-templates/prompts/documentation/module-readme.txt +49 -0
  236. package/.claude/workflows/cli-templates/prompts/documentation/project-architecture.txt +41 -0
  237. package/.claude/workflows/cli-templates/prompts/documentation/project-examples.txt +35 -0
  238. package/.claude/workflows/cli-templates/prompts/documentation/project-readme.txt +35 -0
  239. package/.claude/workflows/cli-templates/prompts/memory/02-document-module-structure.txt +165 -0
  240. package/.claude/workflows/cli-templates/prompts/planning/01-plan-architecture-design.txt +109 -0
  241. package/.claude/workflows/cli-templates/prompts/planning/02-breakdown-task-steps.txt +30 -0
  242. package/.claude/workflows/cli-templates/prompts/planning/02-design-component-spec.txt +28 -0
  243. package/.claude/workflows/cli-templates/prompts/planning/03-evaluate-concept-feasibility.txt +127 -0
  244. package/.claude/workflows/cli-templates/prompts/planning/03-plan-migration-strategy.txt +30 -0
  245. package/.claude/workflows/cli-templates/prompts/tech/tech-module-format.txt +359 -0
  246. package/.claude/workflows/cli-templates/prompts/tech/tech-skill-index.txt +185 -0
  247. package/.claude/workflows/cli-templates/prompts/test/test-concept-analysis.txt +179 -0
  248. package/.claude/workflows/cli-templates/prompts/universal/00-universal-creative-style.txt +95 -0
  249. package/.claude/workflows/cli-templates/prompts/universal/00-universal-rigorous-style.txt +92 -0
  250. package/.claude/workflows/cli-templates/prompts/verification/codex-technical.txt +28 -0
  251. package/.claude/workflows/cli-templates/prompts/verification/cross-validation.txt +28 -0
  252. package/.claude/workflows/cli-templates/prompts/verification/gemini-strategic.txt +27 -0
  253. package/.claude/workflows/cli-templates/prompts/workflow/analysis-results-structure.txt +224 -0
  254. package/.claude/workflows/cli-templates/prompts/workflow/codex-feasibility-validation.txt +176 -0
  255. package/.claude/workflows/cli-templates/prompts/workflow/gemini-solution-design.txt +131 -0
  256. package/.claude/workflows/cli-templates/prompts/workflow/impl-plan-template.txt +286 -0
  257. package/.claude/workflows/cli-templates/prompts/workflow/skill-aggregation.txt +172 -0
  258. package/.claude/workflows/cli-templates/prompts/workflow/skill-conflict-patterns.txt +98 -0
  259. package/.claude/workflows/cli-templates/prompts/workflow/skill-index.txt +224 -0
  260. package/.claude/workflows/cli-templates/prompts/workflow/skill-lessons-learned.txt +98 -0
  261. package/.claude/workflows/cli-templates/prompts/workflow/skill-sessions-timeline.txt +53 -0
  262. package/.claude/workflows/cli-templates/prompts/workflow/task-json-agent-mode.txt +123 -0
  263. package/.claude/workflows/cli-templates/prompts/workflow/task-json-cli-mode.txt +182 -0
  264. package/.claude/workflows/cli-templates/schemas/diagnosis-json-schema.json +234 -0
  265. package/.claude/workflows/cli-templates/schemas/explore-json-schema.json +124 -0
  266. package/.claude/workflows/cli-templates/schemas/fix-plan-json-schema.json +273 -0
  267. package/.claude/workflows/cli-templates/schemas/plan-json-schema.json +219 -0
  268. package/.claude/workflows/cli-templates/schemas/project-json-schema.json +221 -0
  269. package/.claude/workflows/cli-templates/schemas/review-deep-dive-results-schema.json +82 -0
  270. package/.claude/workflows/cli-templates/schemas/review-dimension-results-schema.json +51 -0
  271. package/.claude/workflows/cli-templates/tech-stacks/go-dev.md +91 -0
  272. package/.claude/workflows/cli-templates/tech-stacks/java-dev.md +107 -0
  273. package/.claude/workflows/cli-templates/tech-stacks/javascript-dev.md +58 -0
  274. package/.claude/workflows/cli-templates/tech-stacks/python-dev.md +79 -0
  275. package/.claude/workflows/cli-templates/tech-stacks/react-dev.md +103 -0
  276. package/.claude/workflows/cli-templates/tech-stacks/typescript-dev.md +83 -0
  277. package/.claude/workflows/cli-templates/ui-design/systems/animation-tokens.json +247 -0
  278. package/.claude/workflows/cli-templates/ui-design/systems/design-tokens.json +342 -0
  279. package/.claude/workflows/cli-templates/ui-design/systems/layout-templates.json +145 -0
  280. package/.claude/workflows/context-search-strategy.md +77 -0
  281. package/.claude/workflows/intelligent-tools-strategy.md +662 -0
  282. package/.claude/workflows/review-directory-specification.md +336 -0
  283. package/.claude/workflows/task-core.md +214 -0
  284. package/.claude/workflows/tool-strategy.md +71 -0
  285. package/.claude/workflows/workflow-architecture.md +942 -0
  286. package/.codex/AGENTS.md +330 -0
  287. package/.gemini/GEMINI.md +164 -0
  288. package/.qwen/QWEN.md +164 -0
  289. package/CLAUDE.md +91 -0
  290. package/LICENSE +21 -0
  291. package/README.md +219 -0
  292. package/ccw/README.md +121 -0
  293. package/ccw/bin/ccw.js +10 -0
  294. package/ccw/src/cli.js +100 -0
  295. package/ccw/src/commands/install.js +324 -0
  296. package/ccw/src/commands/list.js +37 -0
  297. package/ccw/src/commands/serve.js +67 -0
  298. package/ccw/src/commands/uninstall.js +238 -0
  299. package/ccw/src/commands/upgrade.js +307 -0
  300. package/ccw/src/commands/view.js +14 -0
  301. package/ccw/src/core/dashboard-generator-patch.js +29 -0
  302. package/ccw/src/core/dashboard-generator.js +667 -0
  303. package/ccw/src/core/data-aggregator.js +409 -0
  304. package/ccw/src/core/lite-scanner.js +290 -0
  305. package/ccw/src/core/manifest.js +201 -0
  306. package/ccw/src/core/server.js +1327 -0
  307. package/ccw/src/core/server.js.bak +385 -0
  308. package/ccw/src/core/server_original.bak +385 -0
  309. package/ccw/src/core/session-scanner.js +235 -0
  310. package/ccw/src/index.js +9 -0
  311. package/ccw/src/templates/dashboard-js/api.js +200 -0
  312. package/ccw/src/templates/dashboard-js/components/_conflict_tab.js +112 -0
  313. package/ccw/src/templates/dashboard-js/components/_exp_helpers.js +54 -0
  314. package/ccw/src/templates/dashboard-js/components/_review_tab.js +640 -0
  315. package/ccw/src/templates/dashboard-js/components/carousel.js +398 -0
  316. package/ccw/src/templates/dashboard-js/components/flowchart.js +493 -0
  317. package/ccw/src/templates/dashboard-js/components/hook-manager.js +273 -0
  318. package/ccw/src/templates/dashboard-js/components/mcp-manager.js +506 -0
  319. package/ccw/src/templates/dashboard-js/components/modals.js +260 -0
  320. package/ccw/src/templates/dashboard-js/components/navigation.js +239 -0
  321. package/ccw/src/templates/dashboard-js/components/notifications.js +194 -0
  322. package/ccw/src/templates/dashboard-js/components/sidebar.js +31 -0
  323. package/ccw/src/templates/dashboard-js/components/tabs-context.js +1093 -0
  324. package/ccw/src/templates/dashboard-js/components/tabs-other.js +273 -0
  325. package/ccw/src/templates/dashboard-js/components/task-drawer-core.js +477 -0
  326. package/ccw/src/templates/dashboard-js/components/task-drawer-renderers.js +447 -0
  327. package/ccw/src/templates/dashboard-js/components/theme.js +21 -0
  328. package/ccw/src/templates/dashboard-js/main.js +57 -0
  329. package/ccw/src/templates/dashboard-js/state.js +37 -0
  330. package/ccw/src/templates/dashboard-js/utils.js +153 -0
  331. package/ccw/src/templates/dashboard-js/views/fix-session.js +180 -0
  332. package/ccw/src/templates/dashboard-js/views/home.js +193 -0
  333. package/ccw/src/templates/dashboard-js/views/hook-manager.js +387 -0
  334. package/ccw/src/templates/dashboard-js/views/lite-tasks.js +390 -0
  335. package/ccw/src/templates/dashboard-js/views/mcp-manager.js +271 -0
  336. package/ccw/src/templates/dashboard-js/views/project-overview.js +246 -0
  337. package/ccw/src/templates/dashboard-js/views/review-session.js +711 -0
  338. package/ccw/src/templates/dashboard-js/views/session-detail.js +770 -0
  339. package/ccw/src/templates/dashboard.css +7660 -0
  340. package/ccw/src/templates/dashboard.html +630 -0
  341. package/ccw/src/templates/dashboard_tailwind.html +42 -0
  342. package/ccw/src/templates/dashboard_test.html +37 -0
  343. package/ccw/src/templates/review-cycle-dashboard.html +1930 -0
  344. package/ccw/src/templates/tailwind-base.css +212 -0
  345. package/ccw/src/templates/workflow-dashboard.html +401 -0
  346. package/ccw/src/utils/browser-launcher.js +49 -0
  347. package/ccw/src/utils/file-utils.js +48 -0
  348. package/ccw/src/utils/path-resolver.js +279 -0
  349. package/ccw/src/utils/ui.js +148 -0
  350. package/package.json +66 -0
@@ -0,0 +1,621 @@
1
+ ---
2
+ name: lite-fix
3
+ description: Lightweight bug diagnosis and fix workflow with intelligent severity assessment and optional hotfix mode for production incidents
4
+ argument-hint: "[--hotfix] \"bug description or issue reference\""
5
+ allowed-tools: TodoWrite(*), Task(*), SlashCommand(*), AskUserQuestion(*)
6
+ ---
7
+
8
+ # Workflow Lite-Fix Command (/workflow:lite-fix)
9
+
10
+ ## Overview
11
+
12
+ Intelligent lightweight bug fixing command with dynamic workflow adaptation based on severity assessment. Focuses on diagnosis phases (root cause analysis, impact assessment, fix planning, confirmation) and delegates execution to `/workflow:lite-execute`.
13
+
14
+ **Core capabilities:**
15
+ - Intelligent bug analysis with automatic severity detection
16
+ - Dynamic code diagnosis (cli-explore-agent) for root cause identification
17
+ - Interactive clarification after diagnosis to gather missing information
18
+ - Adaptive fix planning strategy (direct Claude vs cli-lite-planning-agent) based on complexity
19
+ - Two-step confirmation: fix-plan display -> multi-dimensional input collection
20
+ - Execution dispatch with complete context handoff to lite-execute
21
+
22
+ ## Usage
23
+
24
+ ```bash
25
+ /workflow:lite-fix [FLAGS] <BUG_DESCRIPTION>
26
+
27
+ # Flags
28
+ --hotfix, -h Production hotfix mode (minimal diagnosis, fast fix)
29
+
30
+ # Arguments
31
+ <bug-description> Bug description, error message, or path to .md file (required)
32
+ ```
33
+
34
+ ## Execution Process
35
+
36
+ ```
37
+ Phase 1: Bug Analysis & Diagnosis
38
+ |- Parse input (description, error message, or .md file)
39
+ |- Intelligent severity pre-assessment (Low/Medium/High/Critical)
40
+ |- Diagnosis decision (auto-detect or --hotfix flag)
41
+ |- Context protection: If file reading >=50k chars -> force cli-explore-agent
42
+ +- Decision:
43
+ |- needsDiagnosis=true -> Launch parallel cli-explore-agents (1-4 based on severity)
44
+ +- needsDiagnosis=false (hotfix) -> Skip directly to Phase 3 (Fix Planning)
45
+
46
+ Phase 2: Clarification (optional, multi-round)
47
+ |- Aggregate clarification_needs from all diagnosis angles
48
+ |- Deduplicate similar questions
49
+ +- Decision:
50
+ |- Has clarifications -> AskUserQuestion (max 4 questions per round, multiple rounds allowed)
51
+ +- No clarifications -> Skip to Phase 3
52
+
53
+ Phase 3: Fix Planning (NO CODE EXECUTION - planning only)
54
+ +- Decision (based on Phase 1 severity):
55
+ |- Low/Medium -> Load schema: cat ~/.claude/workflows/cli-templates/schemas/fix-plan-json-schema.json -> Direct Claude planning (following schema) -> fix-plan.json -> MUST proceed to Phase 4
56
+ +- High/Critical -> cli-lite-planning-agent -> fix-plan.json -> MUST proceed to Phase 4
57
+
58
+ Phase 4: Confirmation & Selection
59
+ |- Display fix-plan summary (tasks, severity, estimated time)
60
+ +- AskUserQuestion:
61
+ |- Confirm: Allow / Modify / Cancel
62
+ |- Execution: Agent / Codex / Auto
63
+ +- Review: Gemini / Agent / Skip
64
+
65
+ Phase 5: Dispatch
66
+ |- Build executionContext (fix-plan + diagnoses + clarifications + selections)
67
+ +- SlashCommand("/workflow:lite-execute --in-memory --mode bugfix")
68
+ ```
69
+
70
+ ## Implementation
71
+
72
+ ### Phase 1: Intelligent Multi-Angle Diagnosis
73
+
74
+ **Session Setup** (MANDATORY - follow exactly):
75
+ ```javascript
76
+ // Helper: Get UTC+8 (China Standard Time) ISO string
77
+ const getUtc8ISOString = () => new Date(Date.now() + 8 * 60 * 60 * 1000).toISOString()
78
+
79
+ const bugSlug = bug_description.toLowerCase().replace(/[^a-z0-9]+/g, '-').substring(0, 40)
80
+ const dateStr = getUtc8ISOString().substring(0, 10) // Format: 2025-11-29
81
+
82
+ const sessionId = `${bugSlug}-${dateStr}` // e.g., "user-avatar-upload-fails-2025-11-29"
83
+ const sessionFolder = `.workflow/.lite-fix/${sessionId}`
84
+
85
+ bash(`mkdir -p ${sessionFolder} && test -d ${sessionFolder} && echo "SUCCESS: ${sessionFolder}" || echo "FAILED: ${sessionFolder}"`)
86
+ ```
87
+
88
+ **Diagnosis Decision Logic**:
89
+ ```javascript
90
+ const hotfixMode = $ARGUMENTS.includes('--hotfix') || $ARGUMENTS.includes('-h')
91
+
92
+ needsDiagnosis = (
93
+ !hotfixMode &&
94
+ (
95
+ bug.lacks_specific_error_message ||
96
+ bug.requires_codebase_context ||
97
+ bug.needs_execution_tracing ||
98
+ bug.root_cause_unclear
99
+ )
100
+ )
101
+
102
+ if (!needsDiagnosis) {
103
+ // Skip to Phase 2 (Clarification) or Phase 3 (Fix Planning)
104
+ proceed_to_next_phase()
105
+ }
106
+ ```
107
+
108
+ **Context Protection**: File reading >=50k chars -> force `needsDiagnosis=true` (delegate to cli-explore-agent)
109
+
110
+ **Severity Pre-Assessment** (Intelligent Analysis):
111
+ ```javascript
112
+ // Analyzes bug severity based on:
113
+ // - Symptoms: Error messages, crash reports, user complaints
114
+ // - Scope: How many users/features are affected?
115
+ // - Urgency: Production down vs minor inconvenience
116
+ // - Impact: Data loss, security, business impact
117
+
118
+ const severity = analyzeBugSeverity(bug_description)
119
+ // Returns: 'Low' | 'Medium' | 'High' | 'Critical'
120
+ // Low: Minor UI issue, localized, no data impact
121
+ // Medium: Multiple users affected, degraded functionality
122
+ // High: Significant functionality broken, many users affected
123
+ // Critical: Production down, data loss risk, security issue
124
+
125
+ // Angle assignment based on bug type (orchestrator decides, not agent)
126
+ const DIAGNOSIS_ANGLE_PRESETS = {
127
+ runtime_error: ['error-handling', 'dataflow', 'state-management', 'edge-cases'],
128
+ performance: ['performance', 'bottlenecks', 'caching', 'data-access'],
129
+ security: ['security', 'auth-patterns', 'dataflow', 'validation'],
130
+ data_corruption: ['data-integrity', 'state-management', 'transactions', 'validation'],
131
+ ui_bug: ['state-management', 'event-handling', 'rendering', 'data-binding'],
132
+ integration: ['api-contracts', 'error-handling', 'timeouts', 'fallbacks']
133
+ }
134
+
135
+ function selectDiagnosisAngles(bugDescription, count) {
136
+ const text = bugDescription.toLowerCase()
137
+ let preset = 'runtime_error' // default
138
+
139
+ if (/slow|timeout|performance|lag|hang/.test(text)) preset = 'performance'
140
+ else if (/security|auth|permission|access|token/.test(text)) preset = 'security'
141
+ else if (/corrupt|data|lost|missing|inconsistent/.test(text)) preset = 'data_corruption'
142
+ else if (/ui|display|render|style|click|button/.test(text)) preset = 'ui_bug'
143
+ else if (/api|integration|connect|request|response/.test(text)) preset = 'integration'
144
+
145
+ return DIAGNOSIS_ANGLE_PRESETS[preset].slice(0, count)
146
+ }
147
+
148
+ const selectedAngles = selectDiagnosisAngles(bug_description, severity === 'Critical' ? 4 : (severity === 'High' ? 3 : (severity === 'Medium' ? 2 : 1)))
149
+
150
+ console.log(`
151
+ ## Diagnosis Plan
152
+
153
+ Bug Severity: ${severity}
154
+ Selected Angles: ${selectedAngles.join(', ')}
155
+
156
+ Launching ${selectedAngles.length} parallel diagnoses...
157
+ `)
158
+ ```
159
+
160
+ **Launch Parallel Diagnoses** - Orchestrator assigns angle to each agent:
161
+
162
+ ```javascript
163
+ // Launch agents with pre-assigned diagnosis angles
164
+ const diagnosisTasks = selectedAngles.map((angle, index) =>
165
+ Task(
166
+ subagent_type="cli-explore-agent",
167
+ description=`Diagnose: ${angle}`,
168
+ prompt=`
169
+ ## Task Objective
170
+ Execute **${angle}** diagnosis for bug root cause analysis. Analyze codebase from this specific angle to discover root cause, affected paths, and fix hints.
171
+
172
+ ## Assigned Context
173
+ - **Diagnosis Angle**: ${angle}
174
+ - **Bug Description**: ${bug_description}
175
+ - **Diagnosis Index**: ${index + 1} of ${selectedAngles.length}
176
+ - **Output File**: ${sessionFolder}/diagnosis-${angle}.json
177
+
178
+ ## MANDATORY FIRST STEPS (Execute by Agent)
179
+ **You (cli-explore-agent) MUST execute these steps in order:**
180
+ 1. Run: ~/.claude/scripts/get_modules_by_depth.sh (project structure)
181
+ 2. Run: rg -l "{error_keyword_from_bug}" --type ts (locate relevant files)
182
+ 3. Execute: cat ~/.claude/workflows/cli-templates/schemas/diagnosis-json-schema.json (get output schema reference)
183
+
184
+ ## Diagnosis Strategy (${angle} focus)
185
+
186
+ **Step 1: Error Tracing** (Bash)
187
+ - rg for error messages, stack traces, log patterns
188
+ - git log --since='2 weeks ago' for recent changes
189
+ - Trace execution path in affected modules
190
+
191
+ **Step 2: Root Cause Analysis** (Gemini CLI)
192
+ - What code paths lead to this ${angle} issue?
193
+ - What edge cases are not handled from ${angle} perspective?
194
+ - What recent changes might have introduced this bug?
195
+
196
+ **Step 3: Write Output**
197
+ - Consolidate ${angle} findings into JSON
198
+ - Identify ${angle}-specific clarification needs
199
+ - Provide fix hints based on ${angle} analysis
200
+
201
+ ## Expected Output
202
+
203
+ **File**: ${sessionFolder}/diagnosis-${angle}.json
204
+
205
+ **Schema Reference**: Schema obtained in MANDATORY FIRST STEPS step 3, follow schema exactly
206
+
207
+ **Required Fields** (all ${angle} focused):
208
+ - symptom: Bug symptoms and error messages
209
+ - root_cause: Root cause hypothesis from ${angle} perspective
210
+ **IMPORTANT**: Use structured format:
211
+ \`{file: "src/module/file.ts", line_range: "45-60", issue: "Description", confidence: 0.85}\`
212
+ - affected_files: Files involved from ${angle} perspective
213
+ **IMPORTANT**: Use object format with relevance scores:
214
+ \`[{path: "src/file.ts", relevance: 0.85, rationale: "Contains ${angle} logic"}]\`
215
+ - reproduction_steps: Steps to reproduce the bug
216
+ - fix_hints: Suggested fix approaches from ${angle} viewpoint
217
+ - dependencies: Dependencies relevant to ${angle} diagnosis
218
+ - constraints: ${angle}-specific limitations affecting fix
219
+ - clarification_needs: ${angle}-related ambiguities (options array + recommended index)
220
+ - _metadata.diagnosis_angle: "${angle}"
221
+ - _metadata.diagnosis_index: ${index + 1}
222
+
223
+ ## Success Criteria
224
+ - [ ] Schema obtained via cat diagnosis-json-schema.json
225
+ - [ ] get_modules_by_depth.sh executed
226
+ - [ ] Root cause identified with confidence score
227
+ - [ ] At least 3 affected files identified with ${angle} rationale
228
+ - [ ] Fix hints are actionable (specific code changes, not generic advice)
229
+ - [ ] Reproduction steps are verifiable
230
+ - [ ] JSON output follows schema exactly
231
+ - [ ] clarification_needs includes options + recommended
232
+
233
+ ## Output
234
+ Write: ${sessionFolder}/diagnosis-${angle}.json
235
+ Return: 2-3 sentence summary of ${angle} diagnosis findings
236
+ `
237
+ )
238
+ )
239
+
240
+ // Execute all diagnosis tasks in parallel
241
+ ```
242
+
243
+ **Auto-discover Generated Diagnosis Files**:
244
+ ```javascript
245
+ // After diagnoses complete, auto-discover all diagnosis-*.json files
246
+ const diagnosisFiles = bash(`find ${sessionFolder} -name "diagnosis-*.json" -type f`)
247
+ .split('\n')
248
+ .filter(f => f.trim())
249
+
250
+ // Read metadata to build manifest
251
+ const diagnosisManifest = {
252
+ session_id: sessionId,
253
+ bug_description: bug_description,
254
+ timestamp: getUtc8ISOString(),
255
+ severity: severity,
256
+ diagnosis_count: diagnosisFiles.length,
257
+ diagnoses: diagnosisFiles.map(file => {
258
+ const data = JSON.parse(Read(file))
259
+ const filename = path.basename(file)
260
+ return {
261
+ angle: data._metadata.diagnosis_angle,
262
+ file: filename,
263
+ path: file,
264
+ index: data._metadata.diagnosis_index
265
+ }
266
+ })
267
+ }
268
+
269
+ Write(`${sessionFolder}/diagnoses-manifest.json`, JSON.stringify(diagnosisManifest, null, 2))
270
+
271
+ console.log(`
272
+ ## Diagnosis Complete
273
+
274
+ Generated diagnosis files in ${sessionFolder}:
275
+ ${diagnosisManifest.diagnoses.map(d => `- diagnosis-${d.angle}.json (angle: ${d.angle})`).join('\n')}
276
+
277
+ Manifest: diagnoses-manifest.json
278
+ Angles diagnosed: ${diagnosisManifest.diagnoses.map(d => d.angle).join(', ')}
279
+ `)
280
+ ```
281
+
282
+ **Output**:
283
+ - `${sessionFolder}/diagnosis-{angle1}.json`
284
+ - `${sessionFolder}/diagnosis-{angle2}.json`
285
+ - ... (1-4 files based on severity)
286
+ - `${sessionFolder}/diagnoses-manifest.json`
287
+
288
+ ---
289
+
290
+ ### Phase 2: Clarification (Optional, Multi-Round)
291
+
292
+ **Skip if**: No diagnosis or `clarification_needs` is empty across all diagnoses
293
+
294
+ **⚠️ CRITICAL**: AskUserQuestion tool limits max 4 questions per call. **MUST execute multiple rounds** to exhaust all clarification needs - do NOT stop at round 1.
295
+
296
+ **Aggregate clarification needs from all diagnosis angles**:
297
+ ```javascript
298
+ // Load manifest and all diagnosis files
299
+ const manifest = JSON.parse(Read(`${sessionFolder}/diagnoses-manifest.json`))
300
+ const diagnoses = manifest.diagnoses.map(diag => ({
301
+ angle: diag.angle,
302
+ data: JSON.parse(Read(diag.path))
303
+ }))
304
+
305
+ // Aggregate clarification needs from all diagnoses
306
+ const allClarifications = []
307
+ diagnoses.forEach(diag => {
308
+ if (diag.data.clarification_needs?.length > 0) {
309
+ diag.data.clarification_needs.forEach(need => {
310
+ allClarifications.push({
311
+ ...need,
312
+ source_angle: diag.angle
313
+ })
314
+ })
315
+ }
316
+ })
317
+
318
+ // Deduplicate by question similarity
319
+ function deduplicateClarifications(clarifications) {
320
+ const unique = []
321
+ clarifications.forEach(c => {
322
+ const isDuplicate = unique.some(u =>
323
+ u.question.toLowerCase() === c.question.toLowerCase()
324
+ )
325
+ if (!isDuplicate) unique.push(c)
326
+ })
327
+ return unique
328
+ }
329
+
330
+ const uniqueClarifications = deduplicateClarifications(allClarifications)
331
+
332
+ // Multi-round clarification: batch questions (max 4 per round)
333
+ // ⚠️ MUST execute ALL rounds until uniqueClarifications exhausted
334
+ if (uniqueClarifications.length > 0) {
335
+ const BATCH_SIZE = 4
336
+ const totalRounds = Math.ceil(uniqueClarifications.length / BATCH_SIZE)
337
+
338
+ for (let i = 0; i < uniqueClarifications.length; i += BATCH_SIZE) {
339
+ const batch = uniqueClarifications.slice(i, i + BATCH_SIZE)
340
+ const currentRound = Math.floor(i / BATCH_SIZE) + 1
341
+
342
+ console.log(`### Clarification Round ${currentRound}/${totalRounds}`)
343
+
344
+ AskUserQuestion({
345
+ questions: batch.map(need => ({
346
+ question: `[${need.source_angle}] ${need.question}\n\nContext: ${need.context}`,
347
+ header: need.source_angle,
348
+ multiSelect: false,
349
+ options: need.options.map((opt, index) => {
350
+ const isRecommended = need.recommended === index
351
+ return {
352
+ label: isRecommended ? `${opt} ★` : opt,
353
+ description: isRecommended ? `Use ${opt} approach (Recommended)` : `Use ${opt} approach`
354
+ }
355
+ })
356
+ }))
357
+ })
358
+
359
+ // Store batch responses in clarificationContext before next round
360
+ }
361
+ }
362
+ ```
363
+
364
+ **Output**: `clarificationContext` (in-memory)
365
+
366
+ ---
367
+
368
+ ### Phase 3: Fix Planning
369
+
370
+ **Planning Strategy Selection** (based on Phase 1 severity):
371
+
372
+ **IMPORTANT**: Phase 3 is **planning only** - NO code execution. All execution happens in Phase 5 via lite-execute.
373
+
374
+ **Low/Medium Severity** - Direct planning by Claude:
375
+ ```javascript
376
+ // Step 1: Read schema
377
+ const schema = Bash(`cat ~/.claude/workflows/cli-templates/schemas/fix-plan-json-schema.json`)
378
+
379
+ // Step 2: Generate fix-plan following schema (Claude directly, no agent)
380
+ const fixPlan = {
381
+ summary: "...",
382
+ root_cause: "...",
383
+ strategy: "immediate_patch|comprehensive_fix|refactor",
384
+ tasks: [...], // Each task: { id, title, scope, ..., depends_on, complexity }
385
+ estimated_time: "...",
386
+ recommended_execution: "Agent",
387
+ severity: severity,
388
+ risk_level: "...",
389
+ _metadata: { timestamp: getUtc8ISOString(), source: "direct-planning", planning_mode: "direct" }
390
+ }
391
+
392
+ // Step 3: Write fix-plan to session folder
393
+ Write(`${sessionFolder}/fix-plan.json`, JSON.stringify(fixPlan, null, 2))
394
+
395
+ // Step 4: MUST continue to Phase 4 (Confirmation) - DO NOT execute code here
396
+ ```
397
+
398
+ **High/Critical Severity** - Invoke cli-lite-planning-agent:
399
+
400
+ ```javascript
401
+ Task(
402
+ subagent_type="cli-lite-planning-agent",
403
+ description="Generate detailed fix plan",
404
+ prompt=`
405
+ Generate fix plan and write fix-plan.json.
406
+
407
+ ## Output Schema Reference
408
+ Execute: cat ~/.claude/workflows/cli-templates/schemas/fix-plan-json-schema.json (get schema reference before generating plan)
409
+
410
+ ## Bug Description
411
+ ${bug_description}
412
+
413
+ ## Multi-Angle Diagnosis Context
414
+
415
+ ${manifest.diagnoses.map(diag => `### Diagnosis: ${diag.angle} (${diag.file})
416
+ Path: ${diag.path}
417
+
418
+ Read this file for detailed ${diag.angle} analysis.`).join('\n\n')}
419
+
420
+ Total diagnoses: ${manifest.diagnosis_count}
421
+ Angles covered: ${manifest.diagnoses.map(d => d.angle).join(', ')}
422
+
423
+ Manifest: ${sessionFolder}/diagnoses-manifest.json
424
+
425
+ ## User Clarifications
426
+ ${JSON.stringify(clarificationContext) || "None"}
427
+
428
+ ## Severity Level
429
+ ${severity}
430
+
431
+ ## Requirements
432
+ Generate fix-plan.json with:
433
+ - summary: 2-3 sentence overview of the fix
434
+ - root_cause: Consolidated root cause from all diagnoses
435
+ - strategy: "immediate_patch" | "comprehensive_fix" | "refactor"
436
+ - tasks: 1-5 structured fix tasks (**IMPORTANT: group by fix area, NOT by file**)
437
+ - **Task Granularity Principle**: Each task = one complete fix unit
438
+ - title: action verb + target (e.g., "Fix token validation edge case")
439
+ - scope: module path (src/auth/) or feature name
440
+ - action: "Fix" | "Update" | "Refactor" | "Add" | "Delete"
441
+ - description
442
+ - modification_points: ALL files to modify for this fix (group related changes)
443
+ - implementation (2-5 steps covering all modification_points)
444
+ - verification (test criteria)
445
+ - depends_on: task IDs this task depends on (use sparingly)
446
+ - estimated_time, recommended_execution, severity, risk_level
447
+ - _metadata:
448
+ - timestamp, source, planning_mode
449
+ - diagnosis_angles: ${JSON.stringify(manifest.diagnoses.map(d => d.angle))}
450
+
451
+ ## Task Grouping Rules
452
+ 1. **Group by fix area**: All changes for one fix = one task (even if 2-3 files)
453
+ 2. **Avoid file-per-task**: Do NOT create separate tasks for each file
454
+ 3. **Substantial tasks**: Each task should represent 10-45 minutes of work
455
+ 4. **True dependencies only**: Only use depends_on when Task B cannot start without Task A's output
456
+ 5. **Prefer parallel**: Most tasks should be independent (no depends_on)
457
+
458
+ ## Execution
459
+ 1. Read ALL diagnosis files for comprehensive context
460
+ 2. Execute CLI planning using Gemini (Qwen fallback)
461
+ 3. Synthesize findings from multiple diagnosis angles
462
+ 4. Parse output and structure fix-plan
463
+ 5. Write JSON: Write('${sessionFolder}/fix-plan.json', jsonContent)
464
+ 6. Return brief completion summary
465
+ `
466
+ )
467
+ ```
468
+
469
+ **Output**: `${sessionFolder}/fix-plan.json`
470
+
471
+ ---
472
+
473
+ ### Phase 4: Task Confirmation & Execution Selection
474
+
475
+ **Step 4.1: Display Fix Plan**
476
+ ```javascript
477
+ const fixPlan = JSON.parse(Read(`${sessionFolder}/fix-plan.json`))
478
+
479
+ console.log(`
480
+ ## Fix Plan
481
+
482
+ **Summary**: ${fixPlan.summary}
483
+ **Root Cause**: ${fixPlan.root_cause}
484
+ **Strategy**: ${fixPlan.strategy}
485
+
486
+ **Tasks** (${fixPlan.tasks.length}):
487
+ ${fixPlan.tasks.map((t, i) => `${i+1}. ${t.title} (${t.scope})`).join('\n')}
488
+
489
+ **Severity**: ${fixPlan.severity}
490
+ **Risk Level**: ${fixPlan.risk_level}
491
+ **Estimated Time**: ${fixPlan.estimated_time}
492
+ **Recommended**: ${fixPlan.recommended_execution}
493
+ `)
494
+ ```
495
+
496
+ **Step 4.2: Collect Confirmation**
497
+ ```javascript
498
+ AskUserQuestion({
499
+ questions: [
500
+ {
501
+ question: `Confirm fix plan? (${fixPlan.tasks.length} tasks, ${fixPlan.severity} severity)`,
502
+ header: "Confirm",
503
+ multiSelect: true,
504
+ options: [
505
+ { label: "Allow", description: "Proceed as-is" },
506
+ { label: "Modify", description: "Adjust before execution" },
507
+ { label: "Cancel", description: "Abort workflow" }
508
+ ]
509
+ },
510
+ {
511
+ question: "Execution method:",
512
+ header: "Execution",
513
+ multiSelect: false,
514
+ options: [
515
+ { label: "Agent", description: "@code-developer agent" },
516
+ { label: "Codex", description: "codex CLI tool" },
517
+ { label: "Auto", description: `Auto: ${fixPlan.severity === 'Low' ? 'Agent' : 'Codex'}` }
518
+ ]
519
+ },
520
+ {
521
+ question: "Code review after fix?",
522
+ header: "Review",
523
+ multiSelect: false,
524
+ options: [
525
+ { label: "Gemini Review", description: "Gemini CLI" },
526
+ { label: "Agent Review", description: "@code-reviewer" },
527
+ { label: "Skip", description: "No review" }
528
+ ]
529
+ }
530
+ ]
531
+ })
532
+ ```
533
+
534
+ ---
535
+
536
+ ### Phase 5: Dispatch to Execution
537
+
538
+ **CRITICAL**: lite-fix NEVER executes code directly. ALL execution MUST go through lite-execute.
539
+
540
+ **Step 5.1: Build executionContext**
541
+
542
+ ```javascript
543
+ // Load manifest and all diagnosis files
544
+ const manifest = JSON.parse(Read(`${sessionFolder}/diagnoses-manifest.json`))
545
+ const diagnoses = {}
546
+
547
+ manifest.diagnoses.forEach(diag => {
548
+ if (file_exists(diag.path)) {
549
+ diagnoses[diag.angle] = JSON.parse(Read(diag.path))
550
+ }
551
+ })
552
+
553
+ const fixPlan = JSON.parse(Read(`${sessionFolder}/fix-plan.json`))
554
+
555
+ executionContext = {
556
+ mode: "bugfix",
557
+ severity: fixPlan.severity,
558
+ planObject: fixPlan,
559
+ diagnosisContext: diagnoses,
560
+ diagnosisAngles: manifest.diagnoses.map(d => d.angle),
561
+ diagnosisManifest: manifest,
562
+ clarificationContext: clarificationContext || null,
563
+ executionMethod: userSelection.execution_method,
564
+ codeReviewTool: userSelection.code_review_tool,
565
+ originalUserInput: bug_description,
566
+ session: {
567
+ id: sessionId,
568
+ folder: sessionFolder,
569
+ artifacts: {
570
+ diagnoses: manifest.diagnoses.map(diag => ({
571
+ angle: diag.angle,
572
+ path: diag.path
573
+ })),
574
+ diagnoses_manifest: `${sessionFolder}/diagnoses-manifest.json`,
575
+ fix_plan: `${sessionFolder}/fix-plan.json`
576
+ }
577
+ }
578
+ }
579
+ ```
580
+
581
+ **Step 5.2: Dispatch**
582
+
583
+ ```javascript
584
+ SlashCommand(command="/workflow:lite-execute --in-memory --mode bugfix")
585
+ ```
586
+
587
+ ## Session Folder Structure
588
+
589
+ ```
590
+ .workflow/.lite-fix/{bug-slug}-{YYYY-MM-DD}/
591
+ |- diagnosis-{angle1}.json # Diagnosis angle 1
592
+ |- diagnosis-{angle2}.json # Diagnosis angle 2
593
+ |- diagnosis-{angle3}.json # Diagnosis angle 3 (if applicable)
594
+ |- diagnosis-{angle4}.json # Diagnosis angle 4 (if applicable)
595
+ |- diagnoses-manifest.json # Diagnosis index
596
+ +- fix-plan.json # Fix plan
597
+ ```
598
+
599
+ **Example**:
600
+ ```
601
+ .workflow/.lite-fix/user-avatar-upload-fails-413-2025-11-25-14-30-25/
602
+ |- diagnosis-error-handling.json
603
+ |- diagnosis-dataflow.json
604
+ |- diagnosis-validation.json
605
+ |- diagnoses-manifest.json
606
+ +- fix-plan.json
607
+ ```
608
+
609
+ ## Error Handling
610
+
611
+ | Error | Resolution |
612
+ |-------|------------|
613
+ | Diagnosis agent failure | Skip diagnosis, continue with bug description only |
614
+ | Planning agent failure | Fallback to direct planning by Claude |
615
+ | Clarification timeout | Use diagnosis findings as-is |
616
+ | Confirmation timeout | Save context, display resume instructions |
617
+ | Modify loop > 3 times | Suggest breaking task or using /workflow:plan |
618
+ | Root cause unclear | Extend diagnosis time or use broader angles |
619
+ | Too complex for lite-fix | Escalate to /workflow:plan --mode bugfix |
620
+
621
+