Swarm Orchestration

Initialize a swarm with npx agentic-flow hooks swarm-init, spawn agents with agent-spawn, then run task-orchestrate with --mode parallel. The swarm distributes tasks across agents and aggregates results automatically.

Use mesh for peer-to-peer collaboration among equal agents, hierarchical for centralized coordination with a queen agent directing workers, or adaptive to let the swarm switch topology based on task complexity.

You need agentic-flow v3.0.0-alpha.1 or later and Node.js 18 or higher. Familiarity with distributed systems concepts is helpful but not required.

Agents share state through swarm memory using swarm.memory.store to write data and swarm.memory.retrieve to read it. This lets agents access shared artifacts like API schemas without direct messaging.

Coordination failures usually stem from missing memory access or disabled hooks. Verify agents can read and write swarm memory, and enable pre-task and post-task hooks for automatic synchronization.

Configure resiliency with retry policies using exponential backoff and a fallback strategy that reassigns failed tasks to other agents. Set maxAttempts to control retry behavior before reassignment.