swarm-coordination

Multi-agent coordination in OpenCode is handled by decomposing tasks into parallelizable subtasks, spawning workers with explicit file reservations to prevent conflicts, and orchestrating execution through Swarm Mail for persistent collaboration context.

Multi-agent swarm workflows are needed for tasks that touch 3 or more files, require parallel work such as frontend, backend, or tests, or benefit from specialized coordinating agents to decompose and assign work across multiple agents.

File reservation during worker spawning assigns explicit file ownership to each agent, preventing write conflicts and ensuring parallel work across frontend, backend, and tests can proceed without overwriting each other's results.

Swarm Mail initializes orchestration and provides persistent collaboration context, allowing multiple spawned agents to coordinate their task execution, share updates, and integrate results across files without losing communication state.

The best approach is to check worker results before finalizing, recording outcomes and leveraging past learnings via hivemind to adapt and improve future task decomposition, worker spawning, and coordination across multi-agent workflows.

MCP lifecycle initialization is required before task planning and worker spawning, establishing the orchestration layer that enables Swarm Mail communication, file reservations, and post-task review across all coordinated agents.