feat: Add coordinator commands and role specifications for UI design team

- Implemented the 'monitor' command for coordinator role to handle monitoring events, task completion, and pipeline management. - Created role specifications for the coordinator, detailing responsibilities, command execution protocols, and session management. - Added role specifications for the analyst, discussant, explorer, and synthesizer in the ultra-analyze skill, defining their context loading, analysis, and synthesis processes.
2026-03-05 16:13:08 +08:00 · 2026-03-03 23:35:41 +08:00
parent a7ed0365f7
commit 26bda9c634
188 changed files with 9332 additions and 3512 deletions
--- a/.claude/skills/team-roadmap-dev/SKILL.md
+++ b/.claude/skills/team-roadmap-dev/SKILL.md
@@ -159,9 +159,10 @@ Every worker executes the same task discovery flow on startup:
 Standard reporting flow after task completion:

 1. **Message Bus**: Call `mcp__ccw-tools__team_msg` to log message
-   - Parameters: operation="log", team="roadmap-dev", from=<role>, to="coordinator", type=<message-type>, summary="[<role>] <summary>", ref=<artifact-path>
-   - **CLI fallback**: When MCP unavailable → `ccw team log --team roadmap-dev --from <role> --to coordinator --type <type> --summary "[<role>] ..." --json`
-2. **SendMessage**: Send result to coordinator (content and summary both prefixed with `[<role>]`)
+   - Parameters: operation="log", session_id=<session-id>, from=<role>, type=<message-type>, data={ref: "<artifact-path>"}
+   - `to` and `summary` auto-defaulted -- do NOT specify explicitly
+   - **CLI fallback**: `ccw team log --session-id <session-id> --from <role> --type <type> --json`
+2. **SendMessage**: Send result to coordinator
 3. **TaskUpdate**: Mark task completed
 4. **Loop**: Return to Phase 1 to check next task

@@ -362,7 +363,9 @@ Session: <session-folder>
 │   └── verification.md
 ├── phase-2/
 │   └── ...
-└── shared-memory.json         # Cross-role state
+├── .msg/
+│   ├── messages.jsonl              # Team message bus log
+│   └── meta.json                   # Session metadata + shared state
 ```

 ## Session Resume
--- a/.claude/skills/team-roadmap-dev/role-specs/executor.md
+++ b/.claude/skills/team-roadmap-dev/role-specs/executor.md
@@ -0,0 +1,60 @@
+---
+prefix: EXEC
+inner_loop: true
+subagents:
+  - code-developer
+message_types:
+  success: exec_complete
+  progress: exec_progress
+  error: error
+---
+
+# Executor
+
+Wave-based code implementation per phase. Reads IMPL-*.json task files, computes execution waves from the dependency graph, delegates each task to code-developer subagent. Produces summary-{IMPL-ID}.md per task.
+
+## Phase 2: Context Loading
+
+| Input | Source | Required |
+|-------|--------|----------|
+| Task JSONs | <session>/phase-{N}/.task/IMPL-*.json | Yes |
+| Prior summaries | <session>/phase-{1..N-1}/summary-*.md | No |
+| Wisdom | <session>/wisdom/ | No |
+
+1. Glob `<session>/phase-{N}/.task/IMPL-*.json`, error if none found
+2. Parse each task JSON: extract id, description, depends_on, files, convergence, implementation
+3. Compute execution waves from dependency graph:
+   - Wave 1: tasks with no dependencies
+   - Wave N: tasks whose all deps are in waves 1..N-1
+   - Force-assign if circular (break at lowest-numbered task)
+4. Load prior phase summaries for cross-task context
+
+## Phase 3: Wave-Based Implementation
+
+Execute waves sequentially, tasks within each wave can be parallel.
+
+**Strategy selection**:
+
+| Task Count | Strategy |
+|------------|----------|
+| <= 2 | Direct: inline Edit/Write |
+| 3-5 | Single code-developer for all |
+| > 5 | Batch: one code-developer per module group |
+
+**Per task**:
+1. Build prompt from task JSON: description, files, implementation steps, convergence criteria
+2. Include prior summaries and wisdom as context
+3. Delegate to code-developer subagent (`run_in_background: false`)
+4. Write `<session>/phase-{N}/summary-{IMPL-ID}.md` with: task ID, affected files, changes made, status
+
+**Between waves**: report wave progress via team_msg (type: exec_progress)
+
+## Phase 4: Self-Validation
+
+| Check | Method | Pass Criteria |
+|-------|--------|---------------|
+| Affected files exist | `test -f <path>` for each file in summary | All present |
+| TypeScript syntax | `npx tsc --noEmit` (if tsconfig.json exists) | No errors |
+| Lint | `npm run lint` (best-effort) | No critical errors |
+
+Log errors via team_msg but do NOT fix — verifier handles gap detection.
--- a/.claude/skills/team-roadmap-dev/role-specs/planner.md
+++ b/.claude/skills/team-roadmap-dev/role-specs/planner.md
@@ -0,0 +1,60 @@
+---
+prefix: PLAN
+inner_loop: true
+subagents:
+  - cli-explore-agent
+  - action-planning-agent
+message_types:
+  success: plan_ready
+  progress: plan_progress
+  error: error
+---
+
+# Planner
+
+Research and plan creation per roadmap phase. Gathers codebase context via cli-explore-agent, then generates wave-based execution plans with convergence criteria via action-planning-agent.
+
+## Phase 2: Context Loading + Research
+
+| Input | Source | Required |
+|-------|--------|----------|
+| roadmap.md | <session>/roadmap.md | Yes |
+| config.json | <session>/config.json | Yes |
+| Prior summaries | <session>/phase-{1..N-1}/summary-*.md | No |
+| Wisdom | <session>/wisdom/ | No |
+
+1. Read roadmap.md, extract phase goal, requirements (REQ-IDs), success criteria
+2. Read config.json for depth setting (quick/standard/comprehensive)
+3. Load prior phase summaries for dependency context
+4. Detect gap closure mode (task description contains "Gap closure")
+5. Launch cli-explore-agent with phase requirements as exploration query:
+   - Target: files needing modification, patterns, dependencies, test infrastructure, risks
+6. If depth=comprehensive: run Gemini CLI analysis (`--mode analysis --rule analysis-analyze-code-patterns`)
+7. Write `<session>/phase-{N}/context.md` combining roadmap requirements + exploration results
+
+## Phase 3: Plan Creation
+
+1. Load context.md from Phase 2
+2. Create output directory: `<session>/phase-{N}/.task/`
+3. Delegate to action-planning-agent with:
+   - Phase context + roadmap section + prior summaries
+   - Task ID format: `IMPL-{phase}{seq}` (e.g., IMPL-101, IMPL-102)
+   - Convergence criteria rules: measurable, goal-backward, includes file existence + export checks + test checks
+   - Hard limits: <= 10 tasks per phase, valid DAG, no cycles
+4. Agent produces: `IMPL_PLAN.md`, `.task/IMPL-*.json`, `TODO_LIST.md`
+5. If gap closure: only create tasks for gaps, starting from next available ID
+
+## Phase 4: Self-Validation
+
+| Check | Pass Criteria | Action on Failure |
+|-------|---------------|-------------------|
+| Task JSON files exist | >= 1 IMPL-*.json found | Error to coordinator |
+| Required fields | id, title, description, files, implementation, convergence | Log warning |
+| Convergence criteria | Each task has >= 1 criterion | Log warning |
+| No self-dependency | task.id not in task.depends_on | Log error, remove cycle |
+| All deps valid | Every depends_on ID exists | Log warning |
+| IMPL_PLAN.md exists | File present | Generate minimal version from task JSONs |
+
+After validation, compute wave structure from dependency graph for reporting:
+- Wave count = topological layers of DAG
+- Report: task count, wave count, file list
--- a/.claude/skills/team-roadmap-dev/role-specs/verifier.md
+++ b/.claude/skills/team-roadmap-dev/role-specs/verifier.md
@@ -0,0 +1,72 @@
+---
+prefix: VERIFY
+inner_loop: true
+subagents: []
+message_types:
+  success: verify_passed
+  failure: gaps_found
+  error: error
+---
+
+# Verifier
+
+Goal-backward verification per phase. Reads convergence criteria from IMPL-*.json task files and checks against actual codebase state. Read-only — never modifies code. Produces verification.md with pass/fail and structured gap lists.
+
+## Phase 2: Context Loading
+
+| Input | Source | Required |
+|-------|--------|----------|
+| Task JSONs | <session>/phase-{N}/.task/IMPL-*.json | Yes |
+| Summaries | <session>/phase-{N}/summary-*.md | Yes |
+| Wisdom | <session>/wisdom/ | No |
+
+1. Glob IMPL-*.json files, extract convergence criteria from each task
+2. Glob summary-*.md files, parse frontmatter (task, affects, provides)
+3. If no task JSONs or summaries found → error to coordinator
+
+## Phase 3: Goal-Backward Verification
+
+For each task's convergence criteria, execute appropriate check:
+
+| Criteria Type | Method |
+|---------------|--------|
+| File existence | `test -f <path>` |
+| Command execution | Run command, check exit code |
+| Pattern match | Grep for pattern in specified files |
+| Semantic check | Optional: Gemini CLI (`--mode analysis --rule analysis-review-code-quality`) |
+
+**Per task scoring**:
+
+| Result | Condition |
+|--------|-----------|
+| pass | All criteria met |
+| partial | Some criteria met |
+| fail | No criteria met or critical check failed |
+
+Collect all gaps from partial/failed tasks with structured format:
+- task ID, criteria type, expected value, actual value
+
+## Phase 4: Compile Results
+
+1. Aggregate per-task results: count passed, partial, failed
+2. Determine overall status:
+   - `passed` if gaps.length === 0
+   - `gaps_found` otherwise
+3. Write `<session>/phase-{N}/verification.md`:
+
+```yaml
+---
+phase: <N>
+status: passed | gaps_found
+tasks_checked: <count>
+tasks_passed: <count>
+gaps:
+  - task: "<task-id>"
+    type: "<criteria-type>"
+    item: "<description>"
+    expected: "<expected>"
+    actual: "<actual>"
+---
+```
+
+4. Update .msg/meta.json with verification summary
--- a/.claude/skills/team-roadmap-dev/roles/coordinator/commands/dispatch.md
+++ b/.claude/skills/team-roadmap-dev/roles/coordinator/commands/dispatch.md
@@ -147,10 +147,9 @@ Edit(`${sessionFolder}/state.md`, {

 ```javascript
 mcp__ccw-tools__team_msg({
-  operation: "log", team: sessionId,  // MUST be session ID (e.g., RD-xxx-date), NOT team name
+  operation: "log", session_id: sessionId,
  from: "coordinator", to: "all",
  type: "phase_started",
-  summary: `[coordinator] Phase ${phaseNumber} dispatched: PLAN-${phaseNumber}01 → EXEC-${phaseNumber}01 → VERIFY-${phaseNumber}01`,
  ref: `${sessionFolder}/roadmap.md`
 })
 ```
--- a/.claude/skills/team-roadmap-dev/roles/coordinator/commands/monitor.md
+++ b/.claude/skills/team-roadmap-dev/roles/coordinator/commands/monitor.md
@@ -171,26 +171,25 @@ function spawnPlanner(phase, gapIteration, sessionFolder) {

  // Synchronous call - blocks until planner returns
  Task({
-    subagent_type: "general-purpose",
+    subagent_type: "team-worker",
    description: `Spawn planner worker for phase ${phase}`,
    team_name: "roadmap-dev",
    name: "planner",
-    prompt: `You are the PLANNER for team "roadmap-dev".
+    prompt: `## Role Assignment
+role: planner
+role_spec: .claude/skills/team-roadmap-dev/role-specs/planner.md
+session: ${sessionFolder}
+session_id: ${sessionId}
+team_name: roadmap-dev
+requirement: Phase ${phase} planning${gapContext}
+inner_loop: false

-## Primary Directive
-Skill(skill="team-roadmap-dev", args="--role=planner")
-
-## Assignment
- Session: ${sessionFolder}
+## Current Task
+- Task: PLAN-${phase}${suffix}
 - Phase: ${phase}
- Task: PLAN-${phase}${suffix}${gapContext}

-## Workflow
-1. Skill(skill="team-roadmap-dev", args="--role=planner")
-2. TaskList → find PLAN-${phase}${suffix} → execute
-3. TaskUpdate completed when done
-
-All outputs carry [planner] tag.`,
+Read role_spec file to load Phase 2-4 domain instructions.
+Execute built-in Phase 1 -> role-spec Phase 2-4 -> built-in Phase 5.`,
    run_in_background: false  // CRITICAL: Stop-Wait, blocks until done
  })
 }
@@ -203,26 +202,25 @@ function spawnExecutor(phase, gapIteration, sessionFolder) {
  const suffix = gapIteration === 0 ? "01" : `0${gapIteration + 1}`

  Task({
-    subagent_type: "general-purpose",
+    subagent_type: "team-worker",
    description: `Spawn executor worker for phase ${phase}`,
    team_name: "roadmap-dev",
    name: "executor",
-    prompt: `You are the EXECUTOR for team "roadmap-dev".
+    prompt: `## Role Assignment
+role: executor
+role_spec: .claude/skills/team-roadmap-dev/role-specs/executor.md
+session: ${sessionFolder}
+session_id: ${sessionId}
+team_name: roadmap-dev
+requirement: Phase ${phase} execution
+inner_loop: false

-## Primary Directive
-Skill(skill="team-roadmap-dev", args="--role=executor")
-
-## Assignment
- Session: ${sessionFolder}
- Phase: ${phase}
+## Current Task
 - Task: EXEC-${phase}${suffix}
+- Phase: ${phase}

-## Workflow
-1. Skill(skill="team-roadmap-dev", args="--role=executor")
-2. TaskList → find EXEC-${phase}${suffix} → execute plans
-3. TaskUpdate completed when done
-
-All outputs carry [executor] tag.`,
+Read role_spec file to load Phase 2-4 domain instructions.
+Execute built-in Phase 1 -> role-spec Phase 2-4 -> built-in Phase 5.`,
    run_in_background: false  // CRITICAL: Stop-Wait
  })
 }
@@ -235,26 +233,25 @@ function spawnVerifier(phase, gapIteration, sessionFolder) {
  const suffix = gapIteration === 0 ? "01" : `0${gapIteration + 1}`

  Task({
-    subagent_type: "general-purpose",
+    subagent_type: "team-worker",
    description: `Spawn verifier worker for phase ${phase}`,
    team_name: "roadmap-dev",
    name: "verifier",
-    prompt: `You are the VERIFIER for team "roadmap-dev".
+    prompt: `## Role Assignment
+role: verifier
+role_spec: .claude/skills/team-roadmap-dev/role-specs/verifier.md
+session: ${sessionFolder}
+session_id: ${sessionId}
+team_name: roadmap-dev
+requirement: Phase ${phase} verification
+inner_loop: false

-## Primary Directive
-Skill(skill="team-roadmap-dev", args="--role=verifier")
-
-## Assignment
- Session: ${sessionFolder}
- Phase: ${phase}
+## Current Task
 - Task: VERIFY-${phase}${suffix}
+- Phase: ${phase}

-## Workflow
-1. Skill(skill="team-roadmap-dev", args="--role=verifier")
-2. TaskList → find VERIFY-${phase}${suffix} → verify against success criteria
-3. TaskUpdate completed when done
-
-All outputs carry [verifier] tag.`,
+Read role_spec file to load Phase 2-4 domain instructions.
+Execute built-in Phase 1 -> role-spec Phase 2-4 -> built-in Phase 5.`,
    run_in_background: false  // CRITICAL: Stop-Wait
  })
 }
@@ -271,7 +268,6 @@ function triggerGapClosure(phase, iteration, gaps, sessionFolder) {
    operation: "log", team: sessionId  // MUST be session ID (e.g., RD-xxx-date), NOT team name,
    from: "coordinator", to: "planner",
    type: "gap_closure",
-    summary: `[coordinator] Gap closure iteration ${iteration} for phase ${phase}: ${gaps.length} gaps`,
    ref: `${sessionFolder}/phase-${phase}/verification.md`
  })

@@ -337,7 +333,6 @@ mcp__ccw-tools__team_msg({
  operation: "log", team: sessionId  // MUST be session ID (e.g., RD-xxx-date), NOT team name,
  from: "coordinator", to: "all",
  type: "project_complete",
-  summary: `[coordinator] All ${totalPhases} phases complete.`,
  ref: `${sessionFolder}/roadmap.md`
 })
 ```
--- a/.claude/skills/team-roadmap-dev/roles/coordinator/commands/pause.md
+++ b/.claude/skills/team-roadmap-dev/roles/coordinator/commands/pause.md
@@ -55,10 +55,9 @@ Edit(`${sessionFolder}/state.md`, {

 ```javascript
 mcp__ccw-tools__team_msg({
-  operation: "log", team: "roadmap-dev",
+  operation: "log", session_id: sessionId,
  from: "coordinator", to: "all",
  type: "phase_paused",
-  summary: `[coordinator] Session paused at phase ${currentPhase}, step: ${currentStep}`,
  ref: `${sessionFolder}/state.md`
 })
 ```
--- a/.claude/skills/team-roadmap-dev/roles/coordinator/commands/resume.md
+++ b/.claude/skills/team-roadmap-dev/roles/coordinator/commands/resume.md
@@ -67,10 +67,9 @@ Edit(`${sessionFolder}/state.md`, {

 ```javascript
 mcp__ccw-tools__team_msg({
-  operation: "log", team: "roadmap-dev",
+  operation: "log", session_id: sessionId,
  from: "coordinator", to: "all",
  type: "phase_started",
-  summary: `[coordinator] Session resumed at phase ${pausedPhase}, step: ${pausedStep}`,
  ref: `${sessionFolder}/state.md`
 })
 ```
--- a/.claude/skills/team-roadmap-dev/roles/coordinator/role.md
+++ b/.claude/skills/team-roadmap-dev/roles/coordinator/role.md
@@ -37,16 +37,58 @@ Orchestrate the roadmap-driven development workflow: init prerequisites -> roadm

 ---

+## Command Execution Protocol
+
+When coordinator needs to execute a command (dispatch, monitor, pause, resume):
+
+1. **Read the command file**: `roles/coordinator/commands/<command-name>.md`
+2. **Follow the workflow** defined in the command file (Phase 2-4 structure)
+3. **Commands are inline execution guides** -- NOT separate agents or subprocesses
+4. **Execute synchronously** -- complete the command workflow before proceeding
+
+Example:
+```
+Phase 3 needs task dispatch
+  -> Read roles/coordinator/commands/dispatch.md
+  -> Execute Phase 2 (Context Loading)
+  -> Execute Phase 3 (Task Chain Creation)
+  -> Execute Phase 4 (Validation)
+  -> Continue to Phase 4
+```
+
+---
+
 ## Entry Router

-When coordinator is invoked, first detect the invocation type:
+When coordinator is invoked, detect invocation type:

 | Detection | Condition | Handler |
 |-----------|-----------|---------|
+| Worker callback | Message contains role tag [planner], [executor], [verifier] | -> handleCallback |
 | Resume mode | Arguments contain `--resume` | -> commands/resume.md: load session, re-enter monitor |
-| Status check | Arguments contain "check" or "status" | -> handleCheck: output execution graph, no advancement |
-| Manual continue | Arguments contain "resume" or "continue" | -> handleContinue: check worker states, advance pipeline |
-| New session | None of the above | -> Phase 1 (Init Prerequisites) |
+| Status check | Arguments contain "check" or "status" | -> handleCheck |
+| Manual resume | Arguments contain "resume" or "continue" | -> handleResume |
+| Pipeline complete | All tasks have status "completed" | -> handleComplete |
+| Interrupted session | Active/paused session exists | -> Phase 0 (Session Resume Check) |
+| New session | None of above | -> Phase 1 (Init Prerequisites) |
+
+For callback/check/resume/complete: load `commands/monitor.md` and execute matched handler, then STOP.
+
+### Router Implementation
+
+1. **Load session context** (if exists):
+   - Scan `.workflow/.team/RD-*/.msg/meta.json` for active/paused sessions
+   - If found, extract session folder path, status, and pipeline mode
+
+2. **Parse $ARGUMENTS** for detection keywords:
+   - Check for role name tags in message content
+   - Check for "check", "status", "resume", "continue", "--resume" keywords
+
+3. **Route to handler**:
+   - For monitor handlers: Read `commands/monitor.md`, execute matched handler, STOP
+   - For --resume: Read `commands/resume.md`, execute resume flow
+   - For Phase 0: Execute Session Resume Check
+   - For Phase 1: Execute Init Prerequisites below

 ---

@@ -92,11 +134,10 @@ Before every SendMessage, log via `mcp__ccw-tools__team_msg`:
 ```
 mcp__ccw-tools__team_msg({
  operation: "log",
-  team: <session-id>,  // MUST be session ID (e.g., RD-xxx-date), NOT team name. Extract from Session: field in task description.
+  session_id: <session-id>,
  from: "coordinator",
  to: <target-role>,
  type: <message-type>,
-  summary: "[coordinator] <summary>",
  ref: <artifact-path>
 })
 ```
@@ -104,7 +145,7 @@ mcp__ccw-tools__team_msg({
 **CLI fallback** (when MCP unavailable):

 ```
-Bash("ccw team log --team <session-id> --from coordinator --to <target> --type <type> --summary \"[coordinator] <summary>\" --json")
+Bash("ccw team log --session-id <session-id> --from coordinator --type <type> --json")
 ```

 ---
--- a/.claude/skills/team-roadmap-dev/roles/executor/commands/implement.md
+++ b/.claude/skills/team-roadmap-dev/roles/executor/commands/implement.md
@@ -203,10 +203,9 @@ ${(task.convergence?.criteria || []).map(c => `- [ ] ${c}`).join('\n')}

  // 2e. Report wave progress
  mcp__ccw-tools__team_msg({
-    operation: "log", team: "roadmap-dev",
-    from: "executor", to: "coordinator",
+    operation: "log", session_id: sessionId,
+    from: "executor",
    type: "exec_progress",
-    summary: `[executor] Wave ${waveNum}/${totalWaves} complete (${completedTasks}/${totalTasks} tasks done)`,
    ref: `${sessionFolder}/phase-${phaseNumber}/`
  })
 }
@@ -216,10 +215,9 @@ ${(task.convergence?.criteria || []).map(c => `- [ ] ${c}`).join('\n')}

 ```javascript
 mcp__ccw-tools__team_msg({
-  operation: "log", team: "roadmap-dev",
-  from: "executor", to: "coordinator",
+  operation: "log", session_id: sessionId,
+  from: "executor",
  type: "exec_complete",
-  summary: `[executor] All ${totalTasks} tasks executed across ${totalWaves} waves for phase ${phaseNumber}`,
  ref: `${sessionFolder}/phase-${phaseNumber}/`
 })
 ```
--- a/.claude/skills/team-roadmap-dev/roles/executor/role.md
+++ b/.claude/skills/team-roadmap-dev/roles/executor/role.md
@@ -69,11 +69,9 @@ Before every SendMessage, log via `mcp__ccw-tools__team_msg`:
 ```
 mcp__ccw-tools__team_msg({
  operation: "log",
-  team: <session-id>,  // MUST be session ID (e.g., RD-xxx-date), NOT team name. Extract from Session: field in task description.
+  session_id: <session-id>,
  from: "executor",
-  to: "coordinator",
  type: <message-type>,
-  summary: "[executor] <task-prefix> complete: <task-subject>",
  ref: <artifact-path>
 })
 ```
@@ -81,7 +79,7 @@ mcp__ccw-tools__team_msg({
 **CLI fallback** (when MCP unavailable):

 ```
-Bash("ccw team log --team <session-id> --from executor --to coordinator --type <type> --summary \"[executor] <summary>\" --ref <artifact-path> --json")
+Bash("ccw team log --session-id <session-id> --from executor --type <type> --ref <artifact-path> --json")
 ```

 ---
@@ -192,7 +190,6 @@ Standard report flow: team_msg log -> SendMessage with `[executor]` prefix -> Ta
 **Report message**:
 ```
 SendMessage({
-  to: "coordinator",
  message: "[executor] Phase <N> execution complete.
 - Tasks executed: <count>
 - Waves: <wave-count>
--- a/.claude/skills/team-roadmap-dev/roles/planner/commands/create-plans.md
+++ b/.claude/skills/team-roadmap-dev/roles/planner/commands/create-plans.md
@@ -168,10 +168,9 @@ Each task: cli_execution.id = "RD-${sessionFolder.split('/').pop()}-{task_id}"
 const taskFiles = Glob(`${taskDir}/IMPL-*.json`)
 if (!taskFiles || taskFiles.length === 0) {
  mcp__ccw-tools__team_msg({
-    operation: "log", team: "roadmap-dev",
-    from: "planner", to: "coordinator",
+    operation: "log", session_id: sessionId,
+    from: "planner",
    type: "error",
-    summary: `[planner] action-planning-agent produced no task JSONs for phase ${phaseNumber}`
  })
  return
 }
@@ -185,10 +184,9 @@ for (const taskFile of taskFiles) {
  for (const field of requiredFields) {
    if (!taskJson[field]) {
      mcp__ccw-tools__team_msg({
-        operation: "log", team: "roadmap-dev",
-        from: "planner", to: "coordinator",
+        operation: "log", session_id: sessionId,
+        from: "planner",
        type: "plan_progress",
-        summary: `[planner] Warning: ${taskFile} missing field: ${field}`
      })
    }
  }
@@ -196,20 +194,18 @@ for (const taskFile of taskFiles) {
  // Convergence criteria check
  if (!taskJson.convergence?.criteria || taskJson.convergence.criteria.length === 0) {
    mcp__ccw-tools__team_msg({
-      operation: "log", team: "roadmap-dev",
-      from: "planner", to: "coordinator",
+      operation: "log", session_id: sessionId,
+      from: "planner",
      type: "plan_progress",
-      summary: `[planner] Warning: ${taskFile} has no convergence criteria`
    })
  }

  // Dependency cycle check (simple: task cannot depend on itself)
  if (taskJson.depends_on?.includes(taskJson.id)) {
    mcp__ccw-tools__team_msg({
-      operation: "log", team: "roadmap-dev",
-      from: "planner", to: "coordinator",
+      operation: "log", session_id: sessionId,
+      from: "planner",
      type: "error",
-      summary: `[planner] Self-dependency detected in ${taskJson.id}`
    })
  }
 }
@@ -223,10 +219,9 @@ for (const task of allTasks) {
  for (const dep of (task.depends_on || [])) {
    if (!taskIds.has(dep)) {
      mcp__ccw-tools__team_msg({
-        operation: "log", team: "roadmap-dev",
-        from: "planner", to: "coordinator",
+        operation: "log", session_id: sessionId,
+        from: "planner",
        type: "plan_progress",
-        summary: `[planner] Warning: ${task.id} depends on unknown task ${dep}`
      })
    }
  }
@@ -236,10 +231,9 @@ for (const task of allTasks) {
 const implPlanExists = Bash(`test -f "${implPlanPath}" && echo "EXISTS" || echo "NOT_FOUND"`).trim()
 if (implPlanExists === "NOT_FOUND") {
  mcp__ccw-tools__team_msg({
-    operation: "log", team: "roadmap-dev",
-    from: "planner", to: "coordinator",
+    operation: "log", session_id: sessionId,
+    from: "planner",
    type: "plan_progress",
-    summary: `[planner] Warning: IMPL_PLAN.md not generated, creating minimal version`
  })
  // Create minimal IMPL_PLAN.md from task JSONs
  generateMinimalImplPlan(allTasks, implPlanPath, phaseGoal, phaseNumber)
@@ -284,10 +278,9 @@ const { waves, totalWaves } = computeWaves(allTasks)
 const taskCount = allTasks.length

 mcp__ccw-tools__team_msg({
-  operation: "log", team: "roadmap-dev",
-  from: "planner", to: "coordinator",
+  operation: "log", session_id: sessionId,
+  from: "planner",
  type: "plan_progress",
-  summary: `[planner] Created ${taskCount} tasks across ${totalWaves} waves for phase ${phaseNumber}`,
  ref: `${sessionFolder}/phase-${phaseNumber}/`
 })

--- a/.claude/skills/team-roadmap-dev/roles/planner/role.md
+++ b/.claude/skills/team-roadmap-dev/roles/planner/role.md
@@ -71,11 +71,9 @@ Before every SendMessage, log via `mcp__ccw-tools__team_msg`:
 ```
 mcp__ccw-tools__team_msg({
  operation: "log",
-  team: <session-id>,  // MUST be session ID (e.g., RD-xxx-date), NOT team name. Extract from Session: field in task description.
+  session_id: <session-id>,
  from: "planner",
-  to: "coordinator",
  type: <message-type>,
-  summary: "[planner] <task-prefix> complete: <task-subject>",
  ref: <artifact-path>
 })
 ```
@@ -83,7 +81,7 @@ mcp__ccw-tools__team_msg({
 **CLI fallback** (when MCP unavailable):

 ```
-Bash("ccw team log --team <session-id> --from planner --to coordinator --type <type> --summary \"[planner] <summary>\" --ref <artifact-path> --json")
+Bash("ccw team log --session-id <session-id> --from planner --type <type> --ref <artifact-path> --json")
 ```

 ---
@@ -129,10 +127,9 @@ Delegate to `commands/research.md`:
 **Report progress via team_msg**:
 ```
 mcp__ccw-tools__team_msg({
-  operation: "log", team: "roadmap-dev",
-  from: "planner", to: "coordinator",
+  operation: "log", session_id: sessionId,
+  from: "planner",
  type: "plan_progress",
-  summary: "[planner] Research complete for phase <N>. Context written.",
  ref: "<session>/phase-<N>/context.md"
 })
 ```
@@ -211,7 +208,6 @@ Standard report flow: team_msg log -> SendMessage with `[planner]` prefix -> Tas
 **Report message**:
 ```
 SendMessage({
-  to: "coordinator",
  message: "[planner] Phase <N> planning complete.
 - Tasks: <count>
 - Waves: <wave-count>
--- a/.claude/skills/team-roadmap-dev/roles/verifier/role.md
+++ b/.claude/skills/team-roadmap-dev/roles/verifier/role.md
@@ -70,11 +70,9 @@ Before every SendMessage, log via `mcp__ccw-tools__team_msg`:
 ```
 mcp__ccw-tools__team_msg({
  operation: "log",
-  team: <session-id>,  // MUST be session ID (e.g., RD-xxx-date), NOT team name. Extract from Session: field in task description.
+  session_id: <session-id>,
  from: "verifier",
-  to: "coordinator",
  type: <message-type>,
-  summary: "[verifier] <task-prefix> complete: <task-subject>",
  ref: <artifact-path>
 })
 ```
@@ -82,7 +80,7 @@ mcp__ccw-tools__team_msg({
 **CLI fallback** (when MCP unavailable):

 ```
-Bash("ccw team log --team <session-id> --from verifier --to coordinator --type <type> --summary \"[verifier] <summary>\" --ref <artifact-path> --json")
+Bash("ccw team log --session-id <session-id> --from verifier --type <type> --ref <artifact-path> --json")
 ```

 ---
@@ -218,7 +216,6 @@ Standard report flow: team_msg log -> SendMessage with `[verifier]` prefix -> Ta
 **Report message**:
 ```
 SendMessage({
-  to: "coordinator",
  message: "[verifier] Phase <N> verification complete.
 - Status: <status>
 - Tasks: <passed>/<total> passed