claude-code-workflow 7.2.29 → 7.3.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 (169) hide show
  1. package/.ccw/workflows/cli-templates/schemas/plan-overview-base-schema.json +2 -2
  2. package/.ccw/workflows/cli-templates/schemas/task-schema.json +14 -7
  3. package/.claude/agents/action-planning-agent.md +7 -4
  4. package/.claude/agents/cli-explore-agent.md +77 -63
  5. package/.claude/agents/cli-lite-planning-agent.md +11 -10
  6. package/.claude/agents/issue-plan-agent.md +421 -426
  7. package/.claude/commands/workflow/spec/setup.md +1 -1
  8. package/.claude/commands/workflow-skill.md +130 -0
  9. package/.claude/skills/ccw-chain/SKILL.md +92 -0
  10. package/.claude/skills/ccw-chain/chains/ccw-cycle.json +31 -0
  11. package/.claude/skills/ccw-chain/chains/ccw-exploration.json +58 -0
  12. package/.claude/skills/ccw-chain/chains/ccw-issue.json +44 -0
  13. package/.claude/skills/ccw-chain/chains/ccw-lightweight.json +71 -0
  14. package/.claude/skills/ccw-chain/chains/ccw-main.json +65 -0
  15. package/.claude/skills/ccw-chain/chains/ccw-standard.json +51 -0
  16. package/.claude/skills/ccw-chain/chains/ccw-team.json +15 -0
  17. package/.claude/skills/ccw-chain/chains/ccw-with-file.json +47 -0
  18. package/.claude/skills/ccw-chain/specs/auto-mode.md +47 -0
  19. package/.claude/skills/chain-loader/SKILL.md +78 -0
  20. package/.claude/skills/chain-loader/phases/01-analyze-skill.md +53 -0
  21. package/.claude/skills/chain-loader/phases/02-design-graph.md +73 -0
  22. package/.claude/skills/chain-loader/phases/03-generate-validate.md +75 -0
  23. package/.claude/skills/chain-loader/specs/chain-schema.md +126 -0
  24. package/.claude/skills/chain-loader/specs/design-patterns.md +99 -0
  25. package/.claude/skills/chain-loader/templates/chain-json.md +63 -0
  26. package/.claude/skills/review-cycle/phases/review-module.md +764 -764
  27. package/.claude/skills/review-cycle/phases/review-session.md +775 -775
  28. package/.claude/skills/workflow-multi-cli-plan/SKILL.md +2 -2
  29. package/.claude/skills/workflow-plan/SKILL.md +1 -0
  30. package/.claude/skills/workflow-plan/phases/01-session-discovery.md +19 -2
  31. package/.claude/skills/workflow-plan/phases/02-context-gathering.md +2 -2
  32. package/.claude/skills/workflow-plan/phases/03-conflict-resolution.md +422 -422
  33. package/.claude/skills/workflow-plan/phases/04-task-generation.md +9 -1
  34. package/.claude/skills/workflow-plan/phases/05-plan-verify.md +395 -395
  35. package/.claude/skills/workflow-tdd-plan/phases/02-context-gathering.md +407 -407
  36. package/.claude/skills/workflow-tdd-plan/phases/04-conflict-resolution.md +426 -426
  37. package/.claude/skills/workflow-test-fix/phases/02-test-context-gather.md +493 -493
  38. package/.codex/skills/analyze-with-file/SKILL.md +383 -134
  39. package/.codex/skills/brainstorm/SKILL.md +3 -3
  40. package/.codex/skills/brainstorm-with-file/SKILL.md +208 -88
  41. package/.codex/skills/clean/SKILL.md +1 -1
  42. package/.codex/skills/csv-wave-pipeline/SKILL.md +2 -2
  43. package/.codex/skills/investigate/orchestrator.md +24 -0
  44. package/.codex/skills/issue-discover/SKILL.md +374 -361
  45. package/.codex/skills/issue-discover/phases/01-issue-new.md +1 -1
  46. package/.codex/skills/issue-discover/phases/02-discover.md +2 -2
  47. package/.codex/skills/issue-discover/phases/03-discover-by-prompt.md +1 -1
  48. package/.codex/skills/issue-discover/phases/04-quick-execute.md +2 -2
  49. package/.codex/skills/parallel-dev-cycle/SKILL.md +44 -37
  50. package/.codex/skills/project-documentation-workflow/SKILL.md +1 -1
  51. package/.codex/skills/review-cycle/SKILL.md +31 -12
  52. package/.codex/skills/roadmap-with-file/SKILL.md +141 -133
  53. package/.codex/skills/security-audit/orchestrator.md +29 -0
  54. package/.codex/skills/session-sync/SKILL.md +1 -1
  55. package/.codex/skills/ship/orchestrator.md +24 -0
  56. package/.codex/skills/spec-add/SKILL.md +5 -5
  57. package/.codex/skills/spec-generator/SKILL.md +33 -2
  58. package/.codex/skills/spec-generator/phases/01-5-requirement-clarification.md +3 -3
  59. package/.codex/skills/spec-generator/phases/01-discovery.md +1 -1
  60. package/.codex/skills/spec-generator/phases/02-product-brief.md +1 -1
  61. package/.codex/skills/spec-generator/phases/03-requirements.md +1 -1
  62. package/.codex/skills/spec-generator/phases/04-architecture.md +1 -1
  63. package/.codex/skills/spec-generator/phases/05-epics-stories.md +1 -1
  64. package/.codex/skills/spec-generator/phases/06-readiness-check.md +1 -1
  65. package/.codex/skills/spec-generator/phases/07-issue-export.md +1 -1
  66. package/.codex/skills/spec-setup/SKILL.md +669 -669
  67. package/.codex/skills/team-arch-opt/specs/team-config.json +1 -1
  68. package/.codex/skills/team-brainstorm/SKILL.md +259 -259
  69. package/.codex/skills/team-coordinate/SKILL.md +359 -359
  70. package/.codex/skills/team-coordinate/roles/coordinator/commands/monitor.md +1 -1
  71. package/.codex/skills/team-designer/SKILL.md +27 -1
  72. package/.codex/skills/team-designer/phases/01-requirements-analysis.md +2 -2
  73. package/.codex/skills/team-designer/phases/02-scaffold-generation.md +1 -1
  74. package/.codex/skills/team-designer/phases/04-validation.md +1 -1
  75. package/.codex/skills/team-executor/SKILL.md +218 -218
  76. package/.codex/skills/team-frontend/SKILL.md +227 -227
  77. package/.codex/skills/team-frontend-debug/SKILL.md +278 -278
  78. package/.codex/skills/team-frontend-debug/roles/coordinator/commands/analyze.md +2 -2
  79. package/.codex/skills/team-interactive-craft/SKILL.md +220 -220
  80. package/.codex/skills/team-interactive-craft/roles/coordinator/role.md +209 -209
  81. package/.codex/skills/team-issue/SKILL.md +269 -269
  82. package/.codex/skills/team-issue/roles/coordinator/role.md +1 -1
  83. package/.codex/skills/team-lifecycle-v4/SKILL.md +305 -305
  84. package/.codex/skills/team-motion-design/SKILL.md +222 -222
  85. package/.codex/skills/team-motion-design/roles/coordinator/role.md +210 -210
  86. package/.codex/skills/team-perf-opt/SKILL.md +258 -258
  87. package/.codex/skills/team-perf-opt/specs/team-config.json +1 -1
  88. package/.codex/skills/team-planex/SKILL.md +216 -216
  89. package/.codex/skills/team-quality-assurance/SKILL.md +229 -229
  90. package/.codex/skills/team-review/SKILL.md +227 -227
  91. package/.codex/skills/team-roadmap-dev/SKILL.md +238 -238
  92. package/.codex/skills/team-roadmap-dev/roles/coordinator/commands/roadmap-discuss.md +5 -5
  93. package/.codex/skills/team-tech-debt/SKILL.md +206 -206
  94. package/.codex/skills/team-tech-debt/roles/coordinator/commands/monitor.md +1 -1
  95. package/.codex/skills/team-testing/SKILL.md +237 -237
  96. package/.codex/skills/team-ui-polish/SKILL.md +218 -218
  97. package/.codex/skills/team-ui-polish/roles/coordinator/role.md +213 -213
  98. package/.codex/skills/team-uidesign/SKILL.md +219 -219
  99. package/.codex/skills/team-uidesign/roles/coordinator/role.md +2 -2
  100. package/.codex/skills/team-ultra-analyze/SKILL.md +260 -260
  101. package/.codex/skills/team-ultra-analyze/roles/coordinator/commands/monitor.md +1 -1
  102. package/.codex/skills/team-ultra-analyze/roles/coordinator/role.md +1 -1
  103. package/.codex/skills/team-ux-improve/SKILL.md +227 -227
  104. package/.codex/skills/team-ux-improve/roles/coordinator/role.md +1 -1
  105. package/.codex/skills/team-ux-improve/specs/team-config.json +1 -1
  106. package/.codex/skills/team-visual-a11y/SKILL.md +319 -319
  107. package/.codex/skills/team-visual-a11y/roles/coordinator/role.md +213 -213
  108. package/.codex/skills/workflow-execute/SKILL.md +5 -5
  109. package/.codex/skills/workflow-lite-planex/SKILL.md +3 -3
  110. package/.codex/skills/workflow-plan/SKILL.md +3 -3
  111. package/.codex/skills/workflow-tdd-plan/SKILL.md +4 -4
  112. package/.codex/skills/workflow-test-fix-cycle/SKILL.md +403 -402
  113. package/README.md +14 -0
  114. package/ccw/dist/cli.d.ts.map +1 -1
  115. package/ccw/dist/cli.js +16 -0
  116. package/ccw/dist/cli.js.map +1 -1
  117. package/ccw/dist/commands/chain-loader.d.ts +2 -0
  118. package/ccw/dist/commands/chain-loader.d.ts.map +1 -0
  119. package/ccw/dist/commands/chain-loader.js +11 -0
  120. package/ccw/dist/commands/chain-loader.js.map +1 -0
  121. package/ccw/dist/commands/install.d.ts.map +1 -1
  122. package/ccw/dist/commands/install.js +52 -1
  123. package/ccw/dist/commands/install.js.map +1 -1
  124. package/ccw/dist/commands/launcher.d.ts +2 -0
  125. package/ccw/dist/commands/launcher.d.ts.map +1 -0
  126. package/ccw/dist/commands/launcher.js +434 -0
  127. package/ccw/dist/commands/launcher.js.map +1 -0
  128. package/ccw/dist/core/routes/litellm-api-routes.d.ts.map +1 -1
  129. package/ccw/dist/core/routes/litellm-api-routes.js +0 -23
  130. package/ccw/dist/core/routes/litellm-api-routes.js.map +1 -1
  131. package/ccw/dist/tools/chain-loader.d.ts +10 -0
  132. package/ccw/dist/tools/chain-loader.d.ts.map +1 -0
  133. package/ccw/dist/tools/chain-loader.js +1054 -0
  134. package/ccw/dist/tools/chain-loader.js.map +1 -0
  135. package/ccw/dist/tools/index.d.ts.map +1 -1
  136. package/ccw/dist/tools/index.js +2 -0
  137. package/ccw/dist/tools/index.js.map +1 -1
  138. package/ccw/dist/tools/json-builder.js +20 -0
  139. package/ccw/dist/tools/json-builder.js.map +1 -1
  140. package/ccw/dist/tools/skill-context-loader.d.ts.map +1 -1
  141. package/ccw/dist/tools/skill-context-loader.js +12 -26
  142. package/ccw/dist/tools/skill-context-loader.js.map +1 -1
  143. package/ccw/dist/types/chain-types.d.ts +112 -0
  144. package/ccw/dist/types/chain-types.d.ts.map +1 -0
  145. package/ccw/dist/types/chain-types.js +5 -0
  146. package/ccw/dist/types/chain-types.js.map +1 -0
  147. package/ccw/dist/utils/chain-visualizer.d.ts +13 -0
  148. package/ccw/dist/utils/chain-visualizer.d.ts.map +1 -0
  149. package/ccw/dist/utils/chain-visualizer.js +164 -0
  150. package/ccw/dist/utils/chain-visualizer.js.map +1 -0
  151. package/ccw/scripts/prepublish-clean.mjs +0 -1
  152. package/package.json +1 -3
  153. package/.claude/commands/cli/cli-init.md +0 -441
  154. package/.claude/commands/cli/codex-review.md +0 -361
  155. package/.claude/commands/flow-create.md +0 -663
  156. package/.claude/skills/team-edict.zip +0 -0
  157. package/ccw-litellm/README.md +0 -180
  158. package/ccw-litellm/pyproject.toml +0 -35
  159. package/ccw-litellm/src/ccw_litellm/__init__.py +0 -47
  160. package/ccw-litellm/src/ccw_litellm/cli.py +0 -108
  161. package/ccw-litellm/src/ccw_litellm/clients/__init__.py +0 -12
  162. package/ccw-litellm/src/ccw_litellm/clients/litellm_embedder.py +0 -270
  163. package/ccw-litellm/src/ccw_litellm/clients/litellm_llm.py +0 -198
  164. package/ccw-litellm/src/ccw_litellm/config/__init__.py +0 -22
  165. package/ccw-litellm/src/ccw_litellm/config/loader.py +0 -343
  166. package/ccw-litellm/src/ccw_litellm/config/models.py +0 -162
  167. package/ccw-litellm/src/ccw_litellm/interfaces/__init__.py +0 -14
  168. package/ccw-litellm/src/ccw_litellm/interfaces/embedder.py +0 -52
  169. package/ccw-litellm/src/ccw_litellm/interfaces/llm.py +0 -45
@@ -1,663 +0,0 @@
1
- # Flow Template Generator
2
-
3
- Generate workflow templates for meta-skill/flow-coordinator.
4
-
5
- ## Usage
6
-
7
- ```
8
- /meta-skill:flow-create [template-name] [--output <path>]
9
- ```
10
-
11
- **Examples**:
12
- ```bash
13
- /meta-skill:flow-create bugfix-v2
14
- /meta-skill:flow-create my-workflow --output ~/.claude/skills/my-skill/templates/
15
- ```
16
-
17
- ## Execution Flow
18
-
19
- ```
20
- User Input → Phase 1: Template Design → Phase 2: Step Definition → Phase 3: Generate JSON
21
- ↓ ↓ ↓
22
- Name + Description Define workflow steps Write template file
23
- ```
24
-
25
- ---
26
-
27
- ## Phase 1: Template Design
28
-
29
- Gather basic template information:
30
-
31
- ```javascript
32
- async function designTemplate(input) {
33
- const templateName = parseTemplateName(input) || await askTemplateName();
34
-
35
- const metadata = await AskUserQuestion({
36
- questions: [
37
- {
38
- question: "What is the purpose of this workflow template?",
39
- header: "Purpose",
40
- options: [
41
- { label: "Feature Development", description: "Implement new features with planning and testing" },
42
- { label: "Bug Fix", description: "Diagnose and fix bugs with verification" },
43
- { label: "TDD Development", description: "Test-driven development workflow" },
44
- { label: "Code Review", description: "Review cycle with findings and fixes" },
45
- { label: "Testing", description: "Test generation and validation" },
46
- { label: "Issue Workflow", description: "Complete issue lifecycle (discover → plan → queue → execute)" },
47
- { label: "With-File Workflow", description: "Documented exploration (brainstorm/debug/analyze)" },
48
- { label: "Custom", description: "Define custom workflow purpose" }
49
- ],
50
- multiSelect: false
51
- },
52
- {
53
- question: "What complexity level?",
54
- header: "Level",
55
- options: [
56
- { label: "Level 1 (Rapid)", description: "1-2 steps, ultra-lightweight hotfix" },
57
- { label: "Level 2 (Lightweight)", description: "2-4 steps, quick implementation" },
58
- { label: "Level 3 (Standard)", description: "4-6 steps, with verification and testing" },
59
- { label: "Level 4 (Full)", description: "6+ steps, brainstorm + full workflow" }
60
- ],
61
- multiSelect: false
62
- }
63
- ]
64
- });
65
-
66
- return {
67
- name: templateName,
68
- description: generateDescription(templateName, metadata.Purpose),
69
- level: parseLevel(metadata.Level),
70
- purpose: metadata.Purpose
71
- };
72
- }
73
- ```
74
-
75
- ---
76
-
77
- ## Phase 2: Step Definition
78
-
79
- ### Step 2.1: Select Command Category
80
-
81
- ```javascript
82
- async function selectCommandCategory() {
83
- return await AskUserQuestion({
84
- questions: [{
85
- question: "Select command category",
86
- header: "Category",
87
- options: [
88
- { label: "Planning", description: "lite-plan, plan, multi-cli-plan, tdd-plan, quick-plan-with-file" },
89
- { label: "Execution", description: "execute, unified-execute-with-file" },
90
- { label: "Testing", description: "test-fix-gen, test-cycle-execute, test-gen, tdd-verify" },
91
- { label: "Review", description: "review-session-cycle, review-module-cycle, review-cycle-fix" },
92
- { label: "Bug Fix", description: "lite-plan --bugfix, debug-with-file" },
93
- { label: "Brainstorm", description: "brainstorm-with-file, brainstorm (unified skill)" },
94
- { label: "Analysis", description: "analyze-with-file" },
95
- { label: "Issue", description: "discover, plan, queue, execute, from-brainstorm, convert-to-plan" },
96
- { label: "Utility", description: "clean, spec:setup, spec:add, replan, status" }
97
- ],
98
- multiSelect: false
99
- }]
100
- });
101
- }
102
- ```
103
-
104
- ### Step 2.2: Select Specific Command
105
-
106
- ```javascript
107
- async function selectCommand(category) {
108
- const commandOptions = {
109
- 'Planning': [
110
- { label: "/workflow-lite-plan", description: "Lightweight merged-mode planning" },
111
- { label: "/workflow-plan", description: "Full planning with architecture design" },
112
- { label: "/workflow-multi-cli-plan", description: "Multi-CLI collaborative planning (Gemini+Codex+Claude)" },
113
- { label: "/workflow-tdd-plan", description: "TDD workflow planning with Red-Green-Refactor" },
114
- { label: "/workflow:quick-plan-with-file", description: "Rapid planning with minimal docs" },
115
- { label: "/workflow-plan-verify", description: "Verify plan against requirements" },
116
- { label: "/workflow:replan", description: "Update plan and execute changes" }
117
- ],
118
- 'Execution': [
119
- { label: "/workflow-execute", description: "Execute from planning session" },
120
- { label: "/workflow:unified-execute-with-file", description: "Universal execution engine" }
121
- ],
122
- 'Testing': [
123
- { label: "/workflow-test-fix", description: "Generate test tasks for specific issues" },
124
- { label: "/workflow-test-fix", description: "Execute iterative test-fix cycle (>=95% pass)" },
125
- { label: "/workflow:test-gen", description: "Generate comprehensive test suite" },
126
- { label: "/workflow-tdd-verify", description: "Verify TDD workflow compliance" }
127
- ],
128
- 'Review': [
129
- { label: "/workflow:review-session-cycle", description: "Session-based multi-dimensional code review" },
130
- { label: "/workflow:review-module-cycle", description: "Module-focused code review" },
131
- { label: "/workflow:review-cycle-fix", description: "Fix review findings with prioritization" },
132
- { label: "/workflow:review", description: "Post-implementation review" }
133
- ],
134
- 'Bug Fix': [
135
- { label: "/workflow-lite-plan", description: "Lightweight bug diagnosis and fix (with --bugfix flag)" },
136
- { label: "/workflow:debug-with-file", description: "Hypothesis-driven debugging with documentation" }
137
- ],
138
- 'Brainstorm': [
139
- { label: "/workflow:brainstorm-with-file", description: "Multi-perspective ideation with documentation" },
140
- { label: "/brainstorm", description: "Unified brainstorming skill (auto-parallel + role analysis)" }
141
- ],
142
- 'Analysis': [
143
- { label: "/workflow:analyze-with-file", description: "Collaborative analysis with documentation" }
144
- ],
145
- 'Issue': [
146
- { label: "/issue:discover", description: "Multi-perspective issue discovery" },
147
- { label: "/issue:discover-by-prompt", description: "Prompt-based issue discovery with Gemini" },
148
- { label: "/issue:plan", description: "Plan issue solutions" },
149
- { label: "/issue:queue", description: "Form execution queue with conflict analysis" },
150
- { label: "/issue:execute", description: "Execute issue queue with DAG orchestration" },
151
- { label: "/issue:from-brainstorm", description: "Convert brainstorm to issue" },
152
- { label: "/issue:convert-to-plan", description: "Convert planning artifacts to issue solutions" }
153
- ],
154
- 'Utility': [
155
- { label: "/workflow:clean", description: "Intelligent code cleanup" },
156
- { label: "/workflow:spec:setup", description: "Initialize project-level state" },
157
- { label: "/workflow:replan", description: "Interactive workflow replanning" },
158
- { label: "/workflow:status", description: "Generate workflow status views" }
159
- ]
160
- };
161
-
162
- return await AskUserQuestion({
163
- questions: [{
164
- question: `Select ${category} command`,
165
- header: "Command",
166
- options: commandOptions[category] || commandOptions['Planning'],
167
- multiSelect: false
168
- }]
169
- });
170
- }
171
- ```
172
-
173
- ### Step 2.3: Select Execution Unit
174
-
175
- ```javascript
176
- async function selectExecutionUnit() {
177
- return await AskUserQuestion({
178
- questions: [{
179
- question: "Select execution unit (atomic command group)",
180
- header: "Unit",
181
- options: [
182
- // Planning + Execution Units
183
- { label: "quick-implementation", description: "【lite-plan】" },
184
- { label: "multi-cli-planning", description: "【multi-cli-plan】" },
185
- { label: "full-planning-execution", description: "【plan → execute】" },
186
- { label: "verified-planning-execution", description: "【plan → plan-verify → execute】" },
187
- { label: "replanning-execution", description: "【replan → execute】" },
188
- { label: "tdd-planning-execution", description: "【tdd-plan → execute】" },
189
- // Testing Units
190
- { label: "test-validation", description: "【test-fix-gen → test-cycle-execute】" },
191
- { label: "test-generation-execution", description: "【test-gen → execute】" },
192
- // Review Units
193
- { label: "code-review", description: "【review-*-cycle → review-cycle-fix】" },
194
- // Bug Fix Units
195
- { label: "bug-fix", description: "【lite-plan --bugfix】" },
196
- // Issue Units
197
- { label: "issue-workflow", description: "【discover → plan → queue → execute】" },
198
- { label: "rapid-to-issue", description: "【lite-plan → convert-to-plan → queue → execute】" },
199
- { label: "brainstorm-to-issue", description: "【from-brainstorm → queue → execute】" },
200
- // With-File Units (self-contained)
201
- { label: "brainstorm-with-file", description: "Self-contained brainstorming workflow" },
202
- { label: "debug-with-file", description: "Self-contained debugging workflow" },
203
- { label: "analyze-with-file", description: "Self-contained analysis workflow" },
204
- // Standalone
205
- { label: "standalone", description: "Single command, no atomic grouping" }
206
- ],
207
- multiSelect: false
208
- }]
209
- });
210
- }
211
- ```
212
-
213
- ### Step 2.4: Select Execution Mode
214
-
215
- ```javascript
216
- async function selectExecutionMode() {
217
- return await AskUserQuestion({
218
- questions: [{
219
- question: "Execution mode for this step?",
220
- header: "Mode",
221
- options: [
222
- { label: "mainprocess", description: "Run in main process (blocking, synchronous)" },
223
- { label: "async", description: "Run asynchronously (background, hook callbacks)" }
224
- ],
225
- multiSelect: false
226
- }]
227
- });
228
- }
229
- ```
230
-
231
- ### Complete Step Definition Flow
232
-
233
- ```javascript
234
- async function defineSteps(templateDesign) {
235
- // Suggest steps based on purpose
236
- const suggestedSteps = getSuggestedSteps(templateDesign.purpose);
237
-
238
- const customize = await AskUserQuestion({
239
- questions: [{
240
- question: "Use suggested steps or customize?",
241
- header: "Steps",
242
- options: [
243
- { label: "Use Suggested", description: `Suggested: ${suggestedSteps.map(s => s.cmd).join(' → ')}` },
244
- { label: "Customize", description: "Modify or add custom steps" },
245
- { label: "Start Empty", description: "Define all steps from scratch" }
246
- ],
247
- multiSelect: false
248
- }]
249
- });
250
-
251
- if (customize.Steps === "Use Suggested") {
252
- return suggestedSteps;
253
- }
254
-
255
- // Interactive step definition
256
- const steps = [];
257
- let addMore = true;
258
- while (addMore) {
259
- const category = await selectCommandCategory();
260
- const command = await selectCommand(category.Category);
261
- const unit = await selectExecutionUnit();
262
- const execMode = await selectExecutionMode();
263
- const contextHint = await askContextHint(command.Command);
264
-
265
- steps.push({
266
- cmd: command.Command,
267
- args: command.Command.includes('plan') || command.Command.includes('fix') ? '"{{goal}}"' : undefined,
268
- unit: unit.Unit,
269
- execution: {
270
- type: "slash-command",
271
- mode: execMode.Mode
272
- },
273
- contextHint: contextHint
274
- });
275
-
276
- const continueAdding = await AskUserQuestion({
277
- questions: [{
278
- question: `Added step ${steps.length}: ${command.Command}. Add another?`,
279
- header: "Continue",
280
- options: [
281
- { label: "Add More", description: "Define another step" },
282
- { label: "Done", description: "Finish step definition" }
283
- ],
284
- multiSelect: false
285
- }]
286
- });
287
- addMore = continueAdding.Continue === "Add More";
288
- }
289
-
290
- return steps;
291
- }
292
- ```
293
-
294
- ---
295
-
296
- ## Suggested Step Templates
297
-
298
- ### Feature Development (Level 2 - Rapid)
299
- ```json
300
- {
301
- "name": "rapid",
302
- "description": "Quick implementation with testing",
303
- "level": 2,
304
- "steps": [
305
- { "cmd": "/workflow-lite-plan", "args": "\"{{goal}}\"", "unit": "quick-implementation", "execution": { "type": "slash-command", "mode": "mainprocess" }, "contextHint": "Create lightweight implementation plan (includes execution)" },
306
- { "cmd": "/workflow-test-fix", "unit": "test-validation", "execution": { "type": "slash-command", "mode": "mainprocess" }, "contextHint": "Generate test tasks" },
307
- { "cmd": "/workflow-test-fix", "unit": "test-validation", "execution": { "type": "slash-command", "mode": "async" }, "contextHint": "Execute test-fix cycle until pass rate >= 95%" }
308
- ]
309
- }
310
- ```
311
-
312
- ### Feature Development (Level 3 - Coupled)
313
- ```json
314
- {
315
- "name": "coupled",
316
- "description": "Full workflow with verification, review, and testing",
317
- "level": 3,
318
- "steps": [
319
- { "cmd": "/workflow-plan", "args": "\"{{goal}}\"", "unit": "verified-planning-execution", "execution": { "type": "slash-command", "mode": "mainprocess" }, "contextHint": "Create detailed implementation plan" },
320
- { "cmd": "/workflow-plan-verify", "unit": "verified-planning-execution", "execution": { "type": "slash-command", "mode": "mainprocess" }, "contextHint": "Verify plan against requirements" },
321
- { "cmd": "/workflow-execute", "unit": "verified-planning-execution", "execution": { "type": "slash-command", "mode": "async" }, "contextHint": "Execute implementation" },
322
- { "cmd": "/workflow:review-session-cycle", "unit": "code-review", "execution": { "type": "slash-command", "mode": "mainprocess" }, "contextHint": "Multi-dimensional code review" },
323
- { "cmd": "/workflow:review-cycle-fix", "unit": "code-review", "execution": { "type": "slash-command", "mode": "mainprocess" }, "contextHint": "Fix review findings" },
324
- { "cmd": "/workflow-test-fix", "unit": "test-validation", "execution": { "type": "slash-command", "mode": "mainprocess" }, "contextHint": "Generate test tasks" },
325
- { "cmd": "/workflow-test-fix", "unit": "test-validation", "execution": { "type": "slash-command", "mode": "async" }, "contextHint": "Execute test-fix cycle" }
326
- ]
327
- }
328
- ```
329
-
330
- ### Bug Fix (Level 2)
331
- ```json
332
- {
333
- "name": "bugfix",
334
- "description": "Bug diagnosis and fix with testing",
335
- "level": 2,
336
- "steps": [
337
- { "cmd": "/workflow-lite-plan", "args": "--bugfix \"{{goal}}\"", "unit": "bug-fix", "execution": { "type": "slash-command", "mode": "mainprocess" }, "contextHint": "Diagnose, plan, and execute bug fix" },
338
- { "cmd": "/workflow-test-fix", "unit": "test-validation", "execution": { "type": "slash-command", "mode": "mainprocess" }, "contextHint": "Generate regression tests" },
339
- { "cmd": "/workflow-test-fix", "unit": "test-validation", "execution": { "type": "slash-command", "mode": "async" }, "contextHint": "Verify fix with tests" }
340
- ]
341
- }
342
- ```
343
-
344
- ### Bug Fix Hotfix (Level 2)
345
- ```json
346
- {
347
- "name": "bugfix-hotfix",
348
- "description": "Urgent production bug fix (no tests)",
349
- "level": 2,
350
- "steps": [
351
- { "cmd": "/workflow-lite-plan", "args": "--hotfix \"{{goal}}\"", "unit": "standalone", "execution": { "type": "slash-command", "mode": "mainprocess" }, "contextHint": "Emergency hotfix mode" }
352
- ]
353
- }
354
- ```
355
-
356
- ### TDD Development (Level 3)
357
- ```json
358
- {
359
- "name": "tdd",
360
- "description": "Test-driven development with Red-Green-Refactor",
361
- "level": 3,
362
- "steps": [
363
- { "cmd": "/workflow-tdd-plan", "args": "\"{{goal}}\"", "unit": "tdd-planning-execution", "execution": { "type": "slash-command", "mode": "mainprocess" }, "contextHint": "Create TDD task chain" },
364
- { "cmd": "/workflow-execute", "unit": "tdd-planning-execution", "execution": { "type": "slash-command", "mode": "async" }, "contextHint": "Execute TDD cycle" },
365
- { "cmd": "/workflow-tdd-verify", "unit": "standalone", "execution": { "type": "slash-command", "mode": "mainprocess" }, "contextHint": "Verify TDD compliance" }
366
- ]
367
- }
368
- ```
369
-
370
- ### Code Review (Level 3)
371
- ```json
372
- {
373
- "name": "review",
374
- "description": "Code review cycle with fixes and testing",
375
- "level": 3,
376
- "steps": [
377
- { "cmd": "/workflow:review-session-cycle", "unit": "code-review", "execution": { "type": "slash-command", "mode": "mainprocess" }, "contextHint": "Multi-dimensional code review" },
378
- { "cmd": "/workflow:review-cycle-fix", "unit": "code-review", "execution": { "type": "slash-command", "mode": "mainprocess" }, "contextHint": "Fix review findings" },
379
- { "cmd": "/workflow-test-fix", "unit": "test-validation", "execution": { "type": "slash-command", "mode": "mainprocess" }, "contextHint": "Generate tests for fixes" },
380
- { "cmd": "/workflow-test-fix", "unit": "test-validation", "execution": { "type": "slash-command", "mode": "async" }, "contextHint": "Verify fixes pass tests" }
381
- ]
382
- }
383
- ```
384
-
385
- ### Test Fix (Level 3)
386
- ```json
387
- {
388
- "name": "test-fix",
389
- "description": "Fix failing tests",
390
- "level": 3,
391
- "steps": [
392
- { "cmd": "/workflow-test-fix", "args": "\"{{goal}}\"", "unit": "test-validation", "execution": { "type": "slash-command", "mode": "mainprocess" }, "contextHint": "Generate test fix tasks" },
393
- { "cmd": "/workflow-test-fix", "unit": "test-validation", "execution": { "type": "slash-command", "mode": "async" }, "contextHint": "Execute test-fix cycle" }
394
- ]
395
- }
396
- ```
397
-
398
- ### Issue Workflow (Level Issue)
399
- ```json
400
- {
401
- "name": "issue",
402
- "description": "Complete issue lifecycle",
403
- "level": "Issue",
404
- "steps": [
405
- { "cmd": "/issue:discover", "unit": "issue-workflow", "execution": { "type": "slash-command", "mode": "mainprocess" }, "contextHint": "Discover issues from codebase" },
406
- { "cmd": "/issue:plan", "args": "--all-pending", "unit": "issue-workflow", "execution": { "type": "slash-command", "mode": "mainprocess" }, "contextHint": "Plan issue solutions" },
407
- { "cmd": "/issue:queue", "unit": "issue-workflow", "execution": { "type": "slash-command", "mode": "mainprocess" }, "contextHint": "Form execution queue" },
408
- { "cmd": "/issue:execute", "unit": "issue-workflow", "execution": { "type": "slash-command", "mode": "async" }, "contextHint": "Execute issue queue" }
409
- ]
410
- }
411
- ```
412
-
413
- ### Rapid to Issue (Level 2.5)
414
- ```json
415
- {
416
- "name": "rapid-to-issue",
417
- "description": "Bridge lightweight planning to issue workflow",
418
- "level": 2,
419
- "steps": [
420
- { "cmd": "/workflow-lite-plan", "args": "\"{{goal}}\"", "unit": "rapid-to-issue", "execution": { "type": "slash-command", "mode": "mainprocess" }, "contextHint": "Create lightweight plan" },
421
- { "cmd": "/issue:convert-to-plan", "args": "--latest-lite-plan -y", "unit": "rapid-to-issue", "execution": { "type": "slash-command", "mode": "mainprocess" }, "contextHint": "Convert to issue plan" },
422
- { "cmd": "/issue:queue", "unit": "rapid-to-issue", "execution": { "type": "slash-command", "mode": "mainprocess" }, "contextHint": "Form execution queue" },
423
- { "cmd": "/issue:execute", "args": "--queue auto", "unit": "rapid-to-issue", "execution": { "type": "slash-command", "mode": "async" }, "contextHint": "Execute issue queue" }
424
- ]
425
- }
426
- ```
427
-
428
- ### Brainstorm to Issue (Level 4)
429
- ```json
430
- {
431
- "name": "brainstorm-to-issue",
432
- "description": "Bridge brainstorm session to issue workflow",
433
- "level": 4,
434
- "steps": [
435
- { "cmd": "/issue:from-brainstorm", "args": "SESSION=\"{{session}}\" --auto", "unit": "brainstorm-to-issue", "execution": { "type": "slash-command", "mode": "mainprocess" }, "contextHint": "Convert brainstorm to issue" },
436
- { "cmd": "/issue:queue", "unit": "brainstorm-to-issue", "execution": { "type": "slash-command", "mode": "mainprocess" }, "contextHint": "Form execution queue" },
437
- { "cmd": "/issue:execute", "args": "--queue auto", "unit": "brainstorm-to-issue", "execution": { "type": "slash-command", "mode": "async" }, "contextHint": "Execute issue queue" }
438
- ]
439
- }
440
- ```
441
-
442
- ### With-File: Brainstorm (Level 4)
443
- ```json
444
- {
445
- "name": "brainstorm",
446
- "description": "Multi-perspective ideation with documentation",
447
- "level": 4,
448
- "steps": [
449
- { "cmd": "/workflow:brainstorm-with-file", "args": "\"{{goal}}\"", "unit": "brainstorm-with-file", "execution": { "type": "slash-command", "mode": "mainprocess" }, "contextHint": "Multi-CLI brainstorming with documented diverge-converge cycles" }
450
- ]
451
- }
452
- ```
453
-
454
- ### With-File: Debug (Level 3)
455
- ```json
456
- {
457
- "name": "debug",
458
- "description": "Hypothesis-driven debugging with documentation",
459
- "level": 3,
460
- "steps": [
461
- { "cmd": "/workflow:debug-with-file", "args": "\"{{goal}}\"", "unit": "debug-with-file", "execution": { "type": "slash-command", "mode": "mainprocess" }, "contextHint": "Hypothesis-driven debugging with Gemini validation" }
462
- ]
463
- }
464
- ```
465
-
466
- ### With-File: Analyze (Level 3)
467
- ```json
468
- {
469
- "name": "analyze",
470
- "description": "Collaborative analysis with documentation",
471
- "level": 3,
472
- "steps": [
473
- { "cmd": "/workflow:analyze-with-file", "args": "\"{{goal}}\"", "unit": "analyze-with-file", "execution": { "type": "slash-command", "mode": "mainprocess" }, "contextHint": "Multi-round collaborative analysis with CLI exploration" }
474
- ]
475
- }
476
- ```
477
-
478
- ### Full Workflow (Level 4)
479
- ```json
480
- {
481
- "name": "full",
482
- "description": "Complete workflow: brainstorm → plan → execute → test",
483
- "level": 4,
484
- "steps": [
485
- { "cmd": "/brainstorm", "args": "\"{{goal}}\"", "unit": "standalone", "execution": { "type": "slash-command", "mode": "mainprocess" }, "contextHint": "Unified brainstorming with multi-perspective exploration" },
486
- { "cmd": "/workflow-plan", "unit": "verified-planning-execution", "execution": { "type": "slash-command", "mode": "mainprocess" }, "contextHint": "Create detailed plan from brainstorm" },
487
- { "cmd": "/workflow-plan-verify", "unit": "verified-planning-execution", "execution": { "type": "slash-command", "mode": "mainprocess" }, "contextHint": "Verify plan quality" },
488
- { "cmd": "/workflow-execute", "unit": "verified-planning-execution", "execution": { "type": "slash-command", "mode": "async" }, "contextHint": "Execute implementation" },
489
- { "cmd": "/workflow-test-fix", "unit": "test-validation", "execution": { "type": "slash-command", "mode": "mainprocess" }, "contextHint": "Generate comprehensive tests" },
490
- { "cmd": "/workflow-test-fix", "unit": "test-validation", "execution": { "type": "slash-command", "mode": "async" }, "contextHint": "Execute test cycle" }
491
- ]
492
- }
493
- ```
494
-
495
- ### Multi-CLI Planning (Level 3)
496
- ```json
497
- {
498
- "name": "multi-cli-plan",
499
- "description": "Multi-CLI collaborative planning with cross-verification",
500
- "level": 3,
501
- "steps": [
502
- { "cmd": "/workflow-multi-cli-plan", "args": "\"{{goal}}\"", "unit": "multi-cli-planning", "execution": { "type": "slash-command", "mode": "mainprocess" }, "contextHint": "Gemini+Codex+Claude collaborative planning" },
503
- // lite-execute is now an internal phase of multi-cli-plan (not invoked separately)
504
- { "cmd": "/workflow-test-fix", "unit": "test-validation", "execution": { "type": "slash-command", "mode": "mainprocess" }, "contextHint": "Generate tests" },
505
- { "cmd": "/workflow-test-fix", "unit": "test-validation", "execution": { "type": "slash-command", "mode": "async" }, "contextHint": "Execute test cycle" }
506
- ]
507
- }
508
- ```
509
-
510
- ### Ultra-Lightweight (Level 1)
511
-
512
- > **Note**: `lite-lite-lite` has been removed. Use `bugfix-hotfix` for Level 1 urgent tasks, or `rapid` (Level 2) for simple features.
513
-
514
- ---
515
-
516
- ## Command Port Reference
517
-
518
- Each command has input/output ports for pipeline composition:
519
-
520
- | Command | Input Port | Output Port | Atomic Unit |
521
- |---------|------------|-------------|-------------|
522
- | **Planning** |
523
- | lite-plan | requirement | plan | quick-implementation |
524
- | plan | requirement | detailed-plan | full-planning-execution |
525
- | plan-verify | detailed-plan | verified-plan | verified-planning-execution |
526
- | multi-cli-plan | requirement | multi-cli-plan | multi-cli-planning |
527
- | tdd-plan | requirement | tdd-tasks | tdd-planning-execution |
528
- | replan | session, feedback | replan | replanning-execution |
529
- | **Execution** |
530
- | ~~lite-execute~~ | _(internal phase of lite-plan/multi-cli-plan, not standalone)_ | code | — |
531
- | execute | detailed-plan, verified-plan, replan, tdd-tasks | code | (multiple) |
532
- | **Testing** |
533
- | test-fix-gen | failing-tests, session | test-tasks | test-validation |
534
- | test-cycle-execute | test-tasks | test-passed | test-validation |
535
- | test-gen | code, session | test-tasks | test-generation-execution |
536
- | tdd-verify | code | tdd-verified | standalone |
537
- | **Review** |
538
- | review-session-cycle | code, session | review-verified | code-review |
539
- | review-module-cycle | module-pattern | review-verified | code-review |
540
- | review-cycle-fix | review-findings | fixed-code | code-review |
541
- | **Bug Fix** |
542
- | lite-plan --bugfix | bug-report | plan | bug-fix |
543
- | debug-with-file | bug-report | understanding-document | debug-with-file |
544
- | **With-File** |
545
- | brainstorm-with-file | exploration-topic | brainstorm-document | brainstorm-with-file |
546
- | analyze-with-file | analysis-topic | discussion-document | analyze-with-file |
547
- | **Issue** |
548
- | issue:discover | codebase | pending-issues | issue-workflow |
549
- | issue:plan | pending-issues | issue-plans | issue-workflow |
550
- | issue:queue | issue-plans, converted-plan | execution-queue | issue-workflow |
551
- | issue:execute | execution-queue | completed-issues | issue-workflow |
552
- | issue:convert-to-plan | plan | converted-plan | rapid-to-issue |
553
- | issue:from-brainstorm | brainstorm-document | converted-plan | brainstorm-to-issue |
554
-
555
- ---
556
-
557
- ## Minimum Execution Units (最小执行单元)
558
-
559
- **Definition**: Commands that must execute together as an atomic group.
560
-
561
- | Unit Name | Commands | Purpose |
562
- |-----------|----------|---------|
563
- | **quick-implementation** | lite-plan (Phase 1: plan → Phase 2: execute) | Lightweight plan and execution |
564
- | **multi-cli-planning** | multi-cli-plan (Phase 1: plan → Phase 2: execute) | Multi-perspective planning and execution |
565
- | **bug-fix** | lite-plan --bugfix (Phase 1: plan → Phase 2: execute) | Bug diagnosis and fix |
566
- | **full-planning-execution** | plan → execute | Detailed planning and execution |
567
- | **verified-planning-execution** | plan → plan-verify → execute | Planning with verification |
568
- | **replanning-execution** | replan → execute | Update plan and execute |
569
- | **tdd-planning-execution** | tdd-plan → execute | TDD planning and execution |
570
- | **test-validation** | test-fix-gen → test-cycle-execute | Test generation and fix cycle |
571
- | **test-generation-execution** | test-gen → execute | Generate and execute tests |
572
- | **code-review** | review-*-cycle → review-cycle-fix | Review and fix findings |
573
- | **issue-workflow** | discover → plan → queue → execute | Complete issue lifecycle |
574
- | **rapid-to-issue** | lite-plan → convert-to-plan → queue → execute | Bridge to issue workflow |
575
- | **brainstorm-to-issue** | from-brainstorm → queue → execute | Brainstorm to issue bridge |
576
- | **brainstorm-with-file** | (self-contained) | Multi-perspective ideation |
577
- | **debug-with-file** | (self-contained) | Hypothesis-driven debugging |
578
- | **analyze-with-file** | (self-contained) | Collaborative analysis |
579
-
580
- ---
581
-
582
- ## Phase 3: Generate JSON
583
-
584
- ```javascript
585
- async function generateTemplate(design, steps, outputPath) {
586
- const template = {
587
- name: design.name,
588
- description: design.description,
589
- level: design.level,
590
- steps: steps
591
- };
592
-
593
- const finalPath = outputPath || `~/.claude/skills/flow-coordinator/templates/${design.name}.json`;
594
-
595
- // Write template
596
- Write(finalPath, JSON.stringify(template, null, 2));
597
-
598
- // Validate
599
- const validation = validateTemplate(template);
600
-
601
- console.log(`✅ Template created: ${finalPath}`);
602
- console.log(` Steps: ${template.steps.length}`);
603
- console.log(` Level: ${template.level}`);
604
- console.log(` Units: ${[...new Set(template.steps.map(s => s.unit))].join(', ')}`);
605
-
606
- return { path: finalPath, template, validation };
607
- }
608
- ```
609
-
610
- ---
611
-
612
- ## Output Format
613
-
614
- ```json
615
- {
616
- "name": "template-name",
617
- "description": "Template description",
618
- "level": 2,
619
- "steps": [
620
- {
621
- "cmd": "/workflow:command",
622
- "args": "\"{{goal}}\"",
623
- "unit": "unit-name",
624
- "execution": {
625
- "type": "slash-command",
626
- "mode": "mainprocess"
627
- },
628
- "contextHint": "Description of what this step does"
629
- }
630
- ]
631
- }
632
- ```
633
-
634
- ---
635
-
636
- ## Examples
637
-
638
- **Create a quick bugfix template**:
639
- ```
640
- /meta-skill:flow-create hotfix-simple
641
-
642
- → Purpose: Bug Fix
643
- → Level: 2 (Lightweight)
644
- → Steps: Use Suggested
645
- → Output: ~/.claude/skills/flow-coordinator/templates/hotfix-simple.json
646
- ```
647
-
648
- **Create a custom multi-stage workflow**:
649
- ```
650
- /meta-skill:flow-create complex-feature --output ~/.claude/skills/my-project/templates/
651
-
652
- → Purpose: Feature Development
653
- → Level: 3 (Standard)
654
- → Steps: Customize
655
- → Step 1: /brainstorm (standalone, mainprocess)
656
- → Step 2: /workflow-plan (verified-planning-execution, mainprocess)
657
- → Step 3: /workflow-plan-verify (verified-planning-execution, mainprocess)
658
- → Step 4: /workflow-execute (verified-planning-execution, async)
659
- → Step 5: /workflow:review-session-cycle (code-review, mainprocess)
660
- → Step 6: /workflow:review-cycle-fix (code-review, mainprocess)
661
- → Done
662
- → Output: ~/.claude/skills/my-project/templates/complex-feature.json
663
- ```
Binary file