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,181 +0,0 @@
1
- # Coordinator Role
2
-
3
- Orchestrate team-iterdev: analyze -> dispatch -> spawn -> monitor -> report.
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
- - Use `team_worker` agent type for all worker spawns (NOT `general-purpose`)
31
- - Follow Command Execution Protocol for dispatch and monitor commands
32
- - Respect pipeline stage dependencies (deps)
33
- - Stop after spawning workers -- wait for results via wait_agent
34
- - Handle developer<->reviewer GC loop (max 3 rounds)
35
- - Maintain tasks.json for real-time progress
36
- - Execute completion action in Phase 5
37
- - **Always proceed through full Phase 1-5 workflow, never skip to direct execution**
38
-
39
- ### MUST NOT
40
- - Implement domain logic (designing, coding, testing, reviewing) -- workers handle this
41
- - Spawn workers without creating tasks first
42
- - Write source code directly
43
- - Force-advance pipeline past failed review/validation
44
- - Modify task outputs (workers own their deliverables)
45
- - Call CLI tools (ccw cli) — only workers use CLI
46
-
47
- ## Command Execution Protocol
48
-
49
- When coordinator needs to execute a command:
50
- 1. Read `commands/<command>.md`
51
- 2. Follow the workflow defined in the command
52
- 3. Commands are inline execution guides, NOT separate agents
53
- 4. Execute synchronously, complete before proceeding
54
-
55
- ## Entry Router
56
-
57
- | Detection | Condition | Handler |
58
- |-----------|-----------|---------|
59
- | Status check | Args contain "check" or "status" | -> handleCheck (monitor.md) |
60
- | Manual resume | Args contain "resume" or "continue" | -> handleResume (monitor.md) |
61
- | Pipeline complete | All tasks completed | -> handleComplete (monitor.md) |
62
- | Interrupted session | Active/paused session in .workflow/.team/IDS-* | -> Phase 0 |
63
- | New session | None of above | -> Phase 1 |
64
-
65
- For check/resume/complete: load @commands/monitor.md, execute handler, STOP.
66
-
67
- ## Phase 0: Session Resume Check
68
-
69
- 1. Scan `.workflow/.team/IDS-*/tasks.json` for active/paused sessions
70
- 2. No sessions -> Phase 1
71
- 3. Single session -> reconcile (read tasks.json, reset in_progress->pending, kick first ready task)
72
- 4. Multiple -> request_user_input for selection
73
-
74
- ## Phase 1: Requirement Clarification
75
-
76
- TEXT-LEVEL ONLY. No source code reading.
77
-
78
- 1. Parse user task description from $ARGUMENTS
79
- 2. Delegate to @commands/analyze.md
80
- 3. Assess complexity for pipeline selection:
81
-
82
- | Signal | Weight |
83
- |--------|--------|
84
- | Changed files > 10 | +3 |
85
- | Changed files 3-10 | +2 |
86
- | Structural change (refactor, architect, restructure) | +3 |
87
- | Cross-cutting (multiple, across, cross) | +2 |
88
- | Simple fix (fix, bug, typo, patch) | -2 |
89
-
90
- | Score | Pipeline |
91
- |-------|----------|
92
- | >= 5 | multi-sprint |
93
- | 2-4 | sprint |
94
- | 0-1 | patch |
95
-
96
- 4. Ask for missing parameters via request_user_input (mode selection)
97
- 5. Record requirement with scope, pipeline mode
98
- 6. CRITICAL: Always proceed to Phase 2, never skip team workflow
99
-
100
- ## Phase 2: Session & Team Setup
101
-
102
- 1. Resolve workspace paths (MUST do first):
103
- - `project_root` = result of `Bash({ command: "pwd" })`
104
- - `skill_root` = `<project_root>/.codex/skills/team-iterdev`
105
- 2. Generate session ID: `IDS-<slug>-<YYYY-MM-DD>`
106
- 3. Create session folder structure:
107
- ```
108
- mkdir -p .workflow/.team/<session-id>/{design,code,verify,review,wisdom}
109
- ```
110
- 4. Read specs/pipelines.md -> select pipeline based on complexity
111
- 5. Initialize wisdom directory (learnings.md, decisions.md, conventions.md, issues.md)
112
- 6. Write initial tasks.json:
113
- ```json
114
- {
115
- "session_id": "<id>",
116
- "pipeline_mode": "<patch|sprint|multi-sprint>",
117
- "requirement": "<original requirement>",
118
- "created_at": "<ISO timestamp>",
119
- "gc_round": 0,
120
- "max_gc_rounds": 3,
121
- "active_agents": {},
122
- "tasks": {}
123
- }
124
- ```
125
- 7. Initialize meta.json with pipeline metadata:
126
- ```typescript
127
- mcp__ccw-tools__team_msg({
128
- operation: "log", session_id: "<id>", from: "coordinator",
129
- type: "state_update", summary: "Session initialized",
130
- data: {
131
- pipeline_mode: "<patch|sprint|multi-sprint>",
132
- pipeline_stages: ["architect", "developer", "tester", "reviewer"],
133
- roles: ["coordinator", "architect", "developer", "tester", "reviewer"]
134
- }
135
- })
136
- ```
137
-
138
- ## Phase 3: Task Chain Creation
139
-
140
- Delegate to @commands/dispatch.md:
141
- 1. Read specs/pipelines.md for selected pipeline task registry
142
- 2. Add task entries to tasks.json `tasks` object with deps
143
- 3. Update tasks.json metadata
144
-
145
- ## Phase 4: Spawn-and-Wait
146
-
147
- Delegate to @commands/monitor.md#handleSpawnNext:
148
- 1. Find ready tasks (pending + all deps resolved)
149
- 2. Spawn team_worker agents via spawn_agent, wait_agent for results
150
- 3. Output status summary
151
- 4. STOP
152
-
153
- ## Phase 5: Report + Completion Action
154
-
155
- 1. Load session state -> count completed tasks, calculate duration
156
- 2. Record sprint learning to .msg/meta.json sprint_history
157
- 3. List deliverables:
158
-
159
- | Deliverable | Path |
160
- |-------------|------|
161
- | Design Document | <session>/design/design-001.md |
162
- | Task Breakdown | <session>/design/task-breakdown.json |
163
- | Dev Log | <session>/code/dev-log.md |
164
- | Verification Results | <session>/verify/verify-001.json |
165
- | Review Report | <session>/review/review-001.md |
166
-
167
- 4. Execute completion action per session.completion_action:
168
- - interactive -> request_user_input (Archive/Keep/Export)
169
- - auto_archive -> Archive & Clean (status=completed)
170
- - auto_keep -> Keep Active (status=paused)
171
-
172
- ## Error Handling
173
-
174
- | Error | Resolution |
175
- |-------|------------|
176
- | Task too vague | request_user_input for clarification |
177
- | Session corruption | Attempt recovery, fallback to manual |
178
- | Worker crash | Reset task to pending, respawn |
179
- | GC loop exceeds 3 rounds | Accept with warning, record in shared memory |
180
- | Sprint velocity drops below 50% | Alert user, suggest scope reduction |
181
- | Task ledger corrupted | Rebuild from tasks.json state |
@@ -1,74 +0,0 @@
1
- ---
2
- role: developer
3
- prefix: DEV
4
- inner_loop: true
5
- message_types:
6
- success: dev_complete
7
- progress: dev_progress
8
- error: error
9
- ---
10
-
11
- # Developer
12
-
13
- Code implementer. Implements code according to design, incremental delivery. Acts as Generator in Generator-Critic loop (paired with reviewer).
14
-
15
- ## Phase 2: Context Loading
16
-
17
- | Input | Source | Required |
18
- |-------|--------|----------|
19
- | Task description | From task subject/description | Yes |
20
- | Session path | Extracted from task description | Yes |
21
- | .msg/meta.json | <session>/.msg/meta.json | Yes |
22
- | Design document | <session>/design/design-001.md | For non-fix tasks |
23
- | Task breakdown | <session>/design/task-breakdown.json | For non-fix tasks |
24
- | Review feedback | <session>/review/*.md | For fix tasks |
25
- | Wisdom files | <session>/wisdom/ | No |
26
-
27
- 1. Extract session path from task description
28
- 2. Read .msg/meta.json for shared context
29
- 3. Detect task type:
30
-
31
- | Task Type | Detection | Loading |
32
- |-----------|-----------|---------|
33
- | Fix task | Subject contains "fix" | Read latest review file for feedback |
34
- | Normal task | No "fix" in subject | Read design document + task breakdown |
35
-
36
- 4. Load previous implementation_context from .msg/meta.json
37
- 5. Read wisdom files for conventions and known issues
38
-
39
- ## Phase 3: Code Implementation
40
-
41
- **Implementation strategy selection**:
42
-
43
- | Task Count | Complexity | Strategy |
44
- |------------|------------|----------|
45
- | <= 2 tasks | Low | Direct: inline Edit/Write |
46
- | 3-5 tasks | Medium | Single agent: one code-developer for all |
47
- | > 5 tasks | High | Batch agent: group by module, one agent per batch |
48
-
49
- **Fix Task Mode** (GC Loop):
50
- - Focus on review feedback items only
51
- - Fix critical issues first, then high, then medium
52
- - Do NOT change code that was not flagged
53
- - Maintain existing code style and patterns
54
-
55
- **Normal Task Mode**:
56
- - Read target files, apply changes using Edit or Write
57
- - Follow execution order from task breakdown
58
- - Validate syntax after each major change
59
-
60
- ## Phase 4: Self-Validation
61
-
62
- | Check | Method | Pass Criteria |
63
- |-------|--------|---------------|
64
- | Syntax | tsc --noEmit or equivalent | No errors |
65
- | File existence | Verify all planned files exist | All files present |
66
- | Import resolution | Check no broken imports | All imports resolve |
67
-
68
- 1. Run syntax check: `tsc --noEmit` / `python -m py_compile` / equivalent
69
- 2. Auto-fix if validation fails (max 2 attempts)
70
- 3. Write dev log to `<session>/code/dev-log.md`:
71
- - Changed files count, syntax status, fix task flag, file list
72
- 4. Update implementation_context in .msg/meta.json:
73
- - task, changed_files, is_fix, syntax_clean
74
- 5. Write discoveries to wisdom/learnings.md
@@ -1,66 +0,0 @@
1
- ---
2
- role: reviewer
3
- prefix: REVIEW
4
- inner_loop: false
5
- message_types:
6
- success: review_passed
7
- revision: review_revision
8
- critical: review_critical
9
- error: error
10
- ---
11
-
12
- # Reviewer
13
-
14
- Code reviewer. Multi-dimensional review, quality scoring, improvement suggestions. Acts as Critic in Generator-Critic loop (paired with developer).
15
-
16
- ## Phase 2: Context Loading
17
-
18
- | Input | Source | Required |
19
- |-------|--------|----------|
20
- | Task description | From task subject/description | Yes |
21
- | Session path | Extracted from task description | Yes |
22
- | .msg/meta.json | <session>/.msg/meta.json | Yes |
23
- | Design document | <session>/design/design-001.md | For requirements alignment |
24
- | Changed files | Git diff | Yes |
25
-
26
- 1. Extract session path from task description
27
- 2. Read .msg/meta.json for shared context and previous review_feedback_trends
28
- 3. Read design document for requirements alignment
29
- 4. Get changed files via git diff, read file contents (limit 20 files)
30
-
31
- ## Phase 3: Multi-Dimensional Review
32
-
33
- **Review dimensions**:
34
-
35
- | Dimension | Weight | Focus Areas |
36
- |-----------|--------|-------------|
37
- | Correctness | 30% | Logic correctness, boundary handling |
38
- | Completeness | 25% | Coverage of design requirements |
39
- | Maintainability | 25% | Readability, code style, DRY |
40
- | Security | 20% | Vulnerabilities, input validation |
41
-
42
- Per-dimension: scan modified files, record findings with severity (CRITICAL/HIGH/MEDIUM/LOW), include file:line references and suggestions.
43
-
44
- **Scoring**: Weighted average of dimension scores (1-10 each).
45
-
46
- **Output review report** (`<session>/review/review-<num>.md`):
47
- - Files reviewed count, quality score, issue counts by severity
48
- - Per-finding: severity, file:line, dimension, description, suggestion
49
- - Scoring breakdown by dimension
50
- - Signal: CRITICAL / REVISION_NEEDED / APPROVED
51
- - Design alignment notes
52
-
53
- ## Phase 4: Trend Analysis + Verdict
54
-
55
- 1. Compare with previous review_feedback_trends from .msg/meta.json
56
- 2. Identify recurring issues, improvement areas, new issues
57
-
58
- | Verdict Condition | Message Type |
59
- |-------------------|--------------|
60
- | criticalCount > 0 | review_critical |
61
- | score < 7 | review_revision |
62
- | else | review_passed |
63
-
64
- 3. Update review_feedback_trends in .msg/meta.json:
65
- - review_id, score, critical count, high count, dimensions, gc_round
66
- 4. Write discoveries to wisdom/learnings.md
@@ -1,88 +0,0 @@
1
- ---
2
- role: tester
3
- prefix: VERIFY
4
- inner_loop: false
5
- message_types:
6
- success: verify_passed
7
- failure: verify_failed
8
- fix: fix_required
9
- error: error
10
- ---
11
-
12
- # Tester
13
-
14
- Test validator. Test execution, fix cycles, and regression detection.
15
-
16
- ## Phase 2: Environment Detection
17
-
18
- | Input | Source | Required |
19
- |-------|--------|----------|
20
- | Task description | From task subject/description | Yes |
21
- | Session path | Extracted from task description | Yes |
22
- | .msg/meta.json | <session>/.msg/meta.json | Yes |
23
- | Changed files | Git diff | Yes |
24
-
25
- 1. Extract session path from task description
26
- 2. Read .msg/meta.json for shared context
27
- 3. Get changed files via git diff
28
- 4. Detect test framework and command:
29
-
30
- | Detection | Method |
31
- |-----------|--------|
32
- | Test command | Check package.json scripts, pytest.ini, Makefile |
33
- | Coverage tool | Check for nyc, coverage.py, jest --coverage config |
34
-
35
- Common commands: npm test, pytest, go test ./..., cargo test
36
-
37
- ## Phase 3: Execution + Fix Cycle
38
-
39
- **Iterative test-fix cycle** (max 5 iterations):
40
-
41
- | Step | Action |
42
- |------|--------|
43
- | 1 | Run test command |
44
- | 2 | Parse results, check pass rate |
45
- | 3 | Pass rate >= 95% -> exit loop (success) |
46
- | 4 | Extract failing test details |
47
- | 5 | Apply fix using CLI tool |
48
- | 6 | Increment iteration counter |
49
- | 7 | iteration >= MAX (5) -> exit loop (report failures) |
50
- | 8 | Go to Step 1 |
51
-
52
- **Fix delegation**: Use CLI tool to fix failing tests:
53
-
54
- ```bash
55
- ccw cli -p "PURPOSE: Fix failing tests; success = all listed tests pass
56
- TASK: • Analyze test failure output • Identify root cause in changed files • Apply minimal fix
57
- MODE: write
58
- CONTEXT: @<changed-files> | Memory: Test output from current iteration
59
- EXPECTED: Code fixes that make failing tests pass without breaking other tests
60
- CONSTRAINTS: Only modify files in changed list | Minimal changes
61
- Test output: <test-failure-details>
62
- Changed files: <file-list>" --tool gemini --mode write --rule development-debug-runtime-issues
63
- ```
64
-
65
- Wait for CLI completion before re-running tests.
66
-
67
- ## Phase 4: Regression Check + Report
68
-
69
- 1. Run full test suite for regression: `<test-command> --all`
70
-
71
- | Check | Method | Pass Criteria |
72
- |-------|--------|---------------|
73
- | Regression | Run full test suite | No FAIL in output |
74
- | Coverage | Run coverage tool | >= 80% (if configured) |
75
-
76
- 2. Write verification results to `<session>/verify/verify-<num>.json`:
77
- - verify_id, pass_rate, iterations, passed, timestamp, regression_passed
78
-
79
- 3. Determine message type:
80
-
81
- | Condition | Message Type |
82
- |-----------|--------------|
83
- | passRate >= 0.95 | verify_passed |
84
- | passRate < 0.95 && iterations >= MAX | fix_required |
85
- | passRate < 0.95 | verify_failed |
86
-
87
- 4. Update .msg/meta.json with test_patterns entry
88
- 5. Write discoveries to wisdom/issues.md
@@ -1,94 +0,0 @@
1
- # IterDev Pipeline Definitions
2
-
3
- ## Three-Pipeline Architecture
4
-
5
- ### Patch Pipeline (2 beats, serial)
6
-
7
- ```
8
- DEV-001 -> VERIFY-001
9
- [developer] [tester]
10
- ```
11
-
12
- ### Sprint Pipeline (4 beats, with parallel window)
13
-
14
- ```
15
- DESIGN-001 -> DEV-001 -> [VERIFY-001 + REVIEW-001] (parallel)
16
- [architect] [developer] [tester] [reviewer]
17
- ```
18
-
19
- ### Multi-Sprint Pipeline (N beats, iterative)
20
-
21
- ```
22
- Sprint 1: DESIGN-001 -> DEV-001 -> DEV-002(incremental) -> VERIFY-001 -> DEV-fix -> REVIEW-001
23
- Sprint 2: DESIGN-002(refined) -> DEV-003 -> VERIFY-002 -> REVIEW-002
24
- ...
25
- ```
26
-
27
- ## Generator-Critic Loop (developer <-> reviewer)
28
-
29
- ```
30
- DEV -> REVIEW -> (if review.critical_count > 0 || review.score < 7)
31
- -> DEV-fix -> REVIEW-2 -> (if still issues) -> DEV-fix-2 -> REVIEW-3
32
- -> (max 3 rounds, then accept with warning)
33
- ```
34
-
35
- ## Pipeline Selection Logic
36
-
37
- | Signal | Score |
38
- |--------|-------|
39
- | Changed files > 10 | +3 |
40
- | Changed files 3-10 | +2 |
41
- | Structural change | +3 |
42
- | Cross-cutting concern | +2 |
43
- | Simple fix | -2 |
44
-
45
- | Score | Pipeline |
46
- |-------|----------|
47
- | >= 5 | multi-sprint |
48
- | 2-4 | sprint |
49
- | 0-1 | patch |
50
-
51
- ## Task Metadata Registry
52
-
53
- | Task ID | Role | Pipeline | Dependencies | Description |
54
- |---------|------|----------|-------------|-------------|
55
- | DESIGN-001 | architect | sprint/multi | (none) | Technical design and task breakdown |
56
- | DEV-001 | developer | all | DESIGN-001 (sprint/multi) or (none for patch) | Code implementation |
57
- | DEV-002 | developer | multi | DEV-001 | Incremental implementation |
58
- | DEV-fix | developer | sprint/multi | REVIEW-* (GC loop trigger) | Fix issues from review |
59
- | VERIFY-001 | tester | all | DEV-001 (or last DEV) | Test execution and fix cycles |
60
- | REVIEW-001 | reviewer | sprint/multi | DEV-001 (or last DEV) | Code review and quality scoring |
61
-
62
- ## Checkpoints
63
-
64
- | Trigger Condition | Location | Behavior |
65
- |-------------------|----------|----------|
66
- | GC loop exceeds max rounds | After REVIEW-3 | Stop iteration, accept with warning, record in wisdom |
67
- | Sprint transition | End of Sprint N | Pause, retrospective, user confirms `resume` for Sprint N+1 |
68
- | Pipeline stall | No ready + no running tasks | Check missing tasks, report blockedBy chain to user |
69
-
70
- ## Multi-Sprint Dynamic Downgrade
71
-
72
- If Sprint N metrics are strong (velocity >= expected, review avg >= 8), coordinator may downgrade Sprint N+1 from multi-sprint to sprint pipeline for efficiency.
73
-
74
- ## Task Ledger Schema
75
-
76
- | Field | Description |
77
- |-------|-------------|
78
- | `sprint_id` | Current sprint identifier |
79
- | `sprint_goal` | Sprint objective |
80
- | `tasks[]` | Array of task entries |
81
- | `metrics` | Aggregated metrics: total, completed, in_progress, blocked, velocity |
82
-
83
- **Task Entry Fields**:
84
-
85
- | Field | Description |
86
- |-------|-------------|
87
- | `id` | Task identifier |
88
- | `title` | Task title |
89
- | `owner` | Assigned role |
90
- | `status` | pending / in_progress / completed / blocked |
91
- | `started_at` / `completed_at` | Timestamps |
92
- | `gc_rounds` | Generator-Critic iteration count |
93
- | `review_score` | Reviewer score (null until reviewed) |
94
- | `test_pass_rate` | Tester pass rate (null until tested) |
@@ -1,172 +0,0 @@
1
- {
2
- "team_name": "team-iterdev",
3
- "team_display_name": "Team IterDev",
4
- "description": "Iterative development team with Generator-Critic loop, task ledger, sprint learning, dynamic pipeline, conflict handling, concurrency control, rollback strategy, user feedback loop, and tech debt tracking",
5
- "version": "1.2.0",
6
-
7
- "roles": {
8
- "coordinator": {
9
- "task_prefix": null,
10
- "responsibility": "Sprint planning, backlog management, task ledger maintenance, GC loop control, Phase 1: conflict handling, concurrency control, rollback strategy, Phase 3: user feedback loop, tech debt tracking",
11
- "message_types": [
12
- "sprint_started", "gc_loop_trigger", "sprint_complete", "task_unblocked", "error", "shutdown",
13
- "conflict_detected", "conflict_resolved", "resource_locked", "resource_unlocked", "resource_contention",
14
- "rollback_initiated", "rollback_completed", "rollback_failed",
15
- "user_feedback_received", "tech_debt_identified"
16
- ]
17
- },
18
- "architect": {
19
- "task_prefix": "DESIGN",
20
- "responsibility": "Technical design, task decomposition, architecture decisions",
21
- "message_types": ["design_ready", "design_revision", "error"]
22
- },
23
- "developer": {
24
- "task_prefix": "DEV",
25
- "responsibility": "Code implementation, incremental delivery",
26
- "message_types": ["dev_complete", "dev_progress", "error"]
27
- },
28
- "tester": {
29
- "task_prefix": "VERIFY",
30
- "responsibility": "Test execution, fix cycle, regression detection",
31
- "message_types": ["verify_passed", "verify_failed", "fix_required", "error"]
32
- },
33
- "reviewer": {
34
- "task_prefix": "REVIEW",
35
- "responsibility": "Code review, quality scoring, improvement suggestions",
36
- "message_types": ["review_passed", "review_revision", "review_critical", "error"]
37
- }
38
- },
39
-
40
- "pipelines": {
41
- "patch": {
42
- "description": "Simple fix: implement → verify",
43
- "task_chain": ["DEV-001", "VERIFY-001"],
44
- "gc_loops": 0
45
- },
46
- "sprint": {
47
- "description": "Standard feature: design → implement → verify + review (parallel)",
48
- "task_chain": ["DESIGN-001", "DEV-001", "VERIFY-001", "REVIEW-001"],
49
- "gc_loops": 3,
50
- "parallel_groups": [["VERIFY-001", "REVIEW-001"]]
51
- },
52
- "multi-sprint": {
53
- "description": "Large feature: multiple sprint cycles with incremental delivery",
54
- "task_chain": "dynamic — coordinator creates per-sprint chains",
55
- "gc_loops": 3,
56
- "sprint_count": "dynamic"
57
- }
58
- },
59
-
60
- "innovation_patterns": {
61
- "generator_critic": {
62
- "generator": "developer",
63
- "critic": "reviewer",
64
- "max_rounds": 3,
65
- "convergence_trigger": "review.critical_count === 0 && review.score >= 7"
66
- },
67
- "task_ledger": {
68
- "file": "task-ledger.json",
69
- "updated_by": "coordinator",
70
- "tracks": ["status", "gc_rounds", "review_score", "test_pass_rate", "velocity"],
71
- "phase1_extensions": {
72
- "conflict_info": {
73
- "fields": ["status", "conflicting_files", "resolution_strategy", "resolved_by_task_id"],
74
- "default": { "status": "none", "conflicting_files": [], "resolution_strategy": null, "resolved_by_task_id": null }
75
- },
76
- "rollback_info": {
77
- "fields": ["snapshot_id", "rollback_procedure", "last_successful_state_id"],
78
- "default": { "snapshot_id": null, "rollback_procedure": null, "last_successful_state_id": null }
79
- }
80
- }
81
- },
82
- "shared_memory": {
83
- "file": "shared-memory.json",
84
- "fields": {
85
- "architect": "architecture_decisions",
86
- "developer": "implementation_context",
87
- "tester": "test_patterns",
88
- "reviewer": "review_feedback_trends"
89
- },
90
- "persistent_fields": ["sprint_history", "what_worked", "what_failed", "patterns_learned"],
91
- "phase1_extensions": {
92
- "resource_locks": {
93
- "description": "Concurrency control: resource locking state",
94
- "lock_timeout_ms": 300000,
95
- "deadlock_detection": true
96
- }
97
- }
98
- },
99
- "dynamic_pipeline": {
100
- "selector": "coordinator",
101
- "criteria": "file_count + module_count + complexity_assessment",
102
- "downgrade_rule": "velocity >= expected && review_avg >= 8 → simplify next sprint"
103
- }
104
- },
105
-
106
- "phase1_features": {
107
- "conflict_handling": {
108
- "enabled": true,
109
- "detection_strategy": "file_overlap",
110
- "resolution_strategies": ["manual", "auto_merge", "abort"]
111
- },
112
- "concurrency_control": {
113
- "enabled": true,
114
- "lock_timeout_minutes": 5,
115
- "deadlock_detection": true,
116
- "resources": ["task-ledger.json", "shared-memory.json"]
117
- },
118
- "rollback_strategy": {
119
- "enabled": true,
120
- "snapshot_trigger": "task_complete",
121
- "default_procedure": "git revert HEAD"
122
- }
123
- },
124
-
125
- "phase2_features": {
126
- "external_dependency_management": {
127
- "enabled": true,
128
- "validation_trigger": "task_start",
129
- "supported_sources": ["npm", "maven", "pip", "git"],
130
- "version_check_command": {
131
- "npm": "npm list {name}",
132
- "pip": "pip show {name}",
133
- "maven": "mvn dependency:tree"
134
- }
135
- },
136
- "state_recovery": {
137
- "enabled": true,
138
- "checkpoint_trigger": "phase_complete",
139
- "max_checkpoints_per_task": 5,
140
- "checkpoint_dir": "checkpoints/"
141
- }
142
- },
143
-
144
- "phase3_features": {
145
- "user_feedback_loop": {
146
- "enabled": true,
147
- "collection_trigger": "sprint_complete",
148
- "max_feedback_items": 50,
149
- "severity_levels": ["low", "medium", "high", "critical"],
150
- "status_flow": ["new", "reviewed", "addressed", "closed"]
151
- },
152
- "tech_debt_tracking": {
153
- "enabled": true,
154
- "detection_sources": ["review", "test", "architect"],
155
- "categories": ["code", "design", "test", "documentation"],
156
- "severity_levels": ["low", "medium", "high", "critical"],
157
- "status_flow": ["open", "in_progress", "resolved", "deferred"],
158
- "report_trigger": "sprint_retrospective"
159
- }
160
- },
161
-
162
- "collaboration_patterns": ["CP-1", "CP-3", "CP-5", "CP-6"],
163
-
164
- "session_dirs": {
165
- "base": ".workflow/.team/IDS-{slug}-{YYYY-MM-DD}/",
166
- "design": "design/",
167
- "code": "code/",
168
- "verify": "verify/",
169
- "review": "review/",
170
- "messages": ".workflow/.team-msg/{team-name}/"
171
- }
172
- }