claude-code-workflow 7.2.23 → 7.2.24

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 (181) hide show
  1. package/.codex/skills/team-arch-opt/SKILL.md +242 -175
  2. package/.codex/skills/team-arch-opt/roles/analyzer/role.md +78 -78
  3. package/.codex/skills/team-arch-opt/roles/coordinator/commands/analyze.md +57 -57
  4. package/.codex/skills/team-arch-opt/roles/coordinator/commands/monitor.md +246 -204
  5. package/.codex/skills/team-arch-opt/roles/coordinator/role.md +196 -184
  6. package/.codex/skills/team-arch-opt/roles/designer/role.md +115 -115
  7. package/.codex/skills/team-arch-opt/roles/refactorer/role.md +102 -102
  8. package/.codex/skills/team-arch-opt/roles/reviewer/role.md +111 -111
  9. package/.codex/skills/team-arch-opt/roles/validator/role.md +115 -115
  10. package/.codex/skills/team-arch-opt/specs/pipelines.md +102 -102
  11. package/.codex/skills/team-brainstorm/SKILL.md +72 -4
  12. package/.codex/skills/team-brainstorm/roles/challenger/role.md +61 -61
  13. package/.codex/skills/team-brainstorm/roles/coordinator/commands/analyze.md +58 -58
  14. package/.codex/skills/team-brainstorm/roles/coordinator/commands/monitor.md +212 -171
  15. package/.codex/skills/team-brainstorm/roles/coordinator/role.md +172 -160
  16. package/.codex/skills/team-brainstorm/roles/evaluator/role.md +56 -56
  17. package/.codex/skills/team-brainstorm/roles/ideator/role.md +69 -69
  18. package/.codex/skills/team-brainstorm/roles/synthesizer/role.md +57 -57
  19. package/.codex/skills/team-brainstorm/specs/pipelines.md +72 -72
  20. package/.codex/skills/team-coordinate/SKILL.md +71 -3
  21. package/.codex/skills/team-coordinate/roles/coordinator/commands/monitor.md +45 -5
  22. package/.codex/skills/team-coordinate/roles/coordinator/role.md +402 -389
  23. package/.codex/skills/team-coordinate/specs/knowledge-transfer.md +111 -111
  24. package/.codex/skills/team-coordinate/specs/pipelines.md +97 -97
  25. package/.codex/skills/team-coordinate/specs/quality-gates.md +112 -112
  26. package/.codex/skills/team-designer/SKILL.md +153 -153
  27. package/.codex/skills/team-designer/phases/01-requirements-analysis.md +250 -250
  28. package/.codex/skills/team-designer/phases/02-scaffold-generation.md +228 -228
  29. package/.codex/skills/team-designer/phases/03-content-generation.md +330 -330
  30. package/.codex/skills/team-designer/phases/04-validation.md +320 -320
  31. package/.codex/skills/team-executor/SKILL.md +29 -2
  32. package/.codex/skills/team-executor/roles/executor/commands/monitor.md +23 -15
  33. package/.codex/skills/team-frontend/SKILL.md +77 -3
  34. package/.codex/skills/team-frontend/roles/analyst/role.md +92 -92
  35. package/.codex/skills/team-frontend/roles/architect/role.md +86 -86
  36. package/.codex/skills/team-frontend/roles/coordinator/commands/analyze.md +52 -52
  37. package/.codex/skills/team-frontend/roles/coordinator/commands/monitor.md +222 -188
  38. package/.codex/skills/team-frontend/roles/coordinator/role.md +189 -177
  39. package/.codex/skills/team-frontend/roles/developer/role.md +93 -93
  40. package/.codex/skills/team-frontend/roles/qa/role.md +79 -79
  41. package/.codex/skills/team-frontend/specs/pipelines.md +76 -76
  42. package/.codex/skills/team-frontend-debug/SKILL.md +66 -3
  43. package/.codex/skills/team-frontend-debug/roles/analyzer/role.md +208 -208
  44. package/.codex/skills/team-frontend-debug/roles/coordinator/commands/analyze.md +174 -174
  45. package/.codex/skills/team-frontend-debug/roles/coordinator/commands/dispatch.md +198 -198
  46. package/.codex/skills/team-frontend-debug/roles/coordinator/commands/monitor.md +177 -143
  47. package/.codex/skills/team-frontend-debug/roles/coordinator/role.md +164 -152
  48. package/.codex/skills/team-frontend-debug/roles/fixer/role.md +147 -147
  49. package/.codex/skills/team-frontend-debug/roles/reproducer/role.md +147 -147
  50. package/.codex/skills/team-frontend-debug/roles/tester/role.md +231 -231
  51. package/.codex/skills/team-frontend-debug/roles/verifier/role.md +172 -172
  52. package/.codex/skills/team-frontend-debug/specs/debug-tools.md +215 -215
  53. package/.codex/skills/team-frontend-debug/specs/pipelines.md +94 -94
  54. package/.codex/skills/team-issue/SKILL.md +83 -4
  55. package/.codex/skills/team-issue/roles/coordinator/commands/analyze.md +64 -64
  56. package/.codex/skills/team-issue/roles/coordinator/commands/dispatch.md +273 -273
  57. package/.codex/skills/team-issue/roles/coordinator/commands/monitor.md +235 -194
  58. package/.codex/skills/team-issue/roles/coordinator/role.md +206 -194
  59. package/.codex/skills/team-issue/roles/explorer/role.md +94 -94
  60. package/.codex/skills/team-issue/roles/implementer/role.md +87 -87
  61. package/.codex/skills/team-issue/roles/integrator/role.md +84 -84
  62. package/.codex/skills/team-issue/roles/planner/role.md +81 -81
  63. package/.codex/skills/team-issue/roles/reviewer/role.md +86 -86
  64. package/.codex/skills/team-issue/specs/pipelines.md +124 -124
  65. package/.codex/skills/team-iterdev/SKILL.md +64 -3
  66. package/.codex/skills/team-iterdev/roles/architect/role.md +65 -65
  67. package/.codex/skills/team-iterdev/roles/coordinator/commands/analyze.md +62 -62
  68. package/.codex/skills/team-iterdev/roles/coordinator/commands/monitor.md +227 -186
  69. package/.codex/skills/team-iterdev/roles/coordinator/role.md +193 -181
  70. package/.codex/skills/team-iterdev/roles/developer/role.md +74 -74
  71. package/.codex/skills/team-iterdev/roles/reviewer/role.md +66 -66
  72. package/.codex/skills/team-iterdev/roles/tester/role.md +88 -88
  73. package/.codex/skills/team-iterdev/specs/pipelines.md +94 -94
  74. package/.codex/skills/team-lifecycle-v4/MIGRATION-PLAN.md +6 -6
  75. package/.codex/skills/team-lifecycle-v4/SKILL.md +305 -242
  76. package/.codex/skills/team-lifecycle-v4/roles/coordinator/commands/dispatch.md +1 -1
  77. package/.codex/skills/team-lifecycle-v4/roles/coordinator/commands/monitor.md +66 -24
  78. package/.codex/skills/team-lifecycle-v4/roles/coordinator/role.md +13 -1
  79. package/.codex/skills/team-lifecycle-v4/roles/supervisor/role.md +1 -1
  80. package/.codex/skills/team-lifecycle-v4/templates/architecture.md +254 -254
  81. package/.codex/skills/team-lifecycle-v4/templates/epics.md +196 -196
  82. package/.codex/skills/team-lifecycle-v4/templates/product-brief.md +133 -133
  83. package/.codex/skills/team-lifecycle-v4/templates/requirements.md +224 -224
  84. package/.codex/skills/team-perf-opt/SKILL.md +68 -3
  85. package/.codex/skills/team-perf-opt/roles/benchmarker/role.md +89 -89
  86. package/.codex/skills/team-perf-opt/roles/coordinator/commands/analyze.md +61 -61
  87. package/.codex/skills/team-perf-opt/roles/coordinator/commands/monitor.md +35 -1
  88. package/.codex/skills/team-perf-opt/roles/coordinator/role.md +179 -167
  89. package/.codex/skills/team-perf-opt/roles/optimizer/role.md +97 -97
  90. package/.codex/skills/team-perf-opt/roles/profiler/role.md +73 -73
  91. package/.codex/skills/team-perf-opt/roles/reviewer/role.md +75 -75
  92. package/.codex/skills/team-perf-opt/roles/strategist/role.md +94 -94
  93. package/.codex/skills/team-perf-opt/specs/pipelines.md +65 -65
  94. package/.codex/skills/team-planex/SKILL.md +65 -3
  95. package/.codex/skills/team-planex/roles/coordinator/commands/analyze.md +52 -52
  96. package/.codex/skills/team-planex/roles/coordinator/commands/monitor.md +210 -164
  97. package/.codex/skills/team-planex/roles/coordinator/role.md +171 -159
  98. package/.codex/skills/team-planex/roles/executor/role.md +91 -91
  99. package/.codex/skills/team-planex/roles/planner/role.md +112 -112
  100. package/.codex/skills/team-planex/specs/pipelines.md +93 -93
  101. package/.codex/skills/team-quality-assurance/SKILL.md +60 -3
  102. package/.codex/skills/team-quality-assurance/roles/analyst/role.md +80 -80
  103. package/.codex/skills/team-quality-assurance/roles/coordinator/commands/analyze.md +72 -72
  104. package/.codex/skills/team-quality-assurance/roles/coordinator/commands/dispatch.md +108 -108
  105. package/.codex/skills/team-quality-assurance/roles/coordinator/commands/monitor.md +243 -209
  106. package/.codex/skills/team-quality-assurance/roles/coordinator/role.md +176 -164
  107. package/.codex/skills/team-quality-assurance/roles/executor/role.md +66 -66
  108. package/.codex/skills/team-quality-assurance/roles/generator/role.md +68 -68
  109. package/.codex/skills/team-quality-assurance/roles/scout/role.md +67 -67
  110. package/.codex/skills/team-quality-assurance/roles/strategist/role.md +71 -71
  111. package/.codex/skills/team-quality-assurance/specs/pipelines.md +115 -115
  112. package/.codex/skills/team-review/SKILL.md +58 -3
  113. package/.codex/skills/team-review/roles/coordinator/commands/analyze.md +71 -71
  114. package/.codex/skills/team-review/roles/coordinator/commands/dispatch.md +90 -90
  115. package/.codex/skills/team-review/roles/coordinator/commands/monitor.md +225 -185
  116. package/.codex/skills/team-review/roles/coordinator/role.md +175 -163
  117. package/.codex/skills/team-review/roles/fixer/role.md +76 -76
  118. package/.codex/skills/team-review/roles/reviewer/role.md +68 -68
  119. package/.codex/skills/team-review/roles/scanner/role.md +71 -71
  120. package/.codex/skills/team-review/specs/pipelines.md +102 -102
  121. package/.codex/skills/team-roadmap-dev/SKILL.md +55 -3
  122. package/.codex/skills/team-roadmap-dev/roles/coordinator/commands/analyze.md +61 -61
  123. package/.codex/skills/team-roadmap-dev/roles/coordinator/commands/monitor.md +502 -468
  124. package/.codex/skills/team-roadmap-dev/roles/coordinator/role.md +335 -322
  125. package/.codex/skills/team-roadmap-dev/roles/executor/role.md +71 -71
  126. package/.codex/skills/team-roadmap-dev/roles/planner/role.md +76 -76
  127. package/.codex/skills/team-roadmap-dev/roles/verifier/role.md +74 -74
  128. package/.codex/skills/team-roadmap-dev/specs/pipelines.md +93 -93
  129. package/.codex/skills/team-tech-debt/SKILL.md +56 -3
  130. package/.codex/skills/team-tech-debt/roles/assessor/role.md +69 -69
  131. package/.codex/skills/team-tech-debt/roles/coordinator/commands/analyze.md +47 -47
  132. package/.codex/skills/team-tech-debt/roles/coordinator/commands/monitor.md +272 -231
  133. package/.codex/skills/team-tech-debt/roles/coordinator/role.md +172 -160
  134. package/.codex/skills/team-tech-debt/roles/executor/role.md +76 -76
  135. package/.codex/skills/team-tech-debt/roles/planner/role.md +69 -69
  136. package/.codex/skills/team-tech-debt/roles/scanner/role.md +82 -82
  137. package/.codex/skills/team-tech-debt/roles/validator/role.md +75 -75
  138. package/.codex/skills/team-tech-debt/specs/pipelines.md +47 -47
  139. package/.codex/skills/team-testing/SKILL.md +72 -3
  140. package/.codex/skills/team-testing/roles/analyst/role.md +95 -95
  141. package/.codex/skills/team-testing/roles/coordinator/commands/analyze.md +70 -70
  142. package/.codex/skills/team-testing/roles/coordinator/commands/dispatch.md +106 -106
  143. package/.codex/skills/team-testing/roles/coordinator/commands/monitor.md +283 -242
  144. package/.codex/skills/team-testing/roles/coordinator/role.md +184 -172
  145. package/.codex/skills/team-testing/roles/executor/role.md +96 -96
  146. package/.codex/skills/team-testing/roles/generator/role.md +95 -95
  147. package/.codex/skills/team-testing/roles/strategist/role.md +83 -83
  148. package/.codex/skills/team-testing/specs/pipelines.md +101 -101
  149. package/.codex/skills/team-uidesign/SKILL.md +65 -3
  150. package/.codex/skills/team-uidesign/roles/coordinator/commands/analyze.md +59 -59
  151. package/.codex/skills/team-uidesign/roles/coordinator/commands/dispatch.md +156 -156
  152. package/.codex/skills/team-uidesign/roles/coordinator/commands/monitor.md +234 -194
  153. package/.codex/skills/team-uidesign/roles/coordinator/role.md +211 -199
  154. package/.codex/skills/team-uidesign/roles/designer/role.md +69 -69
  155. package/.codex/skills/team-uidesign/roles/implementer/role.md +72 -72
  156. package/.codex/skills/team-uidesign/roles/researcher/role.md +82 -82
  157. package/.codex/skills/team-uidesign/roles/reviewer/role.md +67 -67
  158. package/.codex/skills/team-uidesign/specs/pipelines.md +76 -76
  159. package/.codex/skills/team-ultra-analyze/SKILL.md +73 -3
  160. package/.codex/skills/team-ultra-analyze/roles/analyst/role.md +90 -90
  161. package/.codex/skills/team-ultra-analyze/roles/coordinator/commands/analyze.md +73 -73
  162. package/.codex/skills/team-ultra-analyze/roles/coordinator/commands/monitor.md +50 -9
  163. package/.codex/skills/team-ultra-analyze/roles/coordinator/role.md +255 -243
  164. package/.codex/skills/team-ultra-analyze/roles/discussant/role.md +104 -104
  165. package/.codex/skills/team-ultra-analyze/roles/explorer/role.md +74 -74
  166. package/.codex/skills/team-ultra-analyze/roles/synthesizer/role.md +78 -78
  167. package/.codex/skills/team-ultra-analyze/specs/pipelines.md +64 -64
  168. package/.codex/skills/team-ux-improve/SKILL.md +64 -3
  169. package/.codex/skills/team-ux-improve/roles/coordinator/commands/analyze.md +62 -62
  170. package/.codex/skills/team-ux-improve/roles/coordinator/commands/dispatch.md +233 -233
  171. package/.codex/skills/team-ux-improve/roles/coordinator/commands/monitor.md +195 -160
  172. package/.codex/skills/team-ux-improve/roles/coordinator/role.md +170 -158
  173. package/.codex/skills/team-ux-improve/roles/designer/role.md +122 -122
  174. package/.codex/skills/team-ux-improve/roles/diagnoser/role.md +93 -93
  175. package/.codex/skills/team-ux-improve/roles/explorer/role.md +77 -77
  176. package/.codex/skills/team-ux-improve/roles/implementer/role.md +102 -102
  177. package/.codex/skills/team-ux-improve/roles/scanner/role.md +93 -93
  178. package/.codex/skills/team-ux-improve/roles/tester/role.md +84 -84
  179. package/.codex/skills/team-ux-improve/specs/pipelines.md +54 -54
  180. package/README.md +1 -0
  181. package/package.json +1 -1
@@ -1,273 +1,273 @@
1
- # Dispatch
2
-
3
- Create the issue resolution task chain with correct dependencies and structured task descriptions based on selected pipeline mode.
4
-
5
- ## Context Loading
6
-
7
- | Input | Source | Required |
8
- |-------|--------|----------|
9
- | Requirement | From coordinator Phase 1 | Yes |
10
- | Session folder | From coordinator Phase 2 | Yes |
11
- | Pipeline mode | From session.json mode | Yes |
12
- | Issue IDs | From session.json issue_ids | Yes |
13
- | Execution method | From session.json execution_method | Yes |
14
- | Code review | From session.json code_review | No |
15
-
16
- 1. Load requirement, pipeline mode, issue IDs, and execution method from session.json
17
- 2. Determine task chain from pipeline mode
18
-
19
- ## Task Description Template
20
-
21
- Every task is built as a JSON entry in the tasks array:
22
-
23
- ```json
24
- {
25
- "id": "<TASK-ID>",
26
- "title": "<TASK-ID>",
27
- "description": "PURPOSE: <what this task achieves> | Success: <completion criteria>\nTASK:\n - <step 1>\n - <step 2>\n - <step 3>\nCONTEXT:\n - Session: <session-folder>\n - Issue IDs: <issue-id-list>\n - Upstream artifacts: <artifact-list>\nEXPECTED: <deliverable path> + <quality criteria>\nCONSTRAINTS: <scope limits>\n---\nInnerLoop: false\nexecution_method: <method>\ncode_review: <setting>",
28
- "status": "pending",
29
- "role": "<role>",
30
- "prefix": "<PREFIX>",
31
- "deps": ["<dependency-list>"],
32
- "findings": "",
33
- "error": ""
34
- }
35
- ```
36
-
37
- ## Pipeline Router
38
-
39
- | Mode | Action |
40
- |------|--------|
41
- | quick | Create 4 tasks (EXPLORE -> SOLVE -> MARSHAL -> BUILD) |
42
- | full | Create 5 tasks (EXPLORE -> SOLVE -> AUDIT -> MARSHAL -> BUILD) |
43
- | batch | Create N+N+1+1+M tasks (EXPLORE-001..N -> SOLVE-001..N -> AUDIT-001 -> MARSHAL-001 -> BUILD-001..M) |
44
-
45
- ---
46
-
47
- ### Quick Pipeline
48
-
49
- Build tasks array and write to tasks.json:
50
-
51
- **EXPLORE-001** (explorer):
52
- ```json
53
- {
54
- "id": "EXPLORE-001",
55
- "title": "EXPLORE-001",
56
- "description": "PURPOSE: Analyze issue context and map codebase impact | Success: Context report with relevant files and dependencies\nTASK:\n - Load issue details via ccw issue status\n - Explore codebase for relevant files and patterns\n - Assess complexity and impact scope\nCONTEXT:\n - Session: <session-folder>\n - Issue IDs: <issue-id-list>\nEXPECTED: <session>/explorations/context-<issueId>.json with relevant files, dependencies, and impact assessment\nCONSTRAINTS: Exploration and analysis only, no solution design\n---\nInnerLoop: false",
57
- "status": "pending",
58
- "role": "explorer",
59
- "prefix": "EXPLORE",
60
- "deps": [],
61
- "findings": "",
62
- "error": ""
63
- }
64
- ```
65
-
66
- **SOLVE-001** (planner):
67
- ```json
68
- {
69
- "id": "SOLVE-001",
70
- "title": "SOLVE-001",
71
- "description": "PURPOSE: Design solution and decompose into implementation tasks | Success: Bound solution with task decomposition\nTASK:\n - Load explorer context report\n - Generate solution plan via CLI\n - Bind solution to issue\nCONTEXT:\n - Session: <session-folder>\n - Issue IDs: <issue-id-list>\n - Upstream artifacts: explorations/context-<issueId>.json\nEXPECTED: <session>/solutions/solution-<issueId>.json with solution plan and task list\nCONSTRAINTS: Solution design only, no code implementation\n---\nInnerLoop: false",
72
- "status": "pending",
73
- "role": "planner",
74
- "prefix": "SOLVE",
75
- "deps": ["EXPLORE-001"],
76
- "findings": "",
77
- "error": ""
78
- }
79
- ```
80
-
81
- **MARSHAL-001** (integrator):
82
- ```json
83
- {
84
- "id": "MARSHAL-001",
85
- "title": "MARSHAL-001",
86
- "description": "PURPOSE: Form execution queue with conflict detection and ordering | Success: Execution queue file with resolved conflicts\nTASK:\n - Verify all issues have bound solutions\n - Detect file conflicts between solutions\n - Produce ordered execution queue with DAG-based parallel groups\nCONTEXT:\n - Session: <session-folder>\n - Issue IDs: <issue-id-list>\n - Upstream artifacts: solutions/solution-<issueId>.json\nEXPECTED: .workflow/issues/queue/execution-queue.json with queue, conflicts, parallel groups\nCONSTRAINTS: Queue formation only, no implementation\n---\nInnerLoop: false",
87
- "status": "pending",
88
- "role": "integrator",
89
- "prefix": "MARSHAL",
90
- "deps": ["SOLVE-001"],
91
- "findings": "",
92
- "error": ""
93
- }
94
- ```
95
-
96
- **BUILD-001** (implementer):
97
- ```json
98
- {
99
- "id": "BUILD-001",
100
- "title": "BUILD-001",
101
- "description": "PURPOSE: Implement solution plan and verify with tests | Success: Code changes committed, tests pass\nTASK:\n - Load bound solution and explorer context\n - Route to execution backend (Auto/Codex/Gemini)\n - Run tests and verify implementation\n - Commit changes\nCONTEXT:\n - Session: <session-folder>\n - Issue IDs: <issue-id-list>\n - Upstream artifacts: explorations/context-<issueId>.json, solutions/solution-<issueId>.json, queue/execution-queue.json\nEXPECTED: <session>/builds/ with implementation results, tests passing\nCONSTRAINTS: Follow solution plan, no scope creep\n---\nInnerLoop: false\nexecution_method: <execution_method>\ncode_review: <code_review>",
102
- "status": "pending",
103
- "role": "implementer",
104
- "prefix": "BUILD",
105
- "deps": ["MARSHAL-001"],
106
- "findings": "",
107
- "error": ""
108
- }
109
- ```
110
-
111
- ---
112
-
113
- ### Full Pipeline
114
-
115
- Creates 5 tasks. EXPLORE-001 and SOLVE-001 same as Quick, then AUDIT gate before MARSHAL and BUILD.
116
-
117
- **AUDIT-001** (reviewer):
118
- ```json
119
- {
120
- "id": "AUDIT-001",
121
- "title": "AUDIT-001",
122
- "description": "PURPOSE: Review solution for technical feasibility, risk, and completeness | Success: Clear verdict (approved/concerns/rejected) with scores\nTASK:\n - Load explorer context and bound solution\n - Score across 3 dimensions: technical feasibility (40%), risk (30%), completeness (30%)\n - Produce verdict: approved (>=80), concerns (60-79), rejected (<60)\nCONTEXT:\n - Session: <session-folder>\n - Issue IDs: <issue-id-list>\n - Upstream artifacts: explorations/context-<issueId>.json, solutions/solution-<issueId>.json\nEXPECTED: <session>/audits/audit-report.json with per-issue scores and overall verdict\nCONSTRAINTS: Review only, do not modify solutions\n---\nInnerLoop: false",
123
- "status": "pending",
124
- "role": "reviewer",
125
- "prefix": "AUDIT",
126
- "deps": ["SOLVE-001"],
127
- "findings": "",
128
- "error": ""
129
- }
130
- ```
131
-
132
- **MARSHAL-001**: Same as Quick, but `deps: ["AUDIT-001"]`.
133
-
134
- **BUILD-001**: Same as Quick, `deps: ["MARSHAL-001"]`.
135
-
136
- ---
137
-
138
- ### Batch Pipeline
139
-
140
- Creates tasks in parallel batches. Issue count = N, BUILD tasks = M (from queue parallel groups).
141
-
142
- **EXPLORE-001..N** (explorer, parallel):
143
-
144
- For each issue in issue_ids (up to 5), create an EXPLORE task with distinct role:
145
-
146
- | Issue Count | Role Assignment |
147
- |-------------|-----------------|
148
- | N = 1 | role: "explorer" |
149
- | N > 1 | role: "explorer-1", "explorer-2", ..., "explorer-N" (max 5) |
150
-
151
- ```json
152
- {
153
- "id": "EXPLORE-<NNN>",
154
- "title": "EXPLORE-<NNN>",
155
- "description": "PURPOSE: Analyze issue <issueId> context and map codebase impact | Success: Context report for <issueId>\nTASK:\n - Load issue details for <issueId>\n - Explore codebase for relevant files\n - Assess complexity and impact scope\nCONTEXT:\n - Session: <session-folder>\n - Issue IDs: <issueId>\nEXPECTED: <session>/explorations/context-<issueId>.json\nCONSTRAINTS: Single issue scope, exploration only\n---\nInnerLoop: false",
156
- "status": "pending",
157
- "role": "explorer-<N>",
158
- "prefix": "EXPLORE",
159
- "deps": [],
160
- "findings": "",
161
- "error": ""
162
- }
163
- ```
164
-
165
- **SOLVE-001..N** (planner, sequential after all EXPLORE):
166
-
167
- ```json
168
- {
169
- "id": "SOLVE-<NNN>",
170
- "title": "SOLVE-<NNN>",
171
- "description": "PURPOSE: Design solution for <issueId> | Success: Bound solution with tasks\nTASK:\n - Load explorer context for <issueId>\n - Generate solution plan\n - Bind solution\nCONTEXT:\n - Session: <session-folder>\n - Issue IDs: <issueId>\n - Upstream artifacts: explorations/context-<issueId>.json\nEXPECTED: <session>/solutions/solution-<issueId>.json\nCONSTRAINTS: Solution design only\n---\nInnerLoop: false",
172
- "status": "pending",
173
- "role": "planner",
174
- "prefix": "SOLVE",
175
- "deps": ["EXPLORE-001", "...", "EXPLORE-<N>"],
176
- "findings": "",
177
- "error": ""
178
- }
179
- ```
180
-
181
- **AUDIT-001** (reviewer, batch review):
182
- ```json
183
- {
184
- "id": "AUDIT-001",
185
- "title": "AUDIT-001",
186
- "description": "PURPOSE: Batch review all solutions | Success: Verdict for each solution\nTASK:\n - Load all explorer contexts and bound solutions\n - Score each solution across 3 dimensions\n - Produce per-issue verdicts and overall verdict\nCONTEXT:\n - Session: <session-folder>\n - Issue IDs: <all-issue-ids>\n - Upstream artifacts: explorations/*.json, solutions/*.json\nEXPECTED: <session>/audits/audit-report.json with batch results\nCONSTRAINTS: Review only\n---\nInnerLoop: false",
187
- "status": "pending",
188
- "role": "reviewer",
189
- "prefix": "AUDIT",
190
- "deps": ["SOLVE-001", "...", "SOLVE-<N>"],
191
- "findings": "",
192
- "error": ""
193
- }
194
- ```
195
-
196
- **MARSHAL-001** (integrator): `deps: ["AUDIT-001"]`.
197
-
198
- **BUILD-001..M** (implementer, DAG parallel):
199
-
200
- > Note: In Batch mode, BUILD task count M is not known at dispatch time (depends on MARSHAL queue output). Defer BUILD task creation to handleCallback when MARSHAL completes. Coordinator creates BUILD tasks dynamically after reading execution-queue.json.
201
-
202
- When M is known (deferred creation after MARSHAL), assign distinct roles:
203
-
204
- | Build Count | Role Assignment |
205
- |-------------|-----------------|
206
- | M <= 2 | role: "implementer" |
207
- | M > 2 | role: "implementer-1", ..., "implementer-M" (max 3) |
208
-
209
- ```json
210
- {
211
- "id": "BUILD-<NNN>",
212
- "title": "BUILD-<NNN>",
213
- "description": "PURPOSE: Implement solution for <issueId> | Success: Code committed, tests pass\nTASK:\n - Load bound solution and explorer context\n - Execute implementation via <execution_method>\n - Run tests, commit\nCONTEXT:\n - Session: <session-folder>\n - Issue IDs: <issueId>\n - Upstream artifacts: explorations/context-<issueId>.json, solutions/solution-<issueId>.json, queue/execution-queue.json\nEXPECTED: <session>/builds/ with results\nCONSTRAINTS: Follow solution plan\n---\nInnerLoop: false\nexecution_method: <execution_method>\ncode_review: <code_review>",
214
- "status": "pending",
215
- "role": "implementer-<M>",
216
- "prefix": "BUILD",
217
- "deps": ["MARSHAL-001"],
218
- "findings": "",
219
- "error": ""
220
- }
221
- ```
222
-
223
- ---
224
-
225
- ### Review-Fix Cycle (Full/Batch modes)
226
-
227
- When AUDIT rejects a solution, coordinator creates fix tasks dynamically in handleCallback -- NOT at dispatch time.
228
-
229
- **SOLVE-fix-001** (planner, revision) -- added to tasks.json dynamically:
230
- ```json
231
- {
232
- "id": "SOLVE-fix-001",
233
- "title": "SOLVE-fix-001",
234
- "description": "PURPOSE: Revise solution addressing reviewer feedback (fix cycle <round>) | Success: Revised solution addressing rejection reasons\nTASK:\n - Read reviewer feedback from audit report\n - Design alternative approach addressing concerns\n - Re-bind revised solution\nCONTEXT:\n - Session: <session-folder>\n - Issue IDs: <rejected-issue-ids>\n - Upstream artifacts: audits/audit-report.json\n - Reviewer feedback: <rejection-reasons>\nEXPECTED: <session>/solutions/solution-<issueId>.json (revised)\nCONSTRAINTS: Address reviewer concerns specifically\n---\nInnerLoop: false",
235
- "status": "pending",
236
- "role": "planner",
237
- "prefix": "SOLVE",
238
- "deps": ["AUDIT-001"],
239
- "findings": "",
240
- "error": ""
241
- }
242
- ```
243
-
244
- **AUDIT-002** (reviewer, re-review) -- added to tasks.json dynamically:
245
- ```json
246
- {
247
- "id": "AUDIT-002",
248
- "title": "AUDIT-002",
249
- "description": "PURPOSE: Re-review revised solution (fix cycle <round>) | Success: Verdict on revised solution\nTASK:\n - Load revised solution\n - Re-evaluate previously rejected dimensions\n - Produce updated verdict\nCONTEXT:\n - Session: <session-folder>\n - Issue IDs: <rejected-issue-ids>\n - Upstream artifacts: solutions/solution-<issueId>.json (revised), audits/audit-report.json\nEXPECTED: <session>/audits/audit-report.json (updated)\nCONSTRAINTS: Focus on previously rejected dimensions\n---\nInnerLoop: false",
250
- "status": "pending",
251
- "role": "reviewer",
252
- "prefix": "AUDIT",
253
- "deps": ["SOLVE-fix-001"],
254
- "findings": "",
255
- "error": ""
256
- }
257
- ```
258
-
259
- ## Validation
260
-
261
- 1. Verify all tasks created by reading tasks.json
262
- 2. Check dependency chain integrity:
263
- - No circular dependencies
264
- - All deps references exist
265
- - First task(s) have empty deps (EXPLORE tasks)
266
- 3. Log task count and pipeline mode
267
- 4. Verify mode-specific constraints:
268
-
269
- | Mode | Constraint |
270
- |------|-----------|
271
- | quick | Exactly 4 tasks, no AUDIT |
272
- | full | Exactly 5 tasks, includes AUDIT |
273
- | batch | N EXPLORE + N SOLVE + 1 AUDIT + 1 MARSHAL + deferred BUILD |
1
+ # Dispatch
2
+
3
+ Create the issue resolution task chain with correct dependencies and structured task descriptions based on selected pipeline mode.
4
+
5
+ ## Context Loading
6
+
7
+ | Input | Source | Required |
8
+ |-------|--------|----------|
9
+ | Requirement | From coordinator Phase 1 | Yes |
10
+ | Session folder | From coordinator Phase 2 | Yes |
11
+ | Pipeline mode | From session.json mode | Yes |
12
+ | Issue IDs | From session.json issue_ids | Yes |
13
+ | Execution method | From session.json execution_method | Yes |
14
+ | Code review | From session.json code_review | No |
15
+
16
+ 1. Load requirement, pipeline mode, issue IDs, and execution method from session.json
17
+ 2. Determine task chain from pipeline mode
18
+
19
+ ## Task Description Template
20
+
21
+ Every task is built as a JSON entry in the tasks array:
22
+
23
+ ```json
24
+ {
25
+ "id": "<TASK-ID>",
26
+ "title": "<TASK-ID>",
27
+ "description": "PURPOSE: <what this task achieves> | Success: <completion criteria>\nTASK:\n - <step 1>\n - <step 2>\n - <step 3>\nCONTEXT:\n - Session: <session-folder>\n - Issue IDs: <issue-id-list>\n - Upstream artifacts: <artifact-list>\nEXPECTED: <deliverable path> + <quality criteria>\nCONSTRAINTS: <scope limits>\n---\nInnerLoop: false\nexecution_method: <method>\ncode_review: <setting>",
28
+ "status": "pending",
29
+ "role": "<role>",
30
+ "prefix": "<PREFIX>",
31
+ "deps": ["<dependency-list>"],
32
+ "findings": "",
33
+ "error": ""
34
+ }
35
+ ```
36
+
37
+ ## Pipeline Router
38
+
39
+ | Mode | Action |
40
+ |------|--------|
41
+ | quick | Create 4 tasks (EXPLORE -> SOLVE -> MARSHAL -> BUILD) |
42
+ | full | Create 5 tasks (EXPLORE -> SOLVE -> AUDIT -> MARSHAL -> BUILD) |
43
+ | batch | Create N+N+1+1+M tasks (EXPLORE-001..N -> SOLVE-001..N -> AUDIT-001 -> MARSHAL-001 -> BUILD-001..M) |
44
+
45
+ ---
46
+
47
+ ### Quick Pipeline
48
+
49
+ Build tasks array and write to tasks.json:
50
+
51
+ **EXPLORE-001** (explorer):
52
+ ```json
53
+ {
54
+ "id": "EXPLORE-001",
55
+ "title": "EXPLORE-001",
56
+ "description": "PURPOSE: Analyze issue context and map codebase impact | Success: Context report with relevant files and dependencies\nTASK:\n - Load issue details via ccw issue status\n - Explore codebase for relevant files and patterns\n - Assess complexity and impact scope\nCONTEXT:\n - Session: <session-folder>\n - Issue IDs: <issue-id-list>\nEXPECTED: <session>/explorations/context-<issueId>.json with relevant files, dependencies, and impact assessment\nCONSTRAINTS: Exploration and analysis only, no solution design\n---\nInnerLoop: false",
57
+ "status": "pending",
58
+ "role": "explorer",
59
+ "prefix": "EXPLORE",
60
+ "deps": [],
61
+ "findings": "",
62
+ "error": ""
63
+ }
64
+ ```
65
+
66
+ **SOLVE-001** (planner):
67
+ ```json
68
+ {
69
+ "id": "SOLVE-001",
70
+ "title": "SOLVE-001",
71
+ "description": "PURPOSE: Design solution and decompose into implementation tasks | Success: Bound solution with task decomposition\nTASK:\n - Load explorer context report\n - Generate solution plan via CLI\n - Bind solution to issue\nCONTEXT:\n - Session: <session-folder>\n - Issue IDs: <issue-id-list>\n - Upstream artifacts: explorations/context-<issueId>.json\nEXPECTED: <session>/solutions/solution-<issueId>.json with solution plan and task list\nCONSTRAINTS: Solution design only, no code implementation\n---\nInnerLoop: false",
72
+ "status": "pending",
73
+ "role": "planner",
74
+ "prefix": "SOLVE",
75
+ "deps": ["EXPLORE-001"],
76
+ "findings": "",
77
+ "error": ""
78
+ }
79
+ ```
80
+
81
+ **MARSHAL-001** (integrator):
82
+ ```json
83
+ {
84
+ "id": "MARSHAL-001",
85
+ "title": "MARSHAL-001",
86
+ "description": "PURPOSE: Form execution queue with conflict detection and ordering | Success: Execution queue file with resolved conflicts\nTASK:\n - Verify all issues have bound solutions\n - Detect file conflicts between solutions\n - Produce ordered execution queue with DAG-based parallel groups\nCONTEXT:\n - Session: <session-folder>\n - Issue IDs: <issue-id-list>\n - Upstream artifacts: solutions/solution-<issueId>.json\nEXPECTED: .workflow/issues/queue/execution-queue.json with queue, conflicts, parallel groups\nCONSTRAINTS: Queue formation only, no implementation\n---\nInnerLoop: false",
87
+ "status": "pending",
88
+ "role": "integrator",
89
+ "prefix": "MARSHAL",
90
+ "deps": ["SOLVE-001"],
91
+ "findings": "",
92
+ "error": ""
93
+ }
94
+ ```
95
+
96
+ **BUILD-001** (implementer):
97
+ ```json
98
+ {
99
+ "id": "BUILD-001",
100
+ "title": "BUILD-001",
101
+ "description": "PURPOSE: Implement solution plan and verify with tests | Success: Code changes committed, tests pass\nTASK:\n - Load bound solution and explorer context\n - Route to execution backend (Auto/Codex/Gemini)\n - Run tests and verify implementation\n - Commit changes\nCONTEXT:\n - Session: <session-folder>\n - Issue IDs: <issue-id-list>\n - Upstream artifacts: explorations/context-<issueId>.json, solutions/solution-<issueId>.json, queue/execution-queue.json\nEXPECTED: <session>/builds/ with implementation results, tests passing\nCONSTRAINTS: Follow solution plan, no scope creep\n---\nInnerLoop: false\nexecution_method: <execution_method>\ncode_review: <code_review>",
102
+ "status": "pending",
103
+ "role": "implementer",
104
+ "prefix": "BUILD",
105
+ "deps": ["MARSHAL-001"],
106
+ "findings": "",
107
+ "error": ""
108
+ }
109
+ ```
110
+
111
+ ---
112
+
113
+ ### Full Pipeline
114
+
115
+ Creates 5 tasks. EXPLORE-001 and SOLVE-001 same as Quick, then AUDIT gate before MARSHAL and BUILD.
116
+
117
+ **AUDIT-001** (reviewer):
118
+ ```json
119
+ {
120
+ "id": "AUDIT-001",
121
+ "title": "AUDIT-001",
122
+ "description": "PURPOSE: Review solution for technical feasibility, risk, and completeness | Success: Clear verdict (approved/concerns/rejected) with scores\nTASK:\n - Load explorer context and bound solution\n - Score across 3 dimensions: technical feasibility (40%), risk (30%), completeness (30%)\n - Produce verdict: approved (>=80), concerns (60-79), rejected (<60)\nCONTEXT:\n - Session: <session-folder>\n - Issue IDs: <issue-id-list>\n - Upstream artifacts: explorations/context-<issueId>.json, solutions/solution-<issueId>.json\nEXPECTED: <session>/audits/audit-report.json with per-issue scores and overall verdict\nCONSTRAINTS: Review only, do not modify solutions\n---\nInnerLoop: false",
123
+ "status": "pending",
124
+ "role": "reviewer",
125
+ "prefix": "AUDIT",
126
+ "deps": ["SOLVE-001"],
127
+ "findings": "",
128
+ "error": ""
129
+ }
130
+ ```
131
+
132
+ **MARSHAL-001**: Same as Quick, but `deps: ["AUDIT-001"]`.
133
+
134
+ **BUILD-001**: Same as Quick, `deps: ["MARSHAL-001"]`.
135
+
136
+ ---
137
+
138
+ ### Batch Pipeline
139
+
140
+ Creates tasks in parallel batches. Issue count = N, BUILD tasks = M (from queue parallel groups).
141
+
142
+ **EXPLORE-001..N** (explorer, parallel):
143
+
144
+ For each issue in issue_ids (up to 5), create an EXPLORE task with distinct role:
145
+
146
+ | Issue Count | Role Assignment |
147
+ |-------------|-----------------|
148
+ | N = 1 | role: "explorer" |
149
+ | N > 1 | role: "explorer-1", "explorer-2", ..., "explorer-N" (max 5) |
150
+
151
+ ```json
152
+ {
153
+ "id": "EXPLORE-<NNN>",
154
+ "title": "EXPLORE-<NNN>",
155
+ "description": "PURPOSE: Analyze issue <issueId> context and map codebase impact | Success: Context report for <issueId>\nTASK:\n - Load issue details for <issueId>\n - Explore codebase for relevant files\n - Assess complexity and impact scope\nCONTEXT:\n - Session: <session-folder>\n - Issue IDs: <issueId>\nEXPECTED: <session>/explorations/context-<issueId>.json\nCONSTRAINTS: Single issue scope, exploration only\n---\nInnerLoop: false",
156
+ "status": "pending",
157
+ "role": "explorer-<N>",
158
+ "prefix": "EXPLORE",
159
+ "deps": [],
160
+ "findings": "",
161
+ "error": ""
162
+ }
163
+ ```
164
+
165
+ **SOLVE-001..N** (planner, sequential after all EXPLORE):
166
+
167
+ ```json
168
+ {
169
+ "id": "SOLVE-<NNN>",
170
+ "title": "SOLVE-<NNN>",
171
+ "description": "PURPOSE: Design solution for <issueId> | Success: Bound solution with tasks\nTASK:\n - Load explorer context for <issueId>\n - Generate solution plan\n - Bind solution\nCONTEXT:\n - Session: <session-folder>\n - Issue IDs: <issueId>\n - Upstream artifacts: explorations/context-<issueId>.json\nEXPECTED: <session>/solutions/solution-<issueId>.json\nCONSTRAINTS: Solution design only\n---\nInnerLoop: false",
172
+ "status": "pending",
173
+ "role": "planner",
174
+ "prefix": "SOLVE",
175
+ "deps": ["EXPLORE-001", "...", "EXPLORE-<N>"],
176
+ "findings": "",
177
+ "error": ""
178
+ }
179
+ ```
180
+
181
+ **AUDIT-001** (reviewer, batch review):
182
+ ```json
183
+ {
184
+ "id": "AUDIT-001",
185
+ "title": "AUDIT-001",
186
+ "description": "PURPOSE: Batch review all solutions | Success: Verdict for each solution\nTASK:\n - Load all explorer contexts and bound solutions\n - Score each solution across 3 dimensions\n - Produce per-issue verdicts and overall verdict\nCONTEXT:\n - Session: <session-folder>\n - Issue IDs: <all-issue-ids>\n - Upstream artifacts: explorations/*.json, solutions/*.json\nEXPECTED: <session>/audits/audit-report.json with batch results\nCONSTRAINTS: Review only\n---\nInnerLoop: false",
187
+ "status": "pending",
188
+ "role": "reviewer",
189
+ "prefix": "AUDIT",
190
+ "deps": ["SOLVE-001", "...", "SOLVE-<N>"],
191
+ "findings": "",
192
+ "error": ""
193
+ }
194
+ ```
195
+
196
+ **MARSHAL-001** (integrator): `deps: ["AUDIT-001"]`.
197
+
198
+ **BUILD-001..M** (implementer, DAG parallel):
199
+
200
+ > Note: In Batch mode, BUILD task count M is not known at dispatch time (depends on MARSHAL queue output). Defer BUILD task creation to handleCallback when MARSHAL completes. Coordinator creates BUILD tasks dynamically after reading execution-queue.json.
201
+
202
+ When M is known (deferred creation after MARSHAL), assign distinct roles:
203
+
204
+ | Build Count | Role Assignment |
205
+ |-------------|-----------------|
206
+ | M <= 2 | role: "implementer" |
207
+ | M > 2 | role: "implementer-1", ..., "implementer-M" (max 3) |
208
+
209
+ ```json
210
+ {
211
+ "id": "BUILD-<NNN>",
212
+ "title": "BUILD-<NNN>",
213
+ "description": "PURPOSE: Implement solution for <issueId> | Success: Code committed, tests pass\nTASK:\n - Load bound solution and explorer context\n - Execute implementation via <execution_method>\n - Run tests, commit\nCONTEXT:\n - Session: <session-folder>\n - Issue IDs: <issueId>\n - Upstream artifacts: explorations/context-<issueId>.json, solutions/solution-<issueId>.json, queue/execution-queue.json\nEXPECTED: <session>/builds/ with results\nCONSTRAINTS: Follow solution plan\n---\nInnerLoop: false\nexecution_method: <execution_method>\ncode_review: <code_review>",
214
+ "status": "pending",
215
+ "role": "implementer-<M>",
216
+ "prefix": "BUILD",
217
+ "deps": ["MARSHAL-001"],
218
+ "findings": "",
219
+ "error": ""
220
+ }
221
+ ```
222
+
223
+ ---
224
+
225
+ ### Review-Fix Cycle (Full/Batch modes)
226
+
227
+ When AUDIT rejects a solution, coordinator creates fix tasks dynamically in handleCallback -- NOT at dispatch time.
228
+
229
+ **SOLVE-fix-001** (planner, revision) -- added to tasks.json dynamically:
230
+ ```json
231
+ {
232
+ "id": "SOLVE-fix-001",
233
+ "title": "SOLVE-fix-001",
234
+ "description": "PURPOSE: Revise solution addressing reviewer feedback (fix cycle <round>) | Success: Revised solution addressing rejection reasons\nTASK:\n - Read reviewer feedback from audit report\n - Design alternative approach addressing concerns\n - Re-bind revised solution\nCONTEXT:\n - Session: <session-folder>\n - Issue IDs: <rejected-issue-ids>\n - Upstream artifacts: audits/audit-report.json\n - Reviewer feedback: <rejection-reasons>\nEXPECTED: <session>/solutions/solution-<issueId>.json (revised)\nCONSTRAINTS: Address reviewer concerns specifically\n---\nInnerLoop: false",
235
+ "status": "pending",
236
+ "role": "planner",
237
+ "prefix": "SOLVE",
238
+ "deps": ["AUDIT-001"],
239
+ "findings": "",
240
+ "error": ""
241
+ }
242
+ ```
243
+
244
+ **AUDIT-002** (reviewer, re-review) -- added to tasks.json dynamically:
245
+ ```json
246
+ {
247
+ "id": "AUDIT-002",
248
+ "title": "AUDIT-002",
249
+ "description": "PURPOSE: Re-review revised solution (fix cycle <round>) | Success: Verdict on revised solution\nTASK:\n - Load revised solution\n - Re-evaluate previously rejected dimensions\n - Produce updated verdict\nCONTEXT:\n - Session: <session-folder>\n - Issue IDs: <rejected-issue-ids>\n - Upstream artifacts: solutions/solution-<issueId>.json (revised), audits/audit-report.json\nEXPECTED: <session>/audits/audit-report.json (updated)\nCONSTRAINTS: Focus on previously rejected dimensions\n---\nInnerLoop: false",
250
+ "status": "pending",
251
+ "role": "reviewer",
252
+ "prefix": "AUDIT",
253
+ "deps": ["SOLVE-fix-001"],
254
+ "findings": "",
255
+ "error": ""
256
+ }
257
+ ```
258
+
259
+ ## Validation
260
+
261
+ 1. Verify all tasks created by reading tasks.json
262
+ 2. Check dependency chain integrity:
263
+ - No circular dependencies
264
+ - All deps references exist
265
+ - First task(s) have empty deps (EXPLORE tasks)
266
+ 3. Log task count and pipeline mode
267
+ 4. Verify mode-specific constraints:
268
+
269
+ | Mode | Constraint |
270
+ |------|-----------|
271
+ | quick | Exactly 4 tasks, no AUDIT |
272
+ | full | Exactly 5 tasks, includes AUDIT |
273
+ | batch | N EXPLORE + N SOLVE + 1 AUDIT + 1 MARSHAL + deferred BUILD |