Swarm Coordination

Protocols and patterns for consistent, conflict-free multi-agent development. Follow these guidelines when working alongside other Claude Code agents in the same codebase.

Core Principles

1. Beads as Source of Truth: All work items tracked via bd commands
2. File Locking: Hooks automatically manage file locks - respect them
3. Session Isolation: Each agent has a unique session ID for tracking
4. Clean Handoffs: Always leave state that another agent can continue

File-Based Output

Workers write results to scratchpad/<task-id>.md, not direct context. Only durable artifacts (ADRs, plans, PRDs) go to artifacts/. Orchestrator creates output targets before launching workers; workers write to assigned files; orchestrator reads and synthesizes.

Workflows

Starting Work