Team Brainstorm
Orchestrate multi-agent brainstorming: generate ideas → challenge assumptions → synthesize → evaluate. Supports Quick, Deep, and Full pipelines with Generator-Critic loop.
Architecture
Skill(skill="team-brainstorm", args="topic 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 v v
[ideator][challenger][synthesizer][evaluator]
Role Registry
Role
Path
Prefix
Inner Loop
coordinator
roles/coordinator/role.md
—
—
ideator
roles/ideator/role.md
IDEA-
false
challenger
roles/challenger/role.md
CHALLENGE-
false
synthesizer
roles/synthesizer/role.md
SYNTH-
false
evaluator
roles/evaluator/role.md
EVAL-
false
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
:
BRS
Session path
:
.workflow/.team/BRS--/
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: "brainstorm",
name: "",
run_in_background: true,
prompt: ## Role Assignment
role: <role>
role_spec: ~ or <project>/.claude/skills/team-brainstorm/roles/<role>/role.md
session: <session-folder>
session_id: <session-id>
team_name: brainstorm
requirement: <topic-description>
inner_loop: false
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).
})
Parallel ideator spawn
(Full pipeline with N angles):
When Full pipeline has N parallel IDEA tasks, spawn N distinct team-worker agents named
ideator-1
,
ideator-2
, etc.
Agent({
subagent_type: "team-worker",
name: "ideator-",
team_name: "brainstorm",
run_in_background: true,
prompt: ## Role Assignment
role: ideator
role_spec: ~ or <project>/.claude/skills/team-brainstorm/roles/ideator/role.md
session: <session-folder>
session_id: <session-id>
team_name: brainstorm
requirement: <topic-description>
agent_name: ideator-<N>
inner_loop: false
Read role_spec file to load Phase 2-4 domain instructions.
Execute built-in Phase 1 (task discovery, owner=ideator-<N>) -> role Phase 2-4 -> built-in Phase 5 (report).
})
User Commands
Command
Action
check
/
status
View execution status graph, no advancement
resume
/
continue
Check worker states, advance next step
Session Directory
.workflow/.team/BRS--/
├── session.json # Session metadata + pipeline + gc_round
├── task-analysis.json # Coordinator analyze output
├── .msg/
│ ├── messages.jsonl # Message bus log
│ └── meta.json # Session state + cross-role state
├── wisdom/ # Cross-task knowledge
│ ├── learnings.md
│ ├── decisions.md
│ ├── conventions.md
│ └── issues.md
├── ideas/ # Ideator output
│ ├── idea-001.md
│ └── idea-002.md
├── critiques/ # Challenger output
│ ├── critique-001.md
│ └── critique-002.md
├── synthesis/ # Synthesizer output
│ └── synthesis-001.md
└── evaluation/ # Evaluator output
└── evaluation-001.md
Specs Reference
specs/pipelines.md
— Pipeline definitions and task registry
Error Handling
Scenario
Resolution
Unknown command
Error with available command list
Role not found
Error with role registry
CLI tool fails
Worker fallback to direct implementation
Fast-advance conflict
Coordinator reconciles on next callback
Completion action fails
Default to Keep Active
Generator-Critic loop exceeds 2 rounds
Force convergence to synthesizer
No ideas generated
Coordinator prompts with seed questions