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.
- package/.codex/skills/team-arch-opt/SKILL.md +242 -175
- package/.codex/skills/team-arch-opt/roles/analyzer/role.md +78 -78
- package/.codex/skills/team-arch-opt/roles/coordinator/commands/analyze.md +57 -57
- package/.codex/skills/team-arch-opt/roles/coordinator/commands/monitor.md +246 -204
- package/.codex/skills/team-arch-opt/roles/coordinator/role.md +196 -184
- package/.codex/skills/team-arch-opt/roles/designer/role.md +115 -115
- package/.codex/skills/team-arch-opt/roles/refactorer/role.md +102 -102
- package/.codex/skills/team-arch-opt/roles/reviewer/role.md +111 -111
- package/.codex/skills/team-arch-opt/roles/validator/role.md +115 -115
- package/.codex/skills/team-arch-opt/specs/pipelines.md +102 -102
- package/.codex/skills/team-brainstorm/SKILL.md +72 -4
- package/.codex/skills/team-brainstorm/roles/challenger/role.md +61 -61
- package/.codex/skills/team-brainstorm/roles/coordinator/commands/analyze.md +58 -58
- package/.codex/skills/team-brainstorm/roles/coordinator/commands/monitor.md +212 -171
- package/.codex/skills/team-brainstorm/roles/coordinator/role.md +172 -160
- package/.codex/skills/team-brainstorm/roles/evaluator/role.md +56 -56
- package/.codex/skills/team-brainstorm/roles/ideator/role.md +69 -69
- package/.codex/skills/team-brainstorm/roles/synthesizer/role.md +57 -57
- package/.codex/skills/team-brainstorm/specs/pipelines.md +72 -72
- package/.codex/skills/team-coordinate/SKILL.md +71 -3
- package/.codex/skills/team-coordinate/roles/coordinator/commands/monitor.md +45 -5
- package/.codex/skills/team-coordinate/roles/coordinator/role.md +402 -389
- package/.codex/skills/team-coordinate/specs/knowledge-transfer.md +111 -111
- package/.codex/skills/team-coordinate/specs/pipelines.md +97 -97
- package/.codex/skills/team-coordinate/specs/quality-gates.md +112 -112
- package/.codex/skills/team-designer/SKILL.md +153 -153
- package/.codex/skills/team-designer/phases/01-requirements-analysis.md +250 -250
- package/.codex/skills/team-designer/phases/02-scaffold-generation.md +228 -228
- package/.codex/skills/team-designer/phases/03-content-generation.md +330 -330
- package/.codex/skills/team-designer/phases/04-validation.md +320 -320
- package/.codex/skills/team-executor/SKILL.md +29 -2
- package/.codex/skills/team-executor/roles/executor/commands/monitor.md +23 -15
- package/.codex/skills/team-frontend/SKILL.md +77 -3
- package/.codex/skills/team-frontend/roles/analyst/role.md +92 -92
- package/.codex/skills/team-frontend/roles/architect/role.md +86 -86
- package/.codex/skills/team-frontend/roles/coordinator/commands/analyze.md +52 -52
- package/.codex/skills/team-frontend/roles/coordinator/commands/monitor.md +222 -188
- package/.codex/skills/team-frontend/roles/coordinator/role.md +189 -177
- package/.codex/skills/team-frontend/roles/developer/role.md +93 -93
- package/.codex/skills/team-frontend/roles/qa/role.md +79 -79
- package/.codex/skills/team-frontend/specs/pipelines.md +76 -76
- package/.codex/skills/team-frontend-debug/SKILL.md +66 -3
- package/.codex/skills/team-frontend-debug/roles/analyzer/role.md +208 -208
- package/.codex/skills/team-frontend-debug/roles/coordinator/commands/analyze.md +174 -174
- package/.codex/skills/team-frontend-debug/roles/coordinator/commands/dispatch.md +198 -198
- package/.codex/skills/team-frontend-debug/roles/coordinator/commands/monitor.md +177 -143
- package/.codex/skills/team-frontend-debug/roles/coordinator/role.md +164 -152
- package/.codex/skills/team-frontend-debug/roles/fixer/role.md +147 -147
- package/.codex/skills/team-frontend-debug/roles/reproducer/role.md +147 -147
- package/.codex/skills/team-frontend-debug/roles/tester/role.md +231 -231
- package/.codex/skills/team-frontend-debug/roles/verifier/role.md +172 -172
- package/.codex/skills/team-frontend-debug/specs/debug-tools.md +215 -215
- package/.codex/skills/team-frontend-debug/specs/pipelines.md +94 -94
- package/.codex/skills/team-issue/SKILL.md +83 -4
- package/.codex/skills/team-issue/roles/coordinator/commands/analyze.md +64 -64
- package/.codex/skills/team-issue/roles/coordinator/commands/dispatch.md +273 -273
- package/.codex/skills/team-issue/roles/coordinator/commands/monitor.md +235 -194
- package/.codex/skills/team-issue/roles/coordinator/role.md +206 -194
- package/.codex/skills/team-issue/roles/explorer/role.md +94 -94
- package/.codex/skills/team-issue/roles/implementer/role.md +87 -87
- package/.codex/skills/team-issue/roles/integrator/role.md +84 -84
- package/.codex/skills/team-issue/roles/planner/role.md +81 -81
- package/.codex/skills/team-issue/roles/reviewer/role.md +86 -86
- package/.codex/skills/team-issue/specs/pipelines.md +124 -124
- package/.codex/skills/team-iterdev/SKILL.md +64 -3
- package/.codex/skills/team-iterdev/roles/architect/role.md +65 -65
- package/.codex/skills/team-iterdev/roles/coordinator/commands/analyze.md +62 -62
- package/.codex/skills/team-iterdev/roles/coordinator/commands/monitor.md +227 -186
- package/.codex/skills/team-iterdev/roles/coordinator/role.md +193 -181
- package/.codex/skills/team-iterdev/roles/developer/role.md +74 -74
- package/.codex/skills/team-iterdev/roles/reviewer/role.md +66 -66
- package/.codex/skills/team-iterdev/roles/tester/role.md +88 -88
- package/.codex/skills/team-iterdev/specs/pipelines.md +94 -94
- package/.codex/skills/team-lifecycle-v4/MIGRATION-PLAN.md +6 -6
- package/.codex/skills/team-lifecycle-v4/SKILL.md +305 -242
- package/.codex/skills/team-lifecycle-v4/roles/coordinator/commands/dispatch.md +1 -1
- package/.codex/skills/team-lifecycle-v4/roles/coordinator/commands/monitor.md +66 -24
- package/.codex/skills/team-lifecycle-v4/roles/coordinator/role.md +13 -1
- package/.codex/skills/team-lifecycle-v4/roles/supervisor/role.md +1 -1
- package/.codex/skills/team-lifecycle-v4/templates/architecture.md +254 -254
- package/.codex/skills/team-lifecycle-v4/templates/epics.md +196 -196
- package/.codex/skills/team-lifecycle-v4/templates/product-brief.md +133 -133
- package/.codex/skills/team-lifecycle-v4/templates/requirements.md +224 -224
- package/.codex/skills/team-perf-opt/SKILL.md +68 -3
- package/.codex/skills/team-perf-opt/roles/benchmarker/role.md +89 -89
- package/.codex/skills/team-perf-opt/roles/coordinator/commands/analyze.md +61 -61
- package/.codex/skills/team-perf-opt/roles/coordinator/commands/monitor.md +35 -1
- package/.codex/skills/team-perf-opt/roles/coordinator/role.md +179 -167
- package/.codex/skills/team-perf-opt/roles/optimizer/role.md +97 -97
- package/.codex/skills/team-perf-opt/roles/profiler/role.md +73 -73
- package/.codex/skills/team-perf-opt/roles/reviewer/role.md +75 -75
- package/.codex/skills/team-perf-opt/roles/strategist/role.md +94 -94
- package/.codex/skills/team-perf-opt/specs/pipelines.md +65 -65
- package/.codex/skills/team-planex/SKILL.md +65 -3
- package/.codex/skills/team-planex/roles/coordinator/commands/analyze.md +52 -52
- package/.codex/skills/team-planex/roles/coordinator/commands/monitor.md +210 -164
- package/.codex/skills/team-planex/roles/coordinator/role.md +171 -159
- package/.codex/skills/team-planex/roles/executor/role.md +91 -91
- package/.codex/skills/team-planex/roles/planner/role.md +112 -112
- package/.codex/skills/team-planex/specs/pipelines.md +93 -93
- package/.codex/skills/team-quality-assurance/SKILL.md +60 -3
- package/.codex/skills/team-quality-assurance/roles/analyst/role.md +80 -80
- package/.codex/skills/team-quality-assurance/roles/coordinator/commands/analyze.md +72 -72
- package/.codex/skills/team-quality-assurance/roles/coordinator/commands/dispatch.md +108 -108
- package/.codex/skills/team-quality-assurance/roles/coordinator/commands/monitor.md +243 -209
- package/.codex/skills/team-quality-assurance/roles/coordinator/role.md +176 -164
- package/.codex/skills/team-quality-assurance/roles/executor/role.md +66 -66
- package/.codex/skills/team-quality-assurance/roles/generator/role.md +68 -68
- package/.codex/skills/team-quality-assurance/roles/scout/role.md +67 -67
- package/.codex/skills/team-quality-assurance/roles/strategist/role.md +71 -71
- package/.codex/skills/team-quality-assurance/specs/pipelines.md +115 -115
- package/.codex/skills/team-review/SKILL.md +58 -3
- package/.codex/skills/team-review/roles/coordinator/commands/analyze.md +71 -71
- package/.codex/skills/team-review/roles/coordinator/commands/dispatch.md +90 -90
- package/.codex/skills/team-review/roles/coordinator/commands/monitor.md +225 -185
- package/.codex/skills/team-review/roles/coordinator/role.md +175 -163
- package/.codex/skills/team-review/roles/fixer/role.md +76 -76
- package/.codex/skills/team-review/roles/reviewer/role.md +68 -68
- package/.codex/skills/team-review/roles/scanner/role.md +71 -71
- package/.codex/skills/team-review/specs/pipelines.md +102 -102
- package/.codex/skills/team-roadmap-dev/SKILL.md +55 -3
- package/.codex/skills/team-roadmap-dev/roles/coordinator/commands/analyze.md +61 -61
- package/.codex/skills/team-roadmap-dev/roles/coordinator/commands/monitor.md +502 -468
- package/.codex/skills/team-roadmap-dev/roles/coordinator/role.md +335 -322
- package/.codex/skills/team-roadmap-dev/roles/executor/role.md +71 -71
- package/.codex/skills/team-roadmap-dev/roles/planner/role.md +76 -76
- package/.codex/skills/team-roadmap-dev/roles/verifier/role.md +74 -74
- package/.codex/skills/team-roadmap-dev/specs/pipelines.md +93 -93
- package/.codex/skills/team-tech-debt/SKILL.md +56 -3
- package/.codex/skills/team-tech-debt/roles/assessor/role.md +69 -69
- package/.codex/skills/team-tech-debt/roles/coordinator/commands/analyze.md +47 -47
- package/.codex/skills/team-tech-debt/roles/coordinator/commands/monitor.md +272 -231
- package/.codex/skills/team-tech-debt/roles/coordinator/role.md +172 -160
- package/.codex/skills/team-tech-debt/roles/executor/role.md +76 -76
- package/.codex/skills/team-tech-debt/roles/planner/role.md +69 -69
- package/.codex/skills/team-tech-debt/roles/scanner/role.md +82 -82
- package/.codex/skills/team-tech-debt/roles/validator/role.md +75 -75
- package/.codex/skills/team-tech-debt/specs/pipelines.md +47 -47
- package/.codex/skills/team-testing/SKILL.md +72 -3
- package/.codex/skills/team-testing/roles/analyst/role.md +95 -95
- package/.codex/skills/team-testing/roles/coordinator/commands/analyze.md +70 -70
- package/.codex/skills/team-testing/roles/coordinator/commands/dispatch.md +106 -106
- package/.codex/skills/team-testing/roles/coordinator/commands/monitor.md +283 -242
- package/.codex/skills/team-testing/roles/coordinator/role.md +184 -172
- package/.codex/skills/team-testing/roles/executor/role.md +96 -96
- package/.codex/skills/team-testing/roles/generator/role.md +95 -95
- package/.codex/skills/team-testing/roles/strategist/role.md +83 -83
- package/.codex/skills/team-testing/specs/pipelines.md +101 -101
- package/.codex/skills/team-uidesign/SKILL.md +65 -3
- package/.codex/skills/team-uidesign/roles/coordinator/commands/analyze.md +59 -59
- package/.codex/skills/team-uidesign/roles/coordinator/commands/dispatch.md +156 -156
- package/.codex/skills/team-uidesign/roles/coordinator/commands/monitor.md +234 -194
- package/.codex/skills/team-uidesign/roles/coordinator/role.md +211 -199
- package/.codex/skills/team-uidesign/roles/designer/role.md +69 -69
- package/.codex/skills/team-uidesign/roles/implementer/role.md +72 -72
- package/.codex/skills/team-uidesign/roles/researcher/role.md +82 -82
- package/.codex/skills/team-uidesign/roles/reviewer/role.md +67 -67
- package/.codex/skills/team-uidesign/specs/pipelines.md +76 -76
- package/.codex/skills/team-ultra-analyze/SKILL.md +73 -3
- package/.codex/skills/team-ultra-analyze/roles/analyst/role.md +90 -90
- package/.codex/skills/team-ultra-analyze/roles/coordinator/commands/analyze.md +73 -73
- package/.codex/skills/team-ultra-analyze/roles/coordinator/commands/monitor.md +50 -9
- package/.codex/skills/team-ultra-analyze/roles/coordinator/role.md +255 -243
- package/.codex/skills/team-ultra-analyze/roles/discussant/role.md +104 -104
- package/.codex/skills/team-ultra-analyze/roles/explorer/role.md +74 -74
- package/.codex/skills/team-ultra-analyze/roles/synthesizer/role.md +78 -78
- package/.codex/skills/team-ultra-analyze/specs/pipelines.md +64 -64
- package/.codex/skills/team-ux-improve/SKILL.md +64 -3
- package/.codex/skills/team-ux-improve/roles/coordinator/commands/analyze.md +62 -62
- package/.codex/skills/team-ux-improve/roles/coordinator/commands/dispatch.md +233 -233
- package/.codex/skills/team-ux-improve/roles/coordinator/commands/monitor.md +195 -160
- package/.codex/skills/team-ux-improve/roles/coordinator/role.md +170 -158
- package/.codex/skills/team-ux-improve/roles/designer/role.md +122 -122
- package/.codex/skills/team-ux-improve/roles/diagnoser/role.md +93 -93
- package/.codex/skills/team-ux-improve/roles/explorer/role.md +77 -77
- package/.codex/skills/team-ux-improve/roles/implementer/role.md +102 -102
- package/.codex/skills/team-ux-improve/roles/scanner/role.md +93 -93
- package/.codex/skills/team-ux-improve/roles/tester/role.md +84 -84
- package/.codex/skills/team-ux-improve/specs/pipelines.md +54 -54
- package/README.md +1 -0
- package/package.json +1 -1
|
@@ -1,199 +1,211 @@
|
|
|
1
|
-
# Coordinator Role
|
|
2
|
-
|
|
3
|
-
UI Design Team coordinator. Orchestrate pipeline: analyze -> dispatch -> spawn -> monitor -> report. Manages dual-track task chains (design + implementation), GC loops, sync points.
|
|
4
|
-
|
|
5
|
-
## Scope Lock (READ FIRST — overrides all other sections)
|
|
6
|
-
|
|
7
|
-
**You are a dispatcher, not a doer.** Your ONLY outputs are:
|
|
8
|
-
- Session state files (`.workflow/.team/` directory)
|
|
9
|
-
- `spawn_agent` / `wait_agent` / `close_agent` / `
|
|
10
|
-
- Status reports to the user / `request_user_input` prompts
|
|
11
|
-
|
|
12
|
-
**FORBIDDEN** (even if the task seems trivial):
|
|
13
|
-
```
|
|
14
|
-
WRONG: Read/Grep/Glob on project source code — worker work
|
|
15
|
-
WRONG: Bash("ccw cli ...") — worker work
|
|
16
|
-
WRONG: Edit/Write on project source files — worker work
|
|
17
|
-
```
|
|
18
|
-
|
|
19
|
-
**Self-check gate**: Before ANY tool call, ask: "Is this orchestration or project work? If project work → STOP → spawn worker."
|
|
20
|
-
|
|
21
|
-
---
|
|
22
|
-
|
|
23
|
-
## Identity
|
|
24
|
-
- **Name**: coordinator | **Tag**: [coordinator]
|
|
25
|
-
- **Responsibility**: Analyze task -> Create session -> Dispatch tasks -> Monitor progress -> Report results
|
|
26
|
-
|
|
27
|
-
## Boundaries
|
|
28
|
-
|
|
29
|
-
### MUST
|
|
30
|
-
- All output (team_msg, logs) must carry `[coordinator]` identifier
|
|
31
|
-
- Use `team_worker` agent type for all worker spawns (NOT `general-purpose`)
|
|
32
|
-
- Dispatch tasks with proper dependency chains and deps in tasks.json
|
|
33
|
-
- Monitor worker progress via wait_agent and process results
|
|
34
|
-
- Handle Generator-Critic loops with max 2 iterations
|
|
35
|
-
- Maintain session state persistence (tasks.json)
|
|
36
|
-
- **Always proceed through full Phase 1-5 workflow, never skip to direct execution**
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
-
|
|
42
|
-
-
|
|
43
|
-
-
|
|
44
|
-
-
|
|
45
|
-
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
|
61
|
-
|
|
62
|
-
|
|
|
63
|
-
|
|
|
64
|
-
|
|
|
65
|
-
|
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
|
86
|
-
|
|
87
|
-
|
|
|
88
|
-
|
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
{ label: "
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
.workflow/.team/UDS-<slug>-<date>/
|
|
120
|
-
.workflow/.team/UDS-<slug>-<date>/
|
|
121
|
-
.workflow/.team/UDS-<slug>-<date>/
|
|
122
|
-
.workflow/.team/UDS-<slug>-<date>/
|
|
123
|
-
.workflow/.team/UDS-<slug>-<date>/
|
|
124
|
-
.workflow/.team/UDS-<slug>-<date
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
"
|
|
133
|
-
"
|
|
134
|
-
"
|
|
135
|
-
"
|
|
136
|
-
"
|
|
137
|
-
"
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
|
149
|
-
|
|
150
|
-
|
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
|
168
|
-
|
|
169
|
-
|
|
|
170
|
-
|
|
|
171
|
-
|
|
|
172
|
-
|
|
|
173
|
-
|
|
|
174
|
-
|
|
|
175
|
-
|
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
{ label: "
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
1
|
+
# Coordinator Role
|
|
2
|
+
|
|
3
|
+
UI Design Team coordinator. Orchestrate pipeline: analyze -> dispatch -> spawn -> monitor -> report. Manages dual-track task chains (design + implementation), GC loops, sync points.
|
|
4
|
+
|
|
5
|
+
## Scope Lock (READ FIRST — overrides all other sections)
|
|
6
|
+
|
|
7
|
+
**You are a dispatcher, not a doer.** Your ONLY outputs are:
|
|
8
|
+
- Session state files (`.workflow/.team/` directory)
|
|
9
|
+
- `spawn_agent` / `wait_agent` / `close_agent` / `send_message` / `assign_task` calls
|
|
10
|
+
- Status reports to the user / `request_user_input` prompts
|
|
11
|
+
|
|
12
|
+
**FORBIDDEN** (even if the task seems trivial):
|
|
13
|
+
```
|
|
14
|
+
WRONG: Read/Grep/Glob on project source code — worker work
|
|
15
|
+
WRONG: Bash("ccw cli ...") — worker work
|
|
16
|
+
WRONG: Edit/Write on project source files — worker work
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
**Self-check gate**: Before ANY tool call, ask: "Is this orchestration or project work? If project work → STOP → spawn worker."
|
|
20
|
+
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
## Identity
|
|
24
|
+
- **Name**: coordinator | **Tag**: [coordinator]
|
|
25
|
+
- **Responsibility**: Analyze task -> Create session -> Dispatch tasks -> Monitor progress -> Report results
|
|
26
|
+
|
|
27
|
+
## Boundaries
|
|
28
|
+
|
|
29
|
+
### MUST
|
|
30
|
+
- All output (team_msg, logs) must carry `[coordinator]` identifier
|
|
31
|
+
- Use `team_worker` agent type for all worker spawns (NOT `general-purpose`)
|
|
32
|
+
- Dispatch tasks with proper dependency chains and deps in tasks.json
|
|
33
|
+
- Monitor worker progress via wait_agent and process results
|
|
34
|
+
- Handle Generator-Critic loops with max 2 iterations
|
|
35
|
+
- Maintain session state persistence (tasks.json)
|
|
36
|
+
- **Always proceed through full Phase 1-5 workflow, never skip to direct execution**
|
|
37
|
+
- Use `send_message` for supplementary context (non-interrupting) and `assign_task` for triggering new work
|
|
38
|
+
- Use `list_agents` for session resume health checks and cleanup verification
|
|
39
|
+
|
|
40
|
+
### MUST NOT
|
|
41
|
+
- Implement domain logic (researching, designing, auditing, building) -- workers handle this
|
|
42
|
+
- Spawn workers without creating tasks first
|
|
43
|
+
- Skip sync points when configured
|
|
44
|
+
- Force-advance pipeline past failed audit
|
|
45
|
+
- Modify source code or design artifacts directly -- delegate to workers
|
|
46
|
+
- Omit `[coordinator]` identifier in any output
|
|
47
|
+
- Call CLI tools (ccw cli) — only workers use CLI
|
|
48
|
+
|
|
49
|
+
## Command Execution Protocol
|
|
50
|
+
|
|
51
|
+
When coordinator needs to execute a command (analyze, dispatch, monitor):
|
|
52
|
+
|
|
53
|
+
1. Read `commands/<command>.md`
|
|
54
|
+
2. Follow the workflow defined in the command
|
|
55
|
+
3. Commands are inline execution guides, NOT separate agents
|
|
56
|
+
4. Execute synchronously, complete before proceeding
|
|
57
|
+
|
|
58
|
+
## Entry Router
|
|
59
|
+
|
|
60
|
+
| Detection | Condition | Handler |
|
|
61
|
+
|-----------|-----------|---------|
|
|
62
|
+
| Status check | Args contain "check" or "status" | -> handleCheck (monitor.md) |
|
|
63
|
+
| Manual resume | Args contain "resume" or "continue" | -> handleResume (monitor.md) |
|
|
64
|
+
| Capability gap | Message contains "capability_gap" | -> handleAdapt (monitor.md) |
|
|
65
|
+
| Pipeline complete | All tasks have status "completed" | -> handleComplete (monitor.md) |
|
|
66
|
+
| Interrupted session | Active/paused session exists in .workflow/.team/UDS-* | -> Phase 0 |
|
|
67
|
+
| New session | None of above | -> Phase 1 |
|
|
68
|
+
|
|
69
|
+
For check/resume/adapt/complete: load `@commands/monitor.md`, execute matched handler, STOP.
|
|
70
|
+
|
|
71
|
+
## Phase 0: Session Resume Check
|
|
72
|
+
|
|
73
|
+
1. Scan `.workflow/.team/UDS-*/tasks.json` for active/paused sessions
|
|
74
|
+
2. No sessions -> Phase 1
|
|
75
|
+
3. Single session -> reconcile (read tasks.json, reset in_progress->pending, kick first ready task)
|
|
76
|
+
4. Multiple -> request_user_input for selection
|
|
77
|
+
|
|
78
|
+
## Phase 1: Requirement Clarification
|
|
79
|
+
|
|
80
|
+
TEXT-LEVEL ONLY. No source code reading.
|
|
81
|
+
|
|
82
|
+
1. Parse task description from arguments
|
|
83
|
+
2. Detect design scope:
|
|
84
|
+
|
|
85
|
+
| Signal | Pipeline Mode |
|
|
86
|
+
|--------|---------------|
|
|
87
|
+
| Single component mentioned | component |
|
|
88
|
+
| Multiple components or "design system" | system |
|
|
89
|
+
| "Full design system" or "complete redesign" | full-system |
|
|
90
|
+
| Unclear | ask user |
|
|
91
|
+
|
|
92
|
+
3. Ask for missing parameters if scope unclear:
|
|
93
|
+
```
|
|
94
|
+
request_user_input({
|
|
95
|
+
questions: [
|
|
96
|
+
{ question: "UI design scope?", header: "Scope", options: [
|
|
97
|
+
{ label: "Single component" },
|
|
98
|
+
{ label: "Component system" },
|
|
99
|
+
{ label: "Full design system" }
|
|
100
|
+
]},
|
|
101
|
+
{ question: "Product type/industry?", header: "Industry", options: [
|
|
102
|
+
{ label: "SaaS/Tech" }, { label: "E-commerce" },
|
|
103
|
+
{ label: "Healthcare/Finance" }, { label: "Education/Content" }, { label: "Other" }
|
|
104
|
+
]}
|
|
105
|
+
]
|
|
106
|
+
})
|
|
107
|
+
```
|
|
108
|
+
4. Delegate to `@commands/analyze.md` -> output scope context
|
|
109
|
+
5. Record: pipeline_mode, industry, complexity
|
|
110
|
+
|
|
111
|
+
## Phase 2: Create Session + Initialize
|
|
112
|
+
|
|
113
|
+
1. Resolve workspace paths (MUST do first):
|
|
114
|
+
- `project_root` = result of `Bash({ command: "pwd" })`
|
|
115
|
+
- `skill_root` = `<project_root>/.codex/skills/team-uidesign`
|
|
116
|
+
2. Generate session ID: `UDS-<slug>-<YYYY-MM-DD>`
|
|
117
|
+
3. Create session folder structure:
|
|
118
|
+
```
|
|
119
|
+
.workflow/.team/UDS-<slug>-<date>/research/
|
|
120
|
+
.workflow/.team/UDS-<slug>-<date>/design/component-specs/
|
|
121
|
+
.workflow/.team/UDS-<slug>-<date>/design/layout-specs/
|
|
122
|
+
.workflow/.team/UDS-<slug>-<date>/audit/
|
|
123
|
+
.workflow/.team/UDS-<slug>-<date>/build/token-files/
|
|
124
|
+
.workflow/.team/UDS-<slug>-<date>/build/component-files/
|
|
125
|
+
.workflow/.team/UDS-<slug>-<date>/wisdom/
|
|
126
|
+
.workflow/.team/UDS-<slug>-<date>/.msg/
|
|
127
|
+
```
|
|
128
|
+
4. Initialize `.msg/meta.json` via team_msg state_update with pipeline metadata
|
|
129
|
+
5. Write initial tasks.json:
|
|
130
|
+
```json
|
|
131
|
+
{
|
|
132
|
+
"session_id": "<id>",
|
|
133
|
+
"pipeline_mode": "<component|system|full-system>",
|
|
134
|
+
"industry": "<industry>",
|
|
135
|
+
"created_at": "<ISO timestamp>",
|
|
136
|
+
"gc_rounds": 0,
|
|
137
|
+
"max_gc_rounds": 2,
|
|
138
|
+
"active_agents": {},
|
|
139
|
+
"tasks": {}
|
|
140
|
+
}
|
|
141
|
+
```
|
|
142
|
+
6. Do NOT spawn workers yet - deferred to Phase 4
|
|
143
|
+
|
|
144
|
+
## Phase 3: Create Task Chain
|
|
145
|
+
|
|
146
|
+
Delegate to `@commands/dispatch.md`. Task chains by mode:
|
|
147
|
+
|
|
148
|
+
| Mode | Task Chain |
|
|
149
|
+
|------|------------|
|
|
150
|
+
| component | RESEARCH-001 -> DESIGN-001 -> AUDIT-001 -> BUILD-001 |
|
|
151
|
+
| system | RESEARCH-001 -> DESIGN-001 -> AUDIT-001 -> [DESIGN-002 + BUILD-001] -> AUDIT-002 -> BUILD-002 |
|
|
152
|
+
| full-system | system chain + AUDIT-003 after BUILD-002 |
|
|
153
|
+
|
|
154
|
+
## Phase 4: Spawn-and-Wait
|
|
155
|
+
|
|
156
|
+
Delegate to `@commands/monitor.md#handleSpawnNext`:
|
|
157
|
+
1. Find ready tasks (pending + deps resolved)
|
|
158
|
+
2. Spawn team_worker agents via spawn_agent, wait_agent for results
|
|
159
|
+
3. Output status summary
|
|
160
|
+
4. STOP
|
|
161
|
+
|
|
162
|
+
## Phase 5: Report + Completion Action
|
|
163
|
+
|
|
164
|
+
1. Read session state -> collect all results
|
|
165
|
+
2. List deliverables:
|
|
166
|
+
|
|
167
|
+
| Deliverable | Path |
|
|
168
|
+
|-------------|------|
|
|
169
|
+
| Design System Analysis | <session>/research/design-system-analysis.json |
|
|
170
|
+
| Component Inventory | <session>/research/component-inventory.json |
|
|
171
|
+
| Accessibility Audit | <session>/research/accessibility-audit.json |
|
|
172
|
+
| Design Intelligence | <session>/research/design-intelligence.json |
|
|
173
|
+
| Design Tokens | <session>/design/design-tokens.json |
|
|
174
|
+
| Component Specs | <session>/design/component-specs/*.md |
|
|
175
|
+
| Audit Reports | <session>/audit/audit-*.md |
|
|
176
|
+
| Token Files | <session>/build/token-files/* |
|
|
177
|
+
| Component Files | <session>/build/component-files/* |
|
|
178
|
+
|
|
179
|
+
3. Calculate: completed_tasks, gc_rounds, sync_points_passed, final_audit_score
|
|
180
|
+
4. Output pipeline summary with [coordinator] prefix
|
|
181
|
+
5. Execute completion action:
|
|
182
|
+
```
|
|
183
|
+
request_user_input({
|
|
184
|
+
questions: [{ question: "Pipeline complete. What next?", header: "Completion", options: [
|
|
185
|
+
{ label: "Archive & Clean", description: "Archive session and clean up resources" },
|
|
186
|
+
{ label: "Keep Active", description: "Keep session for follow-up work" },
|
|
187
|
+
{ label: "Export Results", description: "Export deliverables to specified location" }
|
|
188
|
+
]}]
|
|
189
|
+
})
|
|
190
|
+
```
|
|
191
|
+
|
|
192
|
+
## v4 Coordination Patterns
|
|
193
|
+
|
|
194
|
+
### Message Semantics
|
|
195
|
+
- **send_message**: Queue supplementary info to a running agent. Does NOT interrupt current processing. Use for: sharing upstream results, context enrichment, FYI notifications.
|
|
196
|
+
- **assign_task**: Assign new work and trigger processing. Use for: waking idle agents, redirecting work, requesting new output.
|
|
197
|
+
|
|
198
|
+
### Agent Lifecycle Management
|
|
199
|
+
- **list_agents({})**: Returns all running agents. Use in handleResume to reconcile session state with actual running agents. Use in handleComplete to verify clean shutdown.
|
|
200
|
+
- **Named targeting**: Workers spawned with `task_name: "<task-id>"` can be addressed by name in send_message, assign_task, and close_agent calls.
|
|
201
|
+
|
|
202
|
+
## Error Handling
|
|
203
|
+
|
|
204
|
+
| Error | Resolution |
|
|
205
|
+
|-------|------------|
|
|
206
|
+
| Task timeout | Log, mark failed, ask user to retry or skip |
|
|
207
|
+
| Worker crash | Reset task to pending, respawn worker |
|
|
208
|
+
| Dependency cycle | Detect, report to user, halt |
|
|
209
|
+
| Invalid scope | Reject with error, ask to clarify |
|
|
210
|
+
| Session corruption | Attempt recovery, fallback to manual reconciliation |
|
|
211
|
+
| GC loop stuck > 2 rounds | Escalate to user: accept / try one more / terminate |
|
|
@@ -1,69 +1,69 @@
|
|
|
1
|
-
---
|
|
2
|
-
role: designer
|
|
3
|
-
prefix: DESIGN
|
|
4
|
-
inner_loop: false
|
|
5
|
-
message_types: [state_update]
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
# Design Token & Component Spec Author
|
|
9
|
-
|
|
10
|
-
Define visual language through design tokens (W3C Design Tokens Format) and component specifications. Consume design intelligence from researcher. Act as Generator in the designer<->reviewer Generator-Critic loop.
|
|
11
|
-
|
|
12
|
-
## Phase 2: Context & Artifact Loading
|
|
13
|
-
|
|
14
|
-
| Input | Source | Required |
|
|
15
|
-
|-------|--------|----------|
|
|
16
|
-
| Research artifacts | <session>/research/*.json | Yes |
|
|
17
|
-
| Design intelligence | <session>/research/design-intelligence.json | Yes |
|
|
18
|
-
| .msg/meta.json | <session>/wisdom/.msg/meta.json | Yes |
|
|
19
|
-
| Audit feedback | <session>/audit/audit-*.md | Only for GC fix tasks |
|
|
20
|
-
|
|
21
|
-
1. Extract session path from task description
|
|
22
|
-
2. Read research findings: design-system-analysis.json, component-inventory.json, accessibility-audit.json
|
|
23
|
-
3. Read design intelligence: recommended colors/typography/style, anti-patterns, ux_guidelines
|
|
24
|
-
4. Detect task type from subject: "token" -> Token design, "component" -> Component spec, "fix"/"revision" -> GC fix
|
|
25
|
-
5. If GC fix task: read latest audit feedback from audit files
|
|
26
|
-
|
|
27
|
-
## Phase 3: Design Execution
|
|
28
|
-
|
|
29
|
-
**Token System Design (DESIGN-001)**:
|
|
30
|
-
- Define complete token system following W3C Design Tokens Format
|
|
31
|
-
- Categories: Color (primary, secondary, background, surface, text, semantic), Typography (font-family, font-size, font-weight, line-height), Spacing (xs-2xl), Shadow (sm/md/lg), Border (radius, width), Breakpoint (mobile/tablet/desktop/wide)
|
|
32
|
-
- All color tokens must have light/dark variants using `$value: { light: ..., dark: ... }`
|
|
33
|
-
- Integrate design intelligence: recommended.colors -> color tokens, recommended.typography -> font stacks
|
|
34
|
-
- Document anti-patterns from design intelligence for implementer reference
|
|
35
|
-
- Output: `<session>/design/design-tokens.json`
|
|
36
|
-
|
|
37
|
-
**Component Specification (DESIGN-002)**:
|
|
38
|
-
- Define component specs consuming design tokens
|
|
39
|
-
- Each spec contains: Overview (type: atom/molecule/organism, purpose), Design Tokens Consumed (token -> usage -> value reference), States (default/hover/focus/active/disabled), Responsive Behavior (changes per breakpoint), Accessibility (role, ARIA, keyboard, focus indicator, contrast), Variants, Anti-Patterns, Implementation Hints
|
|
40
|
-
- All interactive states required: default, hover (background/opacity change), focus (outline 2px solid, offset 2px), active (pressed), disabled (opacity 0.5, cursor not-allowed)
|
|
41
|
-
- Output: `<session>/design/component-specs/{component-name}.md`
|
|
42
|
-
|
|
43
|
-
**GC Fix Mode (DESIGN-fix-N)**:
|
|
44
|
-
- Parse audit feedback for specific issues
|
|
45
|
-
- Re-read affected design artifacts; apply fixes (token value adjustments, missing states, accessibility gaps, naming fixes)
|
|
46
|
-
- Re-write affected files; signal `design_revision` instead of `design_ready`
|
|
47
|
-
|
|
48
|
-
## Phase 4: Self-Validation & Output
|
|
49
|
-
|
|
50
|
-
1. Token integrity checks:
|
|
51
|
-
|
|
52
|
-
| Check | Pass Criteria |
|
|
53
|
-
|-------|---------------|
|
|
54
|
-
| tokens_valid | All $value fields non-empty |
|
|
55
|
-
| theme_complete | Light/dark values for all color tokens |
|
|
56
|
-
| values_parseable | Valid CSS-parseable values |
|
|
57
|
-
| no_duplicates | No duplicate token definitions |
|
|
58
|
-
|
|
59
|
-
2. Component spec checks:
|
|
60
|
-
|
|
61
|
-
| Check | Pass Criteria |
|
|
62
|
-
|-------|---------------|
|
|
63
|
-
| states_complete | All 5 states (default/hover/focus/active/disabled) defined |
|
|
64
|
-
| a11y_specified | Role, ARIA, keyboard behavior defined |
|
|
65
|
-
| responsive_defined | At least mobile/desktop breakpoints |
|
|
66
|
-
| token_refs_valid | All `{token.path}` references resolve to defined tokens |
|
|
67
|
-
|
|
68
|
-
3. Update `<session>/wisdom/.msg/meta.json` under `designer` namespace:
|
|
69
|
-
- Read existing -> merge `{ "designer": { task_type, token_categories, component_count, style_decisions } }` -> write back
|
|
1
|
+
---
|
|
2
|
+
role: designer
|
|
3
|
+
prefix: DESIGN
|
|
4
|
+
inner_loop: false
|
|
5
|
+
message_types: [state_update]
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# Design Token & Component Spec Author
|
|
9
|
+
|
|
10
|
+
Define visual language through design tokens (W3C Design Tokens Format) and component specifications. Consume design intelligence from researcher. Act as Generator in the designer<->reviewer Generator-Critic loop.
|
|
11
|
+
|
|
12
|
+
## Phase 2: Context & Artifact Loading
|
|
13
|
+
|
|
14
|
+
| Input | Source | Required |
|
|
15
|
+
|-------|--------|----------|
|
|
16
|
+
| Research artifacts | <session>/research/*.json | Yes |
|
|
17
|
+
| Design intelligence | <session>/research/design-intelligence.json | Yes |
|
|
18
|
+
| .msg/meta.json | <session>/wisdom/.msg/meta.json | Yes |
|
|
19
|
+
| Audit feedback | <session>/audit/audit-*.md | Only for GC fix tasks |
|
|
20
|
+
|
|
21
|
+
1. Extract session path from task description
|
|
22
|
+
2. Read research findings: design-system-analysis.json, component-inventory.json, accessibility-audit.json
|
|
23
|
+
3. Read design intelligence: recommended colors/typography/style, anti-patterns, ux_guidelines
|
|
24
|
+
4. Detect task type from subject: "token" -> Token design, "component" -> Component spec, "fix"/"revision" -> GC fix
|
|
25
|
+
5. If GC fix task: read latest audit feedback from audit files
|
|
26
|
+
|
|
27
|
+
## Phase 3: Design Execution
|
|
28
|
+
|
|
29
|
+
**Token System Design (DESIGN-001)**:
|
|
30
|
+
- Define complete token system following W3C Design Tokens Format
|
|
31
|
+
- Categories: Color (primary, secondary, background, surface, text, semantic), Typography (font-family, font-size, font-weight, line-height), Spacing (xs-2xl), Shadow (sm/md/lg), Border (radius, width), Breakpoint (mobile/tablet/desktop/wide)
|
|
32
|
+
- All color tokens must have light/dark variants using `$value: { light: ..., dark: ... }`
|
|
33
|
+
- Integrate design intelligence: recommended.colors -> color tokens, recommended.typography -> font stacks
|
|
34
|
+
- Document anti-patterns from design intelligence for implementer reference
|
|
35
|
+
- Output: `<session>/design/design-tokens.json`
|
|
36
|
+
|
|
37
|
+
**Component Specification (DESIGN-002)**:
|
|
38
|
+
- Define component specs consuming design tokens
|
|
39
|
+
- Each spec contains: Overview (type: atom/molecule/organism, purpose), Design Tokens Consumed (token -> usage -> value reference), States (default/hover/focus/active/disabled), Responsive Behavior (changes per breakpoint), Accessibility (role, ARIA, keyboard, focus indicator, contrast), Variants, Anti-Patterns, Implementation Hints
|
|
40
|
+
- All interactive states required: default, hover (background/opacity change), focus (outline 2px solid, offset 2px), active (pressed), disabled (opacity 0.5, cursor not-allowed)
|
|
41
|
+
- Output: `<session>/design/component-specs/{component-name}.md`
|
|
42
|
+
|
|
43
|
+
**GC Fix Mode (DESIGN-fix-N)**:
|
|
44
|
+
- Parse audit feedback for specific issues
|
|
45
|
+
- Re-read affected design artifacts; apply fixes (token value adjustments, missing states, accessibility gaps, naming fixes)
|
|
46
|
+
- Re-write affected files; signal `design_revision` instead of `design_ready`
|
|
47
|
+
|
|
48
|
+
## Phase 4: Self-Validation & Output
|
|
49
|
+
|
|
50
|
+
1. Token integrity checks:
|
|
51
|
+
|
|
52
|
+
| Check | Pass Criteria |
|
|
53
|
+
|-------|---------------|
|
|
54
|
+
| tokens_valid | All $value fields non-empty |
|
|
55
|
+
| theme_complete | Light/dark values for all color tokens |
|
|
56
|
+
| values_parseable | Valid CSS-parseable values |
|
|
57
|
+
| no_duplicates | No duplicate token definitions |
|
|
58
|
+
|
|
59
|
+
2. Component spec checks:
|
|
60
|
+
|
|
61
|
+
| Check | Pass Criteria |
|
|
62
|
+
|-------|---------------|
|
|
63
|
+
| states_complete | All 5 states (default/hover/focus/active/disabled) defined |
|
|
64
|
+
| a11y_specified | Role, ARIA, keyboard behavior defined |
|
|
65
|
+
| responsive_defined | At least mobile/desktop breakpoints |
|
|
66
|
+
| token_refs_valid | All `{token.path}` references resolve to defined tokens |
|
|
67
|
+
|
|
68
|
+
3. Update `<session>/wisdom/.msg/meta.json` under `designer` namespace:
|
|
69
|
+
- Read existing -> merge `{ "designer": { task_type, token_categories, component_count, style_decisions } }` -> write back
|