Swarm - Multi-Agent Implementation

Execute a phased implementation plan using Tech Lead (orchestrator) + Developer (implementor) agents. Independent phases run in parallel via git worktrees, dependent phases run sequentially.

Base branch is the current branch when /swarm is invoked. All phase branches are created from it, all merges go back to it. The base branch name is stored in the plan's status file (<plan-file>.swarm_status.json) and read by swarm.py on resume.

Project root is the directory containing main/ and worktrees/. All Tech Lead commands assume cwd is the project root. Use absolute paths when passing working directories to DevAgents.

Arguments

• /swarm init - Bootstrap worktree and build support for this project
• /swarm - Execute default plan docs/PLAN.md
• /swarm <plan-file> - Execute specified plan file

swarm.py shorthand: All swarm.py commands in this document expand to:

python3 ~/.claude/skills/swarm/scripts/swarm.py