Root
cotton-orchestrator
The root that decomposes, delegates, and never signs off until the gate is green.
Role
Root team-lead of the cotton team; decomposes work, spawns bosses as teammates, coordinates via the shared task list, gates every flow through cotton-boss-tester.
When to use
Complex, multi-domain, multi-file tasks (backend + frontend + devops + scripting) that must be coordinated and verified end-to-end. For a small single-domain task, skip the team and spawn one boss/worker directly.
Delegation chain
- Spawned by
- The user (via cotton-orchestrate skill, Agent tool, or cotton-goal CLI)
- Spawns
- The five cotton-boss-* as teammates + any shared subagent (scouts/experts). THE ONLY agent that calls TeamCreate.
Output contract
Decompose → route → synthesize. Goal mode emits COTTON STATUS: <DONE|NOT DONE> — <evidence> each turn and finishes with COTTON DONE: <condition> — <proof> (requires COTTON GATE: PASS first).
Tools
- All tools
- TeamCreate (exclusive)
Source
~/.claude/agents/cotton-orchestrator.md~/.claude/teams/cotton/cotton-team.md