claude-code-workflow 7.2.23 → 7.2.25

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 (212) hide show
  1. package/.ccw/workflows/cli-tools-usage.md +123 -521
  2. package/.claude/skills/brainstorm/SKILL.md +408 -408
  3. package/.claude/skills/review-cycle/SKILL.md +132 -132
  4. package/.claude/skills/spec-generator/SKILL.md +1 -1
  5. package/.claude/skills/team-designer/phases/02-scaffold-generation.md +1 -1
  6. package/.claude/skills/team-lifecycle-v4/SKILL.md +1 -1
  7. package/.claude/skills/team-review/SKILL.md +1 -1
  8. package/.claude/skills/team-ultra-analyze/SKILL.md +1 -1
  9. package/.claude/skills/workflow-multi-cli-plan/SKILL.md +1 -1
  10. package/.claude/skills/workflow-plan/SKILL.md +1 -1
  11. package/.claude/skills/workflow-test-fix/SKILL.md +1 -1
  12. package/.codex/skills/analyze-with-file/SKILL.md +966 -966
  13. package/.codex/skills/issue-discover/SKILL.md +361 -361
  14. package/.codex/skills/review-cycle/SKILL.md +1 -1
  15. package/.codex/skills/roadmap-with-file/SKILL.md +901 -901
  16. package/.codex/skills/spec-generator/SKILL.md +425 -425
  17. package/.codex/skills/spec-setup/SKILL.md +669 -669
  18. package/.codex/skills/team-arch-opt/SKILL.md +242 -175
  19. package/.codex/skills/team-arch-opt/roles/analyzer/role.md +78 -78
  20. package/.codex/skills/team-arch-opt/roles/coordinator/commands/analyze.md +57 -57
  21. package/.codex/skills/team-arch-opt/roles/coordinator/commands/monitor.md +246 -204
  22. package/.codex/skills/team-arch-opt/roles/coordinator/role.md +196 -184
  23. package/.codex/skills/team-arch-opt/roles/designer/role.md +115 -115
  24. package/.codex/skills/team-arch-opt/roles/refactorer/role.md +102 -102
  25. package/.codex/skills/team-arch-opt/roles/reviewer/role.md +111 -111
  26. package/.codex/skills/team-arch-opt/roles/validator/role.md +115 -115
  27. package/.codex/skills/team-arch-opt/specs/pipelines.md +102 -102
  28. package/.codex/skills/team-brainstorm/SKILL.md +72 -4
  29. package/.codex/skills/team-brainstorm/roles/challenger/role.md +61 -61
  30. package/.codex/skills/team-brainstorm/roles/coordinator/commands/analyze.md +58 -58
  31. package/.codex/skills/team-brainstorm/roles/coordinator/commands/monitor.md +212 -171
  32. package/.codex/skills/team-brainstorm/roles/coordinator/role.md +172 -160
  33. package/.codex/skills/team-brainstorm/roles/evaluator/role.md +56 -56
  34. package/.codex/skills/team-brainstorm/roles/ideator/role.md +69 -69
  35. package/.codex/skills/team-brainstorm/roles/synthesizer/role.md +57 -57
  36. package/.codex/skills/team-brainstorm/specs/pipelines.md +72 -72
  37. package/.codex/skills/team-coordinate/SKILL.md +71 -3
  38. package/.codex/skills/team-coordinate/roles/coordinator/commands/monitor.md +45 -5
  39. package/.codex/skills/team-coordinate/roles/coordinator/role.md +402 -389
  40. package/.codex/skills/team-coordinate/specs/knowledge-transfer.md +111 -111
  41. package/.codex/skills/team-coordinate/specs/pipelines.md +97 -97
  42. package/.codex/skills/team-coordinate/specs/quality-gates.md +112 -112
  43. package/.codex/skills/team-designer/SKILL.md +153 -153
  44. package/.codex/skills/team-designer/phases/01-requirements-analysis.md +250 -250
  45. package/.codex/skills/team-designer/phases/02-scaffold-generation.md +228 -228
  46. package/.codex/skills/team-designer/phases/03-content-generation.md +330 -330
  47. package/.codex/skills/team-designer/phases/04-validation.md +320 -320
  48. package/.codex/skills/team-executor/SKILL.md +29 -2
  49. package/.codex/skills/team-executor/roles/executor/commands/monitor.md +23 -15
  50. package/.codex/skills/team-frontend/SKILL.md +77 -3
  51. package/.codex/skills/team-frontend/roles/analyst/role.md +92 -92
  52. package/.codex/skills/team-frontend/roles/architect/role.md +86 -86
  53. package/.codex/skills/team-frontend/roles/coordinator/commands/analyze.md +52 -52
  54. package/.codex/skills/team-frontend/roles/coordinator/commands/monitor.md +222 -188
  55. package/.codex/skills/team-frontend/roles/coordinator/role.md +189 -177
  56. package/.codex/skills/team-frontend/roles/developer/role.md +93 -93
  57. package/.codex/skills/team-frontend/roles/qa/role.md +79 -79
  58. package/.codex/skills/team-frontend/specs/pipelines.md +76 -76
  59. package/.codex/skills/team-frontend-debug/SKILL.md +66 -3
  60. package/.codex/skills/team-frontend-debug/roles/analyzer/role.md +208 -208
  61. package/.codex/skills/team-frontend-debug/roles/coordinator/commands/analyze.md +174 -174
  62. package/.codex/skills/team-frontend-debug/roles/coordinator/commands/dispatch.md +198 -198
  63. package/.codex/skills/team-frontend-debug/roles/coordinator/commands/monitor.md +177 -143
  64. package/.codex/skills/team-frontend-debug/roles/coordinator/role.md +164 -152
  65. package/.codex/skills/team-frontend-debug/roles/fixer/role.md +147 -147
  66. package/.codex/skills/team-frontend-debug/roles/reproducer/role.md +147 -147
  67. package/.codex/skills/team-frontend-debug/roles/tester/role.md +231 -231
  68. package/.codex/skills/team-frontend-debug/roles/verifier/role.md +172 -172
  69. package/.codex/skills/team-frontend-debug/specs/debug-tools.md +215 -215
  70. package/.codex/skills/team-frontend-debug/specs/pipelines.md +94 -94
  71. package/.codex/skills/team-issue/SKILL.md +83 -4
  72. package/.codex/skills/team-issue/roles/coordinator/commands/analyze.md +64 -64
  73. package/.codex/skills/team-issue/roles/coordinator/commands/dispatch.md +273 -273
  74. package/.codex/skills/team-issue/roles/coordinator/commands/monitor.md +235 -194
  75. package/.codex/skills/team-issue/roles/coordinator/role.md +206 -194
  76. package/.codex/skills/team-issue/roles/explorer/role.md +94 -94
  77. package/.codex/skills/team-issue/roles/implementer/role.md +87 -87
  78. package/.codex/skills/team-issue/roles/integrator/role.md +84 -84
  79. package/.codex/skills/team-issue/roles/planner/role.md +81 -81
  80. package/.codex/skills/team-issue/roles/reviewer/role.md +86 -86
  81. package/.codex/skills/team-issue/specs/pipelines.md +124 -124
  82. package/.codex/skills/team-lifecycle-v4/MIGRATION-PLAN.md +6 -6
  83. package/.codex/skills/team-lifecycle-v4/SKILL.md +305 -242
  84. package/.codex/skills/team-lifecycle-v4/roles/coordinator/commands/dispatch.md +1 -1
  85. package/.codex/skills/team-lifecycle-v4/roles/coordinator/commands/monitor.md +66 -24
  86. package/.codex/skills/team-lifecycle-v4/roles/coordinator/role.md +13 -1
  87. package/.codex/skills/team-lifecycle-v4/roles/supervisor/role.md +1 -1
  88. package/.codex/skills/team-lifecycle-v4/templates/architecture.md +254 -254
  89. package/.codex/skills/team-lifecycle-v4/templates/epics.md +196 -196
  90. package/.codex/skills/team-lifecycle-v4/templates/product-brief.md +133 -133
  91. package/.codex/skills/team-lifecycle-v4/templates/requirements.md +224 -224
  92. package/.codex/skills/team-perf-opt/SKILL.md +68 -3
  93. package/.codex/skills/team-perf-opt/roles/benchmarker/role.md +89 -89
  94. package/.codex/skills/team-perf-opt/roles/coordinator/commands/analyze.md +61 -61
  95. package/.codex/skills/team-perf-opt/roles/coordinator/commands/monitor.md +35 -1
  96. package/.codex/skills/team-perf-opt/roles/coordinator/role.md +179 -167
  97. package/.codex/skills/team-perf-opt/roles/optimizer/role.md +97 -97
  98. package/.codex/skills/team-perf-opt/roles/profiler/role.md +73 -73
  99. package/.codex/skills/team-perf-opt/roles/reviewer/role.md +75 -75
  100. package/.codex/skills/team-perf-opt/roles/strategist/role.md +94 -94
  101. package/.codex/skills/team-perf-opt/specs/pipelines.md +65 -65
  102. package/.codex/skills/team-planex/SKILL.md +65 -3
  103. package/.codex/skills/team-planex/roles/coordinator/commands/analyze.md +52 -52
  104. package/.codex/skills/team-planex/roles/coordinator/commands/monitor.md +210 -164
  105. package/.codex/skills/team-planex/roles/coordinator/role.md +171 -159
  106. package/.codex/skills/team-planex/roles/executor/role.md +91 -91
  107. package/.codex/skills/team-planex/roles/planner/role.md +112 -112
  108. package/.codex/skills/team-planex/specs/pipelines.md +93 -93
  109. package/.codex/skills/team-quality-assurance/SKILL.md +60 -3
  110. package/.codex/skills/team-quality-assurance/roles/analyst/role.md +80 -80
  111. package/.codex/skills/team-quality-assurance/roles/coordinator/commands/analyze.md +72 -72
  112. package/.codex/skills/team-quality-assurance/roles/coordinator/commands/dispatch.md +108 -108
  113. package/.codex/skills/team-quality-assurance/roles/coordinator/commands/monitor.md +243 -209
  114. package/.codex/skills/team-quality-assurance/roles/coordinator/role.md +176 -164
  115. package/.codex/skills/team-quality-assurance/roles/executor/role.md +66 -66
  116. package/.codex/skills/team-quality-assurance/roles/generator/role.md +68 -68
  117. package/.codex/skills/team-quality-assurance/roles/scout/role.md +67 -67
  118. package/.codex/skills/team-quality-assurance/roles/strategist/role.md +71 -71
  119. package/.codex/skills/team-quality-assurance/specs/pipelines.md +115 -115
  120. package/.codex/skills/team-review/SKILL.md +58 -3
  121. package/.codex/skills/team-review/roles/coordinator/commands/analyze.md +71 -71
  122. package/.codex/skills/team-review/roles/coordinator/commands/dispatch.md +90 -90
  123. package/.codex/skills/team-review/roles/coordinator/commands/monitor.md +225 -185
  124. package/.codex/skills/team-review/roles/coordinator/role.md +175 -163
  125. package/.codex/skills/team-review/roles/fixer/role.md +76 -76
  126. package/.codex/skills/team-review/roles/reviewer/role.md +68 -68
  127. package/.codex/skills/team-review/roles/scanner/role.md +71 -71
  128. package/.codex/skills/team-review/specs/pipelines.md +102 -102
  129. package/.codex/skills/team-roadmap-dev/SKILL.md +55 -3
  130. package/.codex/skills/team-roadmap-dev/roles/coordinator/commands/analyze.md +61 -61
  131. package/.codex/skills/team-roadmap-dev/roles/coordinator/commands/monitor.md +502 -468
  132. package/.codex/skills/team-roadmap-dev/roles/coordinator/role.md +335 -322
  133. package/.codex/skills/team-roadmap-dev/roles/executor/role.md +71 -71
  134. package/.codex/skills/team-roadmap-dev/roles/planner/role.md +76 -76
  135. package/.codex/skills/team-roadmap-dev/roles/verifier/role.md +74 -74
  136. package/.codex/skills/team-roadmap-dev/specs/pipelines.md +93 -93
  137. package/.codex/skills/team-tech-debt/SKILL.md +56 -3
  138. package/.codex/skills/team-tech-debt/roles/assessor/role.md +69 -69
  139. package/.codex/skills/team-tech-debt/roles/coordinator/commands/analyze.md +47 -47
  140. package/.codex/skills/team-tech-debt/roles/coordinator/commands/monitor.md +272 -231
  141. package/.codex/skills/team-tech-debt/roles/coordinator/role.md +172 -160
  142. package/.codex/skills/team-tech-debt/roles/executor/role.md +76 -76
  143. package/.codex/skills/team-tech-debt/roles/planner/role.md +69 -69
  144. package/.codex/skills/team-tech-debt/roles/scanner/role.md +82 -82
  145. package/.codex/skills/team-tech-debt/roles/validator/role.md +75 -75
  146. package/.codex/skills/team-tech-debt/specs/pipelines.md +47 -47
  147. package/.codex/skills/team-testing/SKILL.md +72 -3
  148. package/.codex/skills/team-testing/roles/analyst/role.md +95 -95
  149. package/.codex/skills/team-testing/roles/coordinator/commands/analyze.md +70 -70
  150. package/.codex/skills/team-testing/roles/coordinator/commands/dispatch.md +106 -106
  151. package/.codex/skills/team-testing/roles/coordinator/commands/monitor.md +283 -242
  152. package/.codex/skills/team-testing/roles/coordinator/role.md +184 -172
  153. package/.codex/skills/team-testing/roles/executor/role.md +96 -96
  154. package/.codex/skills/team-testing/roles/generator/role.md +95 -95
  155. package/.codex/skills/team-testing/roles/strategist/role.md +83 -83
  156. package/.codex/skills/team-testing/specs/pipelines.md +101 -101
  157. package/.codex/skills/team-uidesign/SKILL.md +65 -3
  158. package/.codex/skills/team-uidesign/roles/coordinator/commands/analyze.md +59 -59
  159. package/.codex/skills/team-uidesign/roles/coordinator/commands/dispatch.md +156 -156
  160. package/.codex/skills/team-uidesign/roles/coordinator/commands/monitor.md +234 -194
  161. package/.codex/skills/team-uidesign/roles/coordinator/role.md +211 -199
  162. package/.codex/skills/team-uidesign/roles/designer/role.md +69 -69
  163. package/.codex/skills/team-uidesign/roles/implementer/role.md +72 -72
  164. package/.codex/skills/team-uidesign/roles/researcher/role.md +82 -82
  165. package/.codex/skills/team-uidesign/roles/reviewer/role.md +67 -67
  166. package/.codex/skills/team-uidesign/specs/pipelines.md +76 -76
  167. package/.codex/skills/team-ultra-analyze/SKILL.md +73 -3
  168. package/.codex/skills/team-ultra-analyze/roles/analyst/role.md +90 -90
  169. package/.codex/skills/team-ultra-analyze/roles/coordinator/commands/analyze.md +73 -73
  170. package/.codex/skills/team-ultra-analyze/roles/coordinator/commands/monitor.md +50 -9
  171. package/.codex/skills/team-ultra-analyze/roles/coordinator/role.md +255 -243
  172. package/.codex/skills/team-ultra-analyze/roles/discussant/role.md +104 -104
  173. package/.codex/skills/team-ultra-analyze/roles/explorer/role.md +74 -74
  174. package/.codex/skills/team-ultra-analyze/roles/synthesizer/role.md +78 -78
  175. package/.codex/skills/team-ultra-analyze/specs/pipelines.md +64 -64
  176. package/.codex/skills/team-ux-improve/SKILL.md +64 -3
  177. package/.codex/skills/team-ux-improve/roles/coordinator/commands/analyze.md +62 -62
  178. package/.codex/skills/team-ux-improve/roles/coordinator/commands/dispatch.md +233 -233
  179. package/.codex/skills/team-ux-improve/roles/coordinator/commands/monitor.md +195 -160
  180. package/.codex/skills/team-ux-improve/roles/coordinator/role.md +170 -158
  181. package/.codex/skills/team-ux-improve/roles/designer/role.md +122 -122
  182. package/.codex/skills/team-ux-improve/roles/diagnoser/role.md +93 -93
  183. package/.codex/skills/team-ux-improve/roles/explorer/role.md +77 -77
  184. package/.codex/skills/team-ux-improve/roles/implementer/role.md +102 -102
  185. package/.codex/skills/team-ux-improve/roles/scanner/role.md +93 -93
  186. package/.codex/skills/team-ux-improve/roles/tester/role.md +84 -84
  187. package/.codex/skills/team-ux-improve/specs/pipelines.md +54 -54
  188. package/.codex/skills/workflow-test-fix-cycle/SKILL.md +402 -402
  189. package/README.md +1 -0
  190. package/package.json +1 -1
  191. package/.claude/skills/team-iterdev/SKILL.md +0 -127
  192. package/.claude/skills/team-iterdev/roles/architect/role.md +0 -65
  193. package/.claude/skills/team-iterdev/roles/coordinator/commands/analyze.md +0 -62
  194. package/.claude/skills/team-iterdev/roles/coordinator/commands/dispatch.md +0 -234
  195. package/.claude/skills/team-iterdev/roles/coordinator/commands/monitor.md +0 -182
  196. package/.claude/skills/team-iterdev/roles/coordinator/role.md +0 -153
  197. package/.claude/skills/team-iterdev/roles/developer/role.md +0 -74
  198. package/.claude/skills/team-iterdev/roles/reviewer/role.md +0 -66
  199. package/.claude/skills/team-iterdev/roles/tester/role.md +0 -88
  200. package/.claude/skills/team-iterdev/specs/pipelines.md +0 -94
  201. package/.claude/skills/team-iterdev/specs/team-config.json +0 -172
  202. package/.codex/skills/team-iterdev/SKILL.md +0 -158
  203. package/.codex/skills/team-iterdev/roles/architect/role.md +0 -65
  204. package/.codex/skills/team-iterdev/roles/coordinator/commands/analyze.md +0 -62
  205. package/.codex/skills/team-iterdev/roles/coordinator/commands/dispatch.md +0 -187
  206. package/.codex/skills/team-iterdev/roles/coordinator/commands/monitor.md +0 -186
  207. package/.codex/skills/team-iterdev/roles/coordinator/role.md +0 -181
  208. package/.codex/skills/team-iterdev/roles/developer/role.md +0 -74
  209. package/.codex/skills/team-iterdev/roles/reviewer/role.md +0 -66
  210. package/.codex/skills/team-iterdev/roles/tester/role.md +0 -88
  211. package/.codex/skills/team-iterdev/specs/pipelines.md +0 -94
  212. package/.codex/skills/team-iterdev/specs/team-config.json +0 -172
@@ -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` / `send_input` 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
-
38
- ### MUST NOT
39
- - Implement domain logic (researching, designing, auditing, building) -- workers handle this
40
- - Spawn workers without creating tasks first
41
- - Skip sync points when configured
42
- - Force-advance pipeline past failed audit
43
- - Modify source code or design artifacts directly -- delegate to workers
44
- - Omit `[coordinator]` identifier in any output
45
- - Call CLI tools (ccw cli) only workers use CLI
46
-
47
- ## Command Execution Protocol
48
-
49
- When coordinator needs to execute a command (analyze, dispatch, monitor):
50
-
51
- 1. Read `commands/<command>.md`
52
- 2. Follow the workflow defined in the command
53
- 3. Commands are inline execution guides, NOT separate agents
54
- 4. Execute synchronously, complete before proceeding
55
-
56
- ## Entry Router
57
-
58
- | Detection | Condition | Handler |
59
- |-----------|-----------|---------|
60
- | Status check | Args contain "check" or "status" | -> handleCheck (monitor.md) |
61
- | Manual resume | Args contain "resume" or "continue" | -> handleResume (monitor.md) |
62
- | Capability gap | Message contains "capability_gap" | -> handleAdapt (monitor.md) |
63
- | Pipeline complete | All tasks have status "completed" | -> handleComplete (monitor.md) |
64
- | Interrupted session | Active/paused session exists in .workflow/.team/UDS-* | -> Phase 0 |
65
- | New session | None of above | -> Phase 1 |
66
-
67
- For check/resume/adapt/complete: load `@commands/monitor.md`, execute matched handler, STOP.
68
-
69
- ## Phase 0: Session Resume Check
70
-
71
- 1. Scan `.workflow/.team/UDS-*/tasks.json` for active/paused sessions
72
- 2. No sessions -> Phase 1
73
- 3. Single session -> reconcile (read tasks.json, reset in_progress->pending, kick first ready task)
74
- 4. Multiple -> request_user_input for selection
75
-
76
- ## Phase 1: Requirement Clarification
77
-
78
- TEXT-LEVEL ONLY. No source code reading.
79
-
80
- 1. Parse task description from arguments
81
- 2. Detect design scope:
82
-
83
- | Signal | Pipeline Mode |
84
- |--------|---------------|
85
- | Single component mentioned | component |
86
- | Multiple components or "design system" | system |
87
- | "Full design system" or "complete redesign" | full-system |
88
- | Unclear | ask user |
89
-
90
- 3. Ask for missing parameters if scope unclear:
91
- ```
92
- request_user_input({
93
- questions: [
94
- { question: "UI design scope?", header: "Scope", options: [
95
- { label: "Single component" },
96
- { label: "Component system" },
97
- { label: "Full design system" }
98
- ]},
99
- { question: "Product type/industry?", header: "Industry", options: [
100
- { label: "SaaS/Tech" }, { label: "E-commerce" },
101
- { label: "Healthcare/Finance" }, { label: "Education/Content" }, { label: "Other" }
102
- ]}
103
- ]
104
- })
105
- ```
106
- 4. Delegate to `@commands/analyze.md` -> output scope context
107
- 5. Record: pipeline_mode, industry, complexity
108
-
109
- ## Phase 2: Create Session + Initialize
110
-
111
- 1. Resolve workspace paths (MUST do first):
112
- - `project_root` = result of `Bash({ command: "pwd" })`
113
- - `skill_root` = `<project_root>/.codex/skills/team-uidesign`
114
- 2. Generate session ID: `UDS-<slug>-<YYYY-MM-DD>`
115
- 3. Create session folder structure:
116
- ```
117
- .workflow/.team/UDS-<slug>-<date>/research/
118
- .workflow/.team/UDS-<slug>-<date>/design/component-specs/
119
- .workflow/.team/UDS-<slug>-<date>/design/layout-specs/
120
- .workflow/.team/UDS-<slug>-<date>/audit/
121
- .workflow/.team/UDS-<slug>-<date>/build/token-files/
122
- .workflow/.team/UDS-<slug>-<date>/build/component-files/
123
- .workflow/.team/UDS-<slug>-<date>/wisdom/
124
- .workflow/.team/UDS-<slug>-<date>/.msg/
125
- ```
126
- 4. Initialize `.msg/meta.json` via team_msg state_update with pipeline metadata
127
- 5. Write initial tasks.json:
128
- ```json
129
- {
130
- "session_id": "<id>",
131
- "pipeline_mode": "<component|system|full-system>",
132
- "industry": "<industry>",
133
- "created_at": "<ISO timestamp>",
134
- "gc_rounds": 0,
135
- "max_gc_rounds": 2,
136
- "active_agents": {},
137
- "tasks": {}
138
- }
139
- ```
140
- 6. Do NOT spawn workers yet - deferred to Phase 4
141
-
142
- ## Phase 3: Create Task Chain
143
-
144
- Delegate to `@commands/dispatch.md`. Task chains by mode:
145
-
146
- | Mode | Task Chain |
147
- |------|------------|
148
- | component | RESEARCH-001 -> DESIGN-001 -> AUDIT-001 -> BUILD-001 |
149
- | system | RESEARCH-001 -> DESIGN-001 -> AUDIT-001 -> [DESIGN-002 + BUILD-001] -> AUDIT-002 -> BUILD-002 |
150
- | full-system | system chain + AUDIT-003 after BUILD-002 |
151
-
152
- ## Phase 4: Spawn-and-Wait
153
-
154
- Delegate to `@commands/monitor.md#handleSpawnNext`:
155
- 1. Find ready tasks (pending + deps resolved)
156
- 2. Spawn team_worker agents via spawn_agent, wait_agent for results
157
- 3. Output status summary
158
- 4. STOP
159
-
160
- ## Phase 5: Report + Completion Action
161
-
162
- 1. Read session state -> collect all results
163
- 2. List deliverables:
164
-
165
- | Deliverable | Path |
166
- |-------------|------|
167
- | Design System Analysis | <session>/research/design-system-analysis.json |
168
- | Component Inventory | <session>/research/component-inventory.json |
169
- | Accessibility Audit | <session>/research/accessibility-audit.json |
170
- | Design Intelligence | <session>/research/design-intelligence.json |
171
- | Design Tokens | <session>/design/design-tokens.json |
172
- | Component Specs | <session>/design/component-specs/*.md |
173
- | Audit Reports | <session>/audit/audit-*.md |
174
- | Token Files | <session>/build/token-files/* |
175
- | Component Files | <session>/build/component-files/* |
176
-
177
- 3. Calculate: completed_tasks, gc_rounds, sync_points_passed, final_audit_score
178
- 4. Output pipeline summary with [coordinator] prefix
179
- 5. Execute completion action:
180
- ```
181
- request_user_input({
182
- questions: [{ question: "Pipeline complete. What next?", header: "Completion", options: [
183
- { label: "Archive & Clean", description: "Archive session and clean up resources" },
184
- { label: "Keep Active", description: "Keep session for follow-up work" },
185
- { label: "Export Results", description: "Export deliverables to specified location" }
186
- ]}]
187
- })
188
- ```
189
-
190
- ## Error Handling
191
-
192
- | Error | Resolution |
193
- |-------|------------|
194
- | Task timeout | Log, mark failed, ask user to retry or skip |
195
- | Worker crash | Reset task to pending, respawn worker |
196
- | Dependency cycle | Detect, report to user, halt |
197
- | Invalid scope | Reject with error, ask to clarify |
198
- | Session corruption | Attempt recovery, fallback to manual reconciliation |
199
- | GC loop stuck > 2 rounds | Escalate to user: accept / try one more / terminate |
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