Skip to content

Commit 8da1519

Browse files
author
catlog22
committed
Enhance worker progress reporting across multiple skills
- Added functionality to report worker progress milestones via message bus in the following skills: - team-lifecycle - team-motion-design - team-perf-opt - team-planex - team-quality-assurance - team-review - team-roadmap-dev - team-tech-debt - team-testing - team-ui-polish - team-uidesign - team-ultra-analyze - team-ux-improve - team-visual-a11y - Each skill now includes: - Session ID for tracking progress. - Reporting of progress at natural phase boundaries. - Immediate reporting of blockers. - Completion reporting after final message send. - Updated monitoring commands to include per-worker latest milestones and active blockers in status output.
1 parent f9501e3 commit 8da1519

44 files changed

Lines changed: 831 additions & 15 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.claude/skills/team-arch-opt/SKILL.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
name: team-arch-opt
33
description: Unified team skill for architecture optimization. Uses team-worker agent architecture with role directories for domain logic. Coordinator orchestrates pipeline, workers are team-worker agents. Triggers on "team arch-opt".
4-
allowed-tools: Agent, TaskCreate, TaskList, TaskGet, TaskUpdate, TeamCreate, TeamDelete, SendMessage, AskUserQuestion, Read, Write, Edit, Bash, Glob, Grep, mcp__ace-tool__search_context
4+
allowed-tools: Agent, TaskCreate, TaskList, TaskGet, TaskUpdate, TeamCreate, TeamDelete, SendMessage, AskUserQuestion, Read, Write, Edit, Bash, Glob, Grep, mcp__ace-tool__search_context, mcp__ccw-tools__team_msg
55
---
66

77
# Team Architecture Optimization
@@ -73,6 +73,12 @@ team_name: arch-opt
7373
requirement: <task-description>
7474
inner_loop: <true|false>
7575
76+
## Progress Milestones
77+
session_id: <session-id>
78+
Report progress via team_msg at natural phase boundaries (context loaded -> core work done -> verification).
79+
Report blockers immediately via team_msg type="blocker".
80+
Report completion via team_msg type="task_complete" after final SendMessage.
81+
7682
Read role_spec file (@<skill_root>/roles/<role>/role.md) to load Phase 2-4 domain instructions.
7783
Execute built-in Phase 1 (task discovery) -> role Phase 2-4 -> built-in Phase 5 (report).`
7884
})

.claude/skills/team-arch-opt/roles/coordinator/commands/monitor.md

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -57,6 +57,32 @@ Worker completed. Process and advance.
5757

5858
Read-only status report, then STOP.
5959

60+
**Worker Progress** (from message bus):
61+
62+
Before generating status output, read worker milestones:
63+
64+
```javascript
65+
const progressMsgs = mcp__ccw-tools__team_msg({
66+
operation: "list", session_id: sessionId, type: "progress", last: 50
67+
})
68+
const blockerMsgs = mcp__ccw-tools__team_msg({
69+
operation: "list", session_id: sessionId, type: "blocker", last: 10
70+
})
71+
72+
// Aggregate latest milestone per task
73+
const taskProgress = {}
74+
for (const msg of (progressMsgs.result?.messages || [])) {
75+
const tid = msg.data?.task_id
76+
if (tid && (!taskProgress[tid] || msg.ts > taskProgress[tid].ts)) {
77+
taskProgress[tid] = { phase: msg.data.phase, pct: msg.data.progress_pct, ts: msg.ts }
78+
}
79+
}
80+
```
81+
82+
Include in status output:
83+
- Per-worker latest milestone (phase + progress_pct) next to task status
84+
- Active blockers section (if any blockerMsgs found)
85+
6086
Output (single mode):
6187
```
6288
[coordinator] Pipeline Status
@@ -104,6 +130,12 @@ Find ready tasks, spawn workers, STOP.
104130
requirement: <task-description>
105131
inner_loop: <true|false>
106132
133+
## Progress Milestones
134+
session_id: <session-id>
135+
Report progress via team_msg at natural phase boundaries (context loaded -> core work done -> verification).
136+
Report blockers immediately via team_msg type="blocker".
137+
Report completion via team_msg type="task_complete" after final SendMessage.
138+
107139
Read role_spec file to load Phase 2-4 domain instructions.
108140
Execute built-in Phase 1 (task discovery) -> role Phase 2-4 -> built-in Phase 5 (report).`
109141
})

.claude/skills/team-brainstorm/SKILL.md

Lines changed: 13 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
name: team-brainstorm
33
description: Unified team skill for brainstorming team. Uses team-worker agent architecture with role directories for domain logic. Coordinator orchestrates pipeline, workers are team-worker agents. Triggers on "team brainstorm".
4-
allowed-tools: TeamCreate(*), TeamDelete(*), SendMessage(*), TaskCreate(*), TaskUpdate(*), TaskList(*), TaskGet(*), Agent(*), AskUserQuestion(*), Read(*), Write(*), Edit(*), Bash(*), Glob(*), Grep(*)
4+
allowed-tools: TeamCreate(*), TeamDelete(*), SendMessage(*), TaskCreate(*), TaskUpdate(*), TaskList(*), TaskGet(*), Agent(*), AskUserQuestion(*), Read(*), Write(*), Edit(*), Bash(*), Glob(*), Grep(*), mcp__ccw-tools__team_msg(*)
55
---
66

77
# Team Brainstorm
@@ -72,6 +72,12 @@ team_name: brainstorm
7272
requirement: <topic-description>
7373
inner_loop: false
7474
75+
## Progress Milestones
76+
session_id: <session-id>
77+
Report progress via team_msg at natural phase boundaries (context loaded -> core work done -> verification).
78+
Report blockers immediately via team_msg type="blocker".
79+
Report completion via team_msg type="task_complete" after final SendMessage.
80+
7581
Read role_spec file (@<skill_root>/roles/<role>/role.md) to load Phase 2-4 domain instructions.
7682
Execute built-in Phase 1 (task discovery) -> role Phase 2-4 -> built-in Phase 5 (report).`
7783
})
@@ -97,6 +103,12 @@ requirement: <topic-description>
97103
agent_name: ideator-<N>
98104
inner_loop: false
99105
106+
## Progress Milestones
107+
session_id: <session-id>
108+
Report progress via team_msg at natural phase boundaries (context loaded -> core work done -> verification).
109+
Report blockers immediately via team_msg type="blocker".
110+
Report completion via team_msg type="task_complete" after final SendMessage.
111+
100112
Read role_spec file (@<skill_root>/roles/ideator/role.md) to load Phase 2-4 domain instructions.
101113
Execute built-in Phase 1 (task discovery, owner=ideator-<N>) -> role Phase 2-4 -> built-in Phase 5 (report).`
102114
})

.claude/skills/team-brainstorm/roles/coordinator/commands/monitor.md

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -57,6 +57,32 @@ Worker completed. Process and advance.
5757

5858
Read-only status report, then STOP.
5959

60+
**Worker Progress** (from message bus):
61+
62+
Before generating status output, read worker milestones:
63+
64+
```javascript
65+
const progressMsgs = mcp__ccw-tools__team_msg({
66+
operation: "list", session_id: sessionId, type: "progress", last: 50
67+
})
68+
const blockerMsgs = mcp__ccw-tools__team_msg({
69+
operation: "list", session_id: sessionId, type: "blocker", last: 10
70+
})
71+
72+
// Aggregate latest milestone per task
73+
const taskProgress = {}
74+
for (const msg of (progressMsgs.result?.messages || [])) {
75+
const tid = msg.data?.task_id
76+
if (tid && (!taskProgress[tid] || msg.ts > taskProgress[tid].ts)) {
77+
taskProgress[tid] = { phase: msg.data.phase, pct: msg.data.progress_pct, ts: msg.ts }
78+
}
79+
}
80+
```
81+
82+
Include in status output:
83+
- Per-worker latest milestone (phase + progress_pct) next to task status
84+
- Active blockers section (if any blockerMsgs found)
85+
6086
```
6187
[coordinator] Pipeline Status (<pipeline-mode>)
6288
[coordinator] Progress: <done>/<total> (<pct>%)
@@ -98,6 +124,12 @@ Find ready tasks, spawn workers, STOP.
98124
requirement: <task-description>
99125
inner_loop: false
100126
127+
## Progress Milestones
128+
session_id: <session-id>
129+
Report progress via team_msg at natural phase boundaries (context loaded -> core work done -> verification).
130+
Report blockers immediately via team_msg type="blocker".
131+
Report completion via team_msg type="task_complete" after final SendMessage.
132+
101133
Read role_spec file to load Phase 2-4 domain instructions.
102134
Execute built-in Phase 1 (task discovery) -> role Phase 2-4 -> built-in Phase 5 (report).`
103135
})

.claude/skills/team-coordinate/SKILL.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
name: team-coordinate
33
description: Universal team coordination skill with dynamic role generation. Uses team-worker agent architecture with role-spec files. Only coordinator is built-in -- all worker roles are generated at runtime as role-specs and spawned via team-worker agent. Beat/cadence model for orchestration. Triggers on "Team Coordinate ".
4-
allowed-tools: TeamCreate(*), TeamDelete(*), SendMessage(*), TaskCreate(*), TaskUpdate(*), TaskList(*), TaskGet(*), Agent(*), AskUserQuestion(*), Read(*), Write(*), Edit(*), Bash(*), Glob(*), Grep(*)
4+
allowed-tools: TeamCreate(*), TeamDelete(*), SendMessage(*), TaskCreate(*), TaskUpdate(*), TaskList(*), TaskGet(*), Agent(*), AskUserQuestion(*), Read(*), Write(*), Edit(*), Bash(*), Glob(*), Grep(*), mcp__ccw-tools__team_msg(*)
55
---
66

77
# Team Coordinate
@@ -125,6 +125,12 @@ team_name: <team-name>
125125
requirement: <task-description>
126126
inner_loop: <true|false>
127127
128+
## Progress Milestones
129+
session_id: <session-id>
130+
Report progress via team_msg at natural phase boundaries (context loaded -> core work done -> verification).
131+
Report blockers immediately via team_msg type="blocker".
132+
Report completion via team_msg type="task_complete" after final SendMessage.
133+
128134
Read role_spec file to load Phase 2-4 domain instructions.
129135
Execute built-in Phase 1 (task discovery) -> role-spec Phase 2-4 -> built-in Phase 5 (report).`
130136
})

.claude/skills/team-coordinate/roles/coordinator/commands/monitor.md

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -89,6 +89,32 @@ Receive callback from [<role>]
8989

9090
Read-only status report. No pipeline advancement.
9191

92+
**Worker Progress** (from message bus):
93+
94+
Before generating status output, read worker milestones:
95+
96+
```javascript
97+
const progressMsgs = mcp__ccw-tools__team_msg({
98+
operation: "list", session_id: sessionId, type: "progress", last: 50
99+
})
100+
const blockerMsgs = mcp__ccw-tools__team_msg({
101+
operation: "list", session_id: sessionId, type: "blocker", last: 10
102+
})
103+
104+
// Aggregate latest milestone per task
105+
const taskProgress = {}
106+
for (const msg of (progressMsgs.result?.messages || [])) {
107+
const tid = msg.data?.task_id
108+
if (tid && (!taskProgress[tid] || msg.ts > taskProgress[tid].ts)) {
109+
taskProgress[tid] = { phase: msg.data.phase, pct: msg.data.progress_pct, ts: msg.ts }
110+
}
111+
}
112+
```
113+
114+
Include in status output:
115+
- Per-worker latest milestone (phase + progress_pct) next to task status
116+
- Active blockers section (if any blockerMsgs found)
117+
92118
**Output format**:
93119
94120
```
@@ -173,6 +199,12 @@ team_name: <team-name>
173199
requirement: <task-description>
174200
inner_loop: <true|false>
175201
202+
## Progress Milestones
203+
session_id: <session-id>
204+
Report progress via team_msg at natural phase boundaries (context loaded -> core work done -> verification).
205+
Report blockers immediately via team_msg type="blocker".
206+
Report completion via team_msg type="task_complete" after final SendMessage.
207+
176208
Read role_spec file to load Phase 2-4 domain instructions.`
177209
})
178210
```

.claude/skills/team-designer/SKILL.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
name: team-designer
33
description: Meta-skill for generating team skills following the v4 architecture pattern. Produces complete skill packages with SKILL.md router, coordinator, worker roles, specs, and templates. Triggers on "team-designer", "design team".
4-
allowed-tools: Agent(*), AskUserQuestion(*), Read(*), Write(*), Edit(*), Bash(*), Glob(*), Grep(*)
4+
allowed-tools: Agent(*), AskUserQuestion(*), Read(*), Write(*), Edit(*), Bash(*), Glob(*), Grep(*), mcp__ccw-tools__team_msg(*)
55
---
66

77
# Team Skill Designer

.claude/skills/team-executor/SKILL.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
name: team-executor
33
description: Lightweight session execution skill. Resumes existing team-coordinate sessions for pure execution via team-worker agents. No analysis, no role generation -- only loads and executes. Session path required. Triggers on "Team Executor".
4-
allowed-tools: TeamCreate(*), TeamDelete(*), SendMessage(*), TaskCreate(*), TaskUpdate(*), TaskList(*), TaskGet(*), Agent(*), AskUserQuestion(*), Read(*), Write(*), Edit(*), Bash(*), Glob(*), Grep(*)
4+
allowed-tools: TeamCreate(*), TeamDelete(*), SendMessage(*), TaskCreate(*), TaskUpdate(*), TaskList(*), TaskGet(*), Agent(*), AskUserQuestion(*), Read(*), Write(*), Edit(*), Bash(*), Glob(*), Grep(*), mcp__ccw-tools__team_msg(*)
55
---
66

77
# Team Executor
@@ -122,6 +122,12 @@ team_name: <team-name>
122122
requirement: <task-description>
123123
inner_loop: <true|false>
124124
125+
## Progress Milestones
126+
session_id: <session-id>
127+
Report progress via team_msg at natural phase boundaries (context loaded -> core work done -> verification).
128+
Report blockers immediately via team_msg type="blocker".
129+
Report completion via team_msg type="task_complete" after final SendMessage.
130+
125131
Read role_spec file to load Phase 2-4 domain instructions.`
126132
})
127133
```

.claude/skills/team-frontend-debug/SKILL.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
name: team-frontend-debug
33
description: Frontend debugging team using Chrome DevTools MCP. Dual-mode — feature-list testing or bug-report debugging. Triggers on "team-frontend-debug", "frontend debug".
4-
allowed-tools: TeamCreate(*), TeamDelete(*), SendMessage(*), TaskCreate(*), TaskUpdate(*), TaskList(*), TaskGet(*), Agent(*), AskUserQuestion(*), Read(*), Write(*), Edit(*), Bash(*), Glob(*), Grep(*), mcp__chrome-devtools__*(*)
4+
allowed-tools: TeamCreate(*), TeamDelete(*), SendMessage(*), TaskCreate(*), TaskUpdate(*), TaskList(*), TaskGet(*), Agent(*), AskUserQuestion(*), Read(*), Write(*), Edit(*), Bash(*), Glob(*), Grep(*), mcp__ccw-tools__team_msg(*), mcp__chrome-devtools__*(*)
55
---
66

77
# Frontend Debug Team
@@ -120,6 +120,12 @@ team_name: <team-name>
120120
requirement: <task-description>
121121
inner_loop: <true|false>
122122
123+
## Progress Milestones
124+
session_id: <session-id>
125+
Report progress via team_msg at natural phase boundaries (context loaded -> core work done -> verification).
126+
Report blockers immediately via team_msg type="blocker".
127+
Report completion via team_msg type="task_complete" after final SendMessage.
128+
123129
Read role_spec file (@<skill_root>/roles/<role>/role.md) to load Phase 2-4 domain instructions.
124130
Execute built-in Phase 1 (task discovery) -> role Phase 2-4 -> built-in Phase 5 (report).`
125131
})

.claude/skills/team-frontend-debug/roles/coordinator/commands/monitor.md

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -55,6 +55,32 @@ Analyzer needs more evidence. Create supplemental reproduction task.
5555

5656
Read-only status report, then STOP.
5757

58+
**Worker Progress** (from message bus):
59+
60+
Before generating status output, read worker milestones:
61+
62+
```javascript
63+
const progressMsgs = mcp__ccw-tools__team_msg({
64+
operation: "list", session_id: sessionId, type: "progress", last: 50
65+
})
66+
const blockerMsgs = mcp__ccw-tools__team_msg({
67+
operation: "list", session_id: sessionId, type: "blocker", last: 10
68+
})
69+
70+
// Aggregate latest milestone per task
71+
const taskProgress = {}
72+
for (const msg of (progressMsgs.result?.messages || [])) {
73+
const tid = msg.data?.task_id
74+
if (tid && (!taskProgress[tid] || msg.ts > taskProgress[tid].ts)) {
75+
taskProgress[tid] = { phase: msg.data.phase, pct: msg.data.progress_pct, ts: msg.ts }
76+
}
77+
}
78+
```
79+
80+
Include in status output:
81+
- Per-worker latest milestone (phase + progress_pct) next to task status
82+
- Active blockers section (if any blockerMsgs found)
83+
5884
Output:
5985
```
6086
[coordinator] Debug Pipeline Status

0 commit comments

Comments
 (0)