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,332 @@
1
+ ---
2
+ name: update-full
3
+ description: Update all CLAUDE.md files using layer-based execution (Layer 3→1) with batched agents (4 modules/agent) and gemini→qwen→codex fallback, <20 modules uses direct parallel
4
+ argument-hint: "[--tool gemini|qwen|codex] [--path <directory>]"
5
+ ---
6
+
7
+ # Full Documentation Update (/memory:update-full)
8
+
9
+ ## Overview
10
+
11
+ Orchestrates project-wide CLAUDE.md updates using batched agent execution with automatic tool fallback and 3-layer architecture support.
12
+
13
+ **Parameters**:
14
+ - `--tool <gemini|qwen|codex>`: Primary tool (default: gemini)
15
+ - `--path <directory>`: Target specific directory (default: entire project)
16
+
17
+ **Execution Flow**: Discovery → Plan Presentation → Execution → Safety Verification
18
+
19
+ ## 3-Layer Architecture & Auto-Strategy Selection
20
+
21
+ ### Layer Definition & Strategy Assignment
22
+
23
+ | Layer | Depth | Strategy | Purpose | Context Pattern |
24
+ |-------|-------|----------|---------|----------------|
25
+ | **Layer 3** (Deepest) | ≥3 | `multi-layer` | Handle unstructured files, generate docs for all subdirectories | `@**/*` (all files) |
26
+ | **Layer 2** (Middle) | 1-2 | `single-layer` | Aggregate from children + current code | `@*/CLAUDE.md @*.{ts,tsx,js,...}` |
27
+ | **Layer 1** (Top) | 0 | `single-layer` | Aggregate from children + current code | `@*/CLAUDE.md @*.{ts,tsx,js,...}` |
28
+
29
+ **Update Direction**: Layer 3 → Layer 2 → Layer 1 (bottom-up dependency flow)
30
+
31
+ **Strategy Auto-Selection**: Strategies are automatically determined by directory depth - no user configuration needed.
32
+
33
+ ### Strategy Details
34
+
35
+ #### Multi-Layer Strategy (Layer 3 Only)
36
+ - **Use Case**: Deepest directories with unstructured file layouts
37
+ - **Behavior**: Generates CLAUDE.md for current directory AND each subdirectory containing files
38
+ - **Context**: All files in current directory tree (`@**/*`)
39
+
40
+
41
+ #### Single-Layer Strategy (Layers 1-2)
42
+ - **Use Case**: Upper layers that aggregate from existing documentation
43
+ - **Behavior**: Generates CLAUDE.md only for current directory
44
+ - **Context**: Direct children CLAUDE.md files + current directory code files
45
+
46
+ ### Example Flow
47
+ ```
48
+ src/auth/handlers/ (depth 3) → MULTI-LAYER STRATEGY
49
+ CONTEXT: @**/* (all files in handlers/ and subdirs)
50
+ GENERATES: ./CLAUDE.md + CLAUDE.md in each subdir with files
51
+
52
+ src/auth/ (depth 2) → SINGLE-LAYER STRATEGY
53
+ CONTEXT: @*/CLAUDE.md @*.ts (handlers/CLAUDE.md + current code)
54
+ GENERATES: ./CLAUDE.md only
55
+
56
+ src/ (depth 1) → SINGLE-LAYER STRATEGY
57
+ CONTEXT: @*/CLAUDE.md (auth/CLAUDE.md, utils/CLAUDE.md)
58
+ GENERATES: ./CLAUDE.md only
59
+
60
+ ./ (depth 0) → SINGLE-LAYER STRATEGY
61
+ CONTEXT: @*/CLAUDE.md (src/CLAUDE.md, tests/CLAUDE.md)
62
+ GENERATES: ./CLAUDE.md only
63
+ ```
64
+
65
+ ## Core Execution Rules
66
+
67
+ 1. **Analyze First**: Git cache + module discovery before updates
68
+ 2. **Wait for Approval**: Present plan, no execution without user confirmation
69
+ 3. **Execution Strategy**:
70
+ - **<20 modules**: Direct parallel execution (max 4 concurrent per layer)
71
+ - **≥20 modules**: Agent batch processing (4 modules/agent, 73% overhead reduction)
72
+ 4. **Tool Fallback**: Auto-retry with fallback tools on failure
73
+ 5. **Layer Sequential**: Process layers 3→2→1 (bottom-up), parallel batches within layer
74
+ 6. **Safety Check**: Verify only CLAUDE.md files modified
75
+ 7. **Layer-based Grouping**: Group modules by LAYER (not depth) for execution
76
+
77
+ ## Tool Fallback Hierarchy
78
+
79
+ ```javascript
80
+ --tool gemini → [gemini, qwen, codex] // default
81
+ --tool qwen → [qwen, gemini, codex]
82
+ --tool codex → [codex, gemini, qwen]
83
+ ```
84
+
85
+ **Trigger**: Non-zero exit code from update script
86
+
87
+ | Tool | Best For | Fallback To |
88
+ |--------|--------------------------------|----------------|
89
+ | gemini | Documentation, patterns | qwen → codex |
90
+ | qwen | Architecture, system design | gemini → codex |
91
+ | codex | Implementation, code quality | gemini → qwen |
92
+
93
+ ## Execution Phases
94
+
95
+ ### Phase 1: Discovery & Analysis
96
+
97
+ ```javascript
98
+ // Cache git changes
99
+ Bash({command: "git add -A 2>/dev/null || true", run_in_background: false});
100
+
101
+ // Get module structure
102
+ Bash({command: "~/.claude/scripts/get_modules_by_depth.sh list", run_in_background: false});
103
+
104
+ // OR with --path
105
+ Bash({command: "cd <target-path> && ~/.claude/scripts/get_modules_by_depth.sh list", run_in_background: false});
106
+ ```
107
+
108
+ **Parse output** `depth:N|path:<PATH>|...` to extract module paths and count.
109
+
110
+ **Smart filter**: Auto-detect and skip tests/build/config/docs based on project tech stack.
111
+
112
+ ### Phase 2: Plan Presentation
113
+
114
+ **For <20 modules**:
115
+ ```
116
+ Update Plan:
117
+ Tool: gemini (fallback: qwen → codex)
118
+ Total: 7 modules
119
+ Execution: Direct parallel (< 20 modules threshold)
120
+
121
+ Will update:
122
+ - ./core/interfaces (12 files) - depth 2 [Layer 2] - single-layer strategy
123
+ - ./core (22 files) - depth 1 [Layer 2] - single-layer strategy
124
+ - ./models (9 files) - depth 1 [Layer 2] - single-layer strategy
125
+ - ./utils (12 files) - depth 1 [Layer 2] - single-layer strategy
126
+ - . (5 files) - depth 0 [Layer 1] - single-layer strategy
127
+
128
+ Context Strategy (Auto-Selected):
129
+ - Layer 2 (depth 1-2): @*/CLAUDE.md + current code files
130
+ - Layer 1 (depth 0): @*/CLAUDE.md + current code files
131
+
132
+ Auto-skipped: ./tests, __pycache__, setup.py (15 paths)
133
+ Execution order: Layer 2 → Layer 1
134
+ Estimated time: ~5-10 minutes
135
+
136
+ Confirm execution? (y/n)
137
+ ```
138
+
139
+ **For ≥20 modules**:
140
+ ```
141
+ Update Plan:
142
+ Tool: gemini (fallback: qwen → codex)
143
+ Total: 31 modules
144
+ Execution: Agent batch processing (4 modules/agent)
145
+
146
+ Will update:
147
+ - ./src/features/auth (12 files) - depth 3 [Layer 3] - multi-layer strategy
148
+ - ./.claude/commands/cli (6 files) - depth 3 [Layer 3] - multi-layer strategy
149
+ - ./src/utils (8 files) - depth 2 [Layer 2] - single-layer strategy
150
+ ...
151
+
152
+ Context Strategy (Auto-Selected):
153
+ - Layer 3 (depth ≥3): @**/* (all files)
154
+ - Layer 2 (depth 1-2): @*/CLAUDE.md + current code files
155
+ - Layer 1 (depth 0): @*/CLAUDE.md + current code files
156
+
157
+ Auto-skipped: ./tests, __pycache__, setup.py (15 paths)
158
+ Execution order: Layer 2 → Layer 1
159
+ Estimated time: ~5-10 minutes
160
+
161
+ Agent allocation (by LAYER):
162
+ - Layer 3 (14 modules, depth ≥3): 4 agents [4, 4, 4, 2]
163
+ - Layer 2 (15 modules, depth 1-2): 4 agents [4, 4, 4, 3]
164
+ - Layer 1 (2 modules, depth 0): 1 agent [2]
165
+
166
+ Estimated time: ~15-25 minutes
167
+
168
+ Confirm execution? (y/n)
169
+ ```
170
+
171
+ ### Phase 3A: Direct Execution (<20 modules)
172
+
173
+ **Strategy**: Parallel execution within layer (max 4 concurrent), no agent overhead.
174
+
175
+ **CRITICAL**: All Bash commands use `run_in_background: false` for synchronous execution.
176
+
177
+ ```javascript
178
+ for (let layer of [3, 2, 1]) {
179
+ if (modules_by_layer[layer].length === 0) continue;
180
+ let batches = batch_modules(modules_by_layer[layer], 4);
181
+
182
+ for (let batch of batches) {
183
+ let parallel_tasks = batch.map(module => {
184
+ return async () => {
185
+ let strategy = module.depth >= 3 ? "multi-layer" : "single-layer";
186
+ for (let tool of tool_order) {
187
+ Bash({
188
+ command: `cd ${module.path} && ~/.claude/scripts/update_module_claude.sh "${strategy}" "." "${tool}"`,
189
+ run_in_background: false
190
+ });
191
+ if (bash_result.exit_code === 0) {
192
+ report(`✅ ${module.path} (Layer ${layer}) updated with ${tool}`);
193
+ return true;
194
+ }
195
+ }
196
+ report(`❌ FAILED: ${module.path} (Layer ${layer}) failed all tools`);
197
+ return false;
198
+ };
199
+ });
200
+ await Promise.all(parallel_tasks.map(task => task()));
201
+ }
202
+ }
203
+ ```
204
+
205
+ ### Phase 3B: Agent Batch Execution (≥20 modules)
206
+
207
+ **Strategy**: Batch modules into groups of 4, spawn memory-bridge agents per batch.
208
+
209
+ ```javascript
210
+ // Group modules by LAYER and batch within each layer
211
+ let modules_by_layer = group_by_layer(module_list);
212
+ let tool_order = construct_tool_order(primary_tool);
213
+
214
+ for (let layer of [3, 2, 1]) {
215
+ if (modules_by_layer[layer].length === 0) continue;
216
+
217
+ let batches = batch_modules(modules_by_layer[layer], 4);
218
+ let worker_tasks = [];
219
+
220
+ for (let batch of batches) {
221
+ worker_tasks.push(
222
+ Task(
223
+ subagent_type="memory-bridge",
224
+ description=`Update ${batch.length} modules in Layer ${layer}`,
225
+ prompt=generate_batch_worker_prompt(batch, tool_order, layer)
226
+ )
227
+ );
228
+ }
229
+
230
+ await parallel_execute(worker_tasks);
231
+ }
232
+ ```
233
+
234
+ **Batch Worker Prompt Template**:
235
+ ```
236
+ PURPOSE: Update CLAUDE.md for assigned modules with tool fallback
237
+
238
+ TASK: Update documentation for assigned modules using specified strategies.
239
+
240
+ MODULES:
241
+ {{module_path_1}} (strategy: {{strategy_1}})
242
+ {{module_path_2}} (strategy: {{strategy_2}})
243
+ ...
244
+
245
+ TOOLS (try in order): {{tool_1}}, {{tool_2}}, {{tool_3}}
246
+
247
+ EXECUTION SCRIPT: ~/.claude/scripts/update_module_claude.sh
248
+ - Accepts strategy parameter: multi-layer | single-layer
249
+ - Tool execution via direct CLI commands (gemini/qwen/codex)
250
+
251
+ EXECUTION FLOW (for each module):
252
+ 1. Tool fallback loop (exit on first success):
253
+ for tool in {{tool_1}} {{tool_2}} {{tool_3}}; do
254
+ Bash({
255
+ command: `cd "{{module_path}}" && ~/.claude/scripts/update_module_claude.sh "{{strategy}}" "." "${tool}"`,
256
+ run_in_background: false
257
+ })
258
+ exit_code=$?
259
+
260
+ if [ $exit_code -eq 0 ]; then
261
+ report "✅ {{module_path}} updated with $tool"
262
+ break
263
+ else
264
+ report "⚠️ {{module_path}} failed with $tool, trying next..."
265
+ continue
266
+ fi
267
+ done
268
+
269
+ 2. Handle complete failure (all tools failed):
270
+ if [ $exit_code -ne 0 ]; then
271
+ report "❌ FAILED: {{module_path}} - all tools exhausted"
272
+ # Continue to next module (do not abort batch)
273
+ fi
274
+
275
+ FAILURE HANDLING:
276
+ - Module-level isolation: One module's failure does not affect others
277
+ - Exit code detection: Non-zero exit code triggers next tool
278
+ - Exhaustion reporting: Log modules where all tools failed
279
+ - Batch continuation: Always process remaining modules
280
+
281
+ REPORTING FORMAT:
282
+ Per-module status:
283
+ ✅ path/to/module updated with {tool}
284
+ ⚠️ path/to/module failed with {tool}, trying next...
285
+ ❌ FAILED: path/to/module - all tools exhausted
286
+ ```
287
+ ### Phase 4: Safety Verification
288
+
289
+ ```javascript
290
+ // Check only CLAUDE.md files modified
291
+ Bash({command: 'git diff --cached --name-only | grep -v "CLAUDE.md" || echo "Only CLAUDE.md files modified"', run_in_background: false});
292
+
293
+ // Display status
294
+ Bash({command: "git status --short", run_in_background: false});
295
+ ```
296
+
297
+ **Result Summary**:
298
+ ```
299
+ Update Summary:
300
+ Total: 31 | Success: 29 | Failed: 2
301
+ Tool usage: gemini: 25, qwen: 4, codex: 0
302
+ Failed: path1, path2
303
+ ```
304
+
305
+ ## Error Handling
306
+
307
+ **Batch Worker**: Tool fallback per module, batch isolation, clear status reporting
308
+ **Coordinator**: Invalid path abort, user decline handling, safety check with auto-revert
309
+ **Fallback Triggers**: Non-zero exit code, script timeout, unexpected output
310
+
311
+ ## Usage Examples
312
+
313
+ ```bash
314
+ # Full project update (auto-strategy selection)
315
+ /memory:update-full
316
+
317
+ # Target specific directory
318
+ /memory:update-full --path .claude
319
+ /memory:update-full --path src/features/auth
320
+
321
+ # Use specific tool
322
+ /memory:update-full --tool qwen
323
+ /memory:update-full --path .claude --tool qwen
324
+ ```
325
+
326
+ ## Key Advantages
327
+
328
+ - **Efficiency**: 30 modules → 8 agents (73% reduction from sequential)
329
+ - **Resilience**: 3-tier tool fallback per module
330
+ - **Performance**: Parallel batches, no concurrency limits
331
+ - **Observability**: Per-module tool usage, batch-level metrics
332
+ - **Automation**: Zero configuration - strategy auto-selected by directory depth
@@ -0,0 +1,332 @@
1
+ ---
2
+ name: update-related
3
+ description: Update CLAUDE.md for git-changed modules using batched agent execution (4 modules/agent) with gemini→qwen→codex fallback, <15 modules uses direct execution
4
+ argument-hint: "[--tool gemini|qwen|codex]"
5
+ ---
6
+
7
+ # Related Documentation Update (/memory:update-related)
8
+
9
+ ## Overview
10
+
11
+ Orchestrates context-aware CLAUDE.md updates for changed modules using batched agent execution with automatic tool fallback (gemini→qwen→codex).
12
+
13
+ **Parameters**:
14
+ - `--tool <gemini|qwen|codex>`: Primary tool (default: gemini)
15
+
16
+ **Execution Flow**:
17
+ 1. Change Detection → 2. Plan Presentation → 3. Batched Agent Execution → 4. Safety Verification
18
+
19
+ ## Core Rules
20
+
21
+ 1. **Detect Changes First**: Use git diff to identify affected modules
22
+ 2. **Wait for Approval**: Present plan, no execution without user confirmation
23
+ 3. **Execution Strategy**:
24
+ - <15 modules: Direct parallel execution (max 4 concurrent per depth, no agent overhead)
25
+ - ≥15 modules: Agent batch processing (4 modules/agent, 73% overhead reduction)
26
+ 4. **Tool Fallback**: Auto-retry with fallback tools on failure
27
+ 5. **Depth Sequential**: Process depths N→0, parallel batches within depth (both modes)
28
+ 6. **Related Mode**: Update only changed modules and their parent contexts
29
+
30
+ ## Tool Fallback Hierarchy
31
+
32
+ ```javascript
33
+ --tool gemini → [gemini, qwen, codex] // default
34
+ --tool qwen → [qwen, gemini, codex]
35
+ --tool codex → [codex, gemini, qwen]
36
+ ```
37
+
38
+ **Trigger**: Non-zero exit code from update script
39
+
40
+ ## Phase 1: Change Detection & Analysis
41
+
42
+ ```javascript
43
+ // Detect changed modules
44
+ Bash({command: "~/.claude/scripts/detect_changed_modules.sh list", run_in_background: false});
45
+
46
+ // Cache git changes
47
+ Bash({command: "git add -A 2>/dev/null || true", run_in_background: false});
48
+ ```
49
+
50
+ **Parse output** `depth:N|path:<PATH>|change:<TYPE>` to extract affected modules.
51
+
52
+ **Smart filter**: Auto-detect and skip tests/build/config/docs based on project tech stack (Node.js/Python/Go/Rust/etc).
53
+
54
+ **Fallback**: If no changes detected, use recent modules (first 10 by depth).
55
+
56
+ ## Phase 2: Plan Presentation
57
+
58
+ **Present filtered plan**:
59
+ ```
60
+ Related Update Plan:
61
+ Tool: gemini (fallback: qwen → codex)
62
+ Changed: 4 modules | Batching: 4 modules/agent
63
+
64
+ Will update:
65
+ - ./src/api/auth (5 files) [new module]
66
+ - ./src/api (12 files) [parent of changed auth/]
67
+ - ./src (8 files) [parent context]
68
+ - . (14 files) [root level]
69
+
70
+ Auto-skipped (12 paths):
71
+ - Tests: ./src/api/auth.test.ts (8 paths)
72
+ - Config: tsconfig.json (3 paths)
73
+ - Other: node_modules (1 path)
74
+
75
+ Agent allocation:
76
+ - Depth 3 (1 module): 1 agent [1]
77
+ - Depth 2 (1 module): 1 agent [1]
78
+ - Depth 1 (1 module): 1 agent [1]
79
+ - Depth 0 (1 module): 1 agent [1]
80
+
81
+ Confirm execution? (y/n)
82
+ ```
83
+
84
+ **Decision logic**:
85
+ - User confirms "y": Proceed with execution
86
+ - User declines "n": Abort, no changes
87
+ - <15 modules: Direct execution
88
+ - ≥15 modules: Agent batch execution
89
+
90
+ ## Phase 3A: Direct Execution (<15 modules)
91
+
92
+ **Strategy**: Parallel execution within depth (max 4 concurrent), no agent overhead.
93
+
94
+ **CRITICAL**: All Bash commands use `run_in_background: false` for synchronous execution.
95
+
96
+ ```javascript
97
+ for (let depth of sorted_depths.reverse()) { // N → 0
98
+ let batches = batch_modules(modules_by_depth[depth], 4);
99
+
100
+ for (let batch of batches) {
101
+ let parallel_tasks = batch.map(module => {
102
+ return async () => {
103
+ for (let tool of tool_order) {
104
+ Bash({
105
+ command: `cd ${module.path} && ~/.claude/scripts/update_module_claude.sh "single-layer" "." "${tool}"`,
106
+ run_in_background: false
107
+ });
108
+ if (bash_result.exit_code === 0) {
109
+ report(`✅ ${module.path} updated with ${tool}`);
110
+ return true;
111
+ }
112
+ }
113
+ report(`❌ FAILED: ${module.path} failed all tools`);
114
+ return false;
115
+ };
116
+ });
117
+ await Promise.all(parallel_tasks.map(task => task()));
118
+ }
119
+ }
120
+ ```
121
+
122
+ ---
123
+
124
+ ## Phase 3B: Agent Batch Execution (≥15 modules)
125
+
126
+ ### Batching Strategy
127
+
128
+ ```javascript
129
+ // Batch modules into groups of 4
130
+ function batch_modules(modules, batch_size = 4) {
131
+ let batches = [];
132
+ for (let i = 0; i < modules.length; i += batch_size) {
133
+ batches.push(modules.slice(i, i + batch_size));
134
+ }
135
+ return batches;
136
+ }
137
+ // Examples: 10→[4,4,2] | 8→[4,4] | 3→[3]
138
+ ```
139
+
140
+ ### Coordinator Orchestration
141
+
142
+ ```javascript
143
+ let modules_by_depth = group_by_depth(changed_modules);
144
+ let tool_order = construct_tool_order(primary_tool);
145
+
146
+ for (let depth of sorted_depths.reverse()) { // N → 0
147
+ let batches = batch_modules(modules_by_depth[depth], 4);
148
+ let worker_tasks = [];
149
+
150
+ for (let batch of batches) {
151
+ worker_tasks.push(
152
+ Task(
153
+ subagent_type="memory-bridge",
154
+ description=`Update ${batch.length} modules at depth ${depth}`,
155
+ prompt=generate_batch_worker_prompt(batch, tool_order, "related")
156
+ )
157
+ );
158
+ }
159
+
160
+ await parallel_execute(worker_tasks); // Batches run in parallel
161
+ }
162
+ ```
163
+
164
+ ### Batch Worker Prompt Template
165
+
166
+ ```
167
+ PURPOSE: Update CLAUDE.md for assigned modules with tool fallback (related mode)
168
+
169
+ TASK:
170
+ Update documentation for the following modules based on recent changes. For each module, try tools in order until success.
171
+
172
+ MODULES:
173
+ {{module_path_1}}
174
+ {{module_path_2}}
175
+ {{module_path_3}}
176
+ {{module_path_4}}
177
+
178
+ TOOLS (try in order):
179
+ 1. {{tool_1}}
180
+ 2. {{tool_2}}
181
+ 3. {{tool_3}}
182
+
183
+ EXECUTION:
184
+ For each module above:
185
+ 1. Try tool 1:
186
+ Bash({
187
+ command: `cd "{{module_path}}" && ~/.claude/scripts/update_module_claude.sh "single-layer" "." "{{tool_1}}"`,
188
+ run_in_background: false
189
+ })
190
+ → Success: Report "✅ {{module_path}} updated with {{tool_1}}", proceed to next module
191
+ → Failure: Try tool 2
192
+ 2. Try tool 2:
193
+ Bash({
194
+ command: `cd "{{module_path}}" && ~/.claude/scripts/update_module_claude.sh "single-layer" "." "{{tool_2}}"`,
195
+ run_in_background: false
196
+ })
197
+ → Success: Report "✅ {{module_path}} updated with {{tool_2}}", proceed to next module
198
+ → Failure: Try tool 3
199
+ 3. Try tool 3:
200
+ Bash({
201
+ command: `cd "{{module_path}}" && ~/.claude/scripts/update_module_claude.sh "single-layer" "." "{{tool_3}}"`,
202
+ run_in_background: false
203
+ })
204
+ → Success: Report "✅ {{module_path}} updated with {{tool_3}}", proceed to next module
205
+ → Failure: Report "❌ FAILED: {{module_path}} failed all tools", proceed to next module
206
+
207
+ REPORTING:
208
+ Report final summary with:
209
+ - Total processed: X modules
210
+ - Successful: Y modules
211
+ - Failed: Z modules
212
+ - Tool usage: {{tool_1}}:X, {{tool_2}}:Y, {{tool_3}}:Z
213
+ ```
214
+
215
+ ## Phase 4: Safety Verification
216
+
217
+ ```javascript
218
+ // Check only CLAUDE.md modified
219
+ Bash({command: 'git diff --cached --name-only | grep -v "CLAUDE.md" || echo "Only CLAUDE.md files modified"', run_in_background: false});
220
+
221
+ // Display statistics
222
+ Bash({command: "git diff --stat", run_in_background: false});
223
+ ```
224
+
225
+ **Aggregate results**:
226
+ ```
227
+ Update Summary:
228
+ Total: 4 | Success: 4 | Failed: 0
229
+
230
+ Tool usage:
231
+ - gemini: 4 modules
232
+ - qwen: 0 modules (fallback)
233
+ - codex: 0 modules
234
+
235
+ Changes:
236
+ src/api/auth/CLAUDE.md | 45 +++++++++++++++++++++
237
+ src/api/CLAUDE.md | 23 +++++++++--
238
+ src/CLAUDE.md | 12 ++++--
239
+ CLAUDE.md | 8 ++--
240
+ 4 files changed, 82 insertions(+), 6 deletions(-)
241
+ ```
242
+
243
+ ## Execution Summary
244
+
245
+ **Module Count Threshold**:
246
+ - **<15 modules**: Coordinator executes Phase 3A (Direct Execution)
247
+ - **≥15 modules**: Coordinator executes Phase 3B (Agent Batch Execution)
248
+
249
+ **Agent Hierarchy** (for ≥15 modules):
250
+ - **Coordinator**: Handles batch division, spawns worker agents per depth
251
+ - **Worker Agents**: Each processes 4 modules with tool fallback (related mode)
252
+
253
+ ## Error Handling
254
+
255
+ **Batch Worker**:
256
+ - Tool fallback per module (auto-retry)
257
+ - Batch isolation (failures don't propagate)
258
+ - Clear per-module status reporting
259
+
260
+ **Coordinator**:
261
+ - No changes: Use fallback (recent 10 modules)
262
+ - User decline: No execution
263
+ - Safety check fail: Auto-revert staging
264
+ - Partial failures: Continue execution, report failed modules
265
+
266
+ **Fallback Triggers**:
267
+ - Non-zero exit code
268
+ - Script timeout
269
+ - Unexpected output
270
+
271
+ ## Tool Reference
272
+
273
+ | Tool | Best For | Fallback To |
274
+ |--------|--------------------------------|----------------|
275
+ | gemini | Documentation, patterns | qwen → codex |
276
+ | qwen | Architecture, system design | gemini → codex |
277
+ | codex | Implementation, code quality | gemini → qwen |
278
+
279
+ ## Usage Examples
280
+
281
+ ```bash
282
+ # Daily development update
283
+ /memory:update-related
284
+
285
+ # After feature work with specific tool
286
+ /memory:update-related --tool qwen
287
+
288
+ # Code quality review after implementation
289
+ /memory:update-related --tool codex
290
+ ```
291
+
292
+ ## Key Advantages
293
+
294
+ **Efficiency**: 30 modules → 8 agents (73% reduction)
295
+ **Resilience**: 3-tier fallback per module
296
+ **Performance**: Parallel batches, no concurrency limits
297
+ **Context-aware**: Updates based on actual git changes
298
+ **Fast**: Only affected modules, not entire project
299
+
300
+ ## Coordinator Checklist
301
+
302
+ - Parse `--tool` (default: gemini)
303
+ - Refresh code index for accurate change detection
304
+ - Detect changed modules via detect_changed_modules.sh
305
+ - **Smart filter modules** (auto-detect tech stack, skip tests/build/config/docs)
306
+ - Cache git changes
307
+ - Apply fallback if no changes (recent 10 modules)
308
+ - Construct tool fallback order
309
+ - **Present filtered plan** with skip reasons and change types
310
+ - **Wait for y/n confirmation**
311
+ - Determine execution mode:
312
+ - **<15 modules**: Direct execution (Phase 3A)
313
+ - For each depth (N→0): Sequential module updates with tool fallback
314
+ - **≥15 modules**: Agent batch execution (Phase 3B)
315
+ - For each depth (N→0): Batch modules (4 per batch), spawn batch workers in parallel
316
+ - Wait for depth/batch completion
317
+ - Aggregate results
318
+ - Safety check (only CLAUDE.md modified)
319
+ - Display git diff statistics + summary
320
+
321
+ ## Comparison with Full Update
322
+
323
+ | Aspect | Related Update | Full Update |
324
+ |--------|----------------|-------------|
325
+ | **Scope** | Changed modules only | All project modules |
326
+ | **Speed** | Fast (minutes) | Slower (10-30 min) |
327
+ | **Use case** | Daily development | Major refactoring |
328
+ | **Mode** | `"related"` | `"full"` |
329
+ | **Trigger** | After commits | After major changes |
330
+ | **Batching** | 4 modules/agent | 4 modules/agent |
331
+ | **Fallback** | gemini→qwen→codex | gemini→qwen→codex |
332
+ | **Complexity threshold** | ≤15 modules | ≤20 modules |