Team PlanEx
Unified team skill: plan-and-execute pipeline for issue-based development. Built on
team-worker agent architecture
— coordinator orchestrates, workers are team-worker agents loading role-specific instructions from
roles//role.md
.
Architecture
Skill(skill="team-planex", args="task description")
|
SKILL.md (this file) = Router
|
+--------------+--------------+
| |
no --role flag --role
| |
Coordinator Worker
roles/coordinator/role.md roles//role.md
|
+-- analyze -> dispatch -> spawn workers -> STOP
|
+---------------+---------------+
v v
[planner] [executor]
(team-worker agent, (team-worker agent,
loads roles/planner/role.md) loads roles/executor/role.md)
Role Registry
Role
Path
Prefix
Inner Loop
coordinator
roles/coordinator/role.md
—
—
planner
roles/planner/role.md
PLAN-
true
executor
roles/executor/role.md
EXEC-
true
Role Router
Parse
$ARGUMENTS
:
Has
--role
→ Read
roles//role.md
, execute Phase 2-4
No
--role
→ Read
roles/coordinator/role.md
, execute entry router
Shared Constants
Session prefix
:
PEX
Session path
:
.workflow/.team/PEX--/
CLI tools
:
ccw cli --mode analysis
(read-only),
ccw cli --mode write
(modifications)
Message bus
:
mcp__ccw-tools__team_msg(session_id=, ...)
Worker Spawn Template
Coordinator spawns workers using this template:
Agent({
subagent_type: "team-worker",
description: "Spawn worker",
team_name: "planex",
name: "",
run_in_background: true,
prompt: ## Role Assignment
role: <role>
role_spec: ~ or <project>/.claude/skills/team-planex/roles/<role>/role.md
session: <session-folder>
session_id: <session-id>
team_name: planex
requirement: <task-description>
inner_loop: <true|false>
execution_method: <codex|gemini>
Read role_spec file to load Phase 2-4 domain instructions.
Execute built-in Phase 1 (task discovery) -> role Phase 2-4 -> built-in Phase 5 (report).
})
User Commands
Command
Action
check
/
status
View execution status graph
resume
/
continue
Advance to next step
add
Append new tasks to planner queue
Session Directory
.workflow/.team/PEX--/
├── .msg/
│ ├── messages.jsonl # Message bus log
│ └── meta.json # Session state
├── task-analysis.json # Coordinator analyze output
├── artifacts/
│ └── solutions/ # Planner solution output per issue
│ ├── .json
│ └── .json
└── wisdom/ # Cross-task knowledge
├── learnings.md
├── decisions.md
├── conventions.md
└── issues.md
Specs Reference
specs/pipelines.md
— Pipeline definitions, task metadata registry, execution method selection
Error Handling
Scenario
Resolution
Unknown command
Error with available command list
Role not found
Error with role registry
Role spec file not found
Error with expected path (roles//role.md)
team-worker agent unavailable
Error: requires .claude/agents/team-worker.md
Planner issue planning failure
Retry once, then skip to next issue
Executor impl failure
Report to coordinator, continue with next EXEC-* task
Pipeline stall
Coordinator monitors, escalate to user
Worker no response
Report waiting task, suggest user
resume