swarm-orchestration

Swarm Orchestration

Overview

Form and coordinate multi-agent swarms with topology-aware deployment. Supports Mesh, Hierarchical, Ring, and Star topologies with automatic selection based on task complexity and agent count.

When to Use

• Complex tasks requiring multiple specialized agents
• Tasks needing coordinated parallel execution
• When consensus among agents is required for quality
• Projects requiring anti-drift enforcement during execution

Process

1. Topology Selection - Analyze task and agent pool to select optimal topology
2. Agent Assignment - Assign Queen (Strategic/Tactical/Adaptive) and Worker roles
3. Consensus Init - Initialize Raft/Byzantine/Gossip/CRDT protocol
4. Parallel Execution - Distribute subtasks with shared memory
5. Anti-Drift Checkpoints - Validate alignment every N subtasks
6. Consensus Voting - Weighted voting (Queen=3x) for final decision

Topologies

• Mesh: All-to-all communication, best for small swarms (<8 agents)
• Hierarchical: Queen coordinates workers, best for large/structured tasks
• Ring: Sequential handoff, best for pipeline/transformation tasks
• Star: Central coordinator fan-out, best for independent subtasks

Agents Used

• agents/strategic-queen/ - Long-term planning swarms
• agents/tactical-queen/ - Execution coordination swarms
• agents/adaptive-queen/ - Real-time optimization swarms
• agents/swarm-coordinator/ - Topology management

Tool Use

Invoke via babysitter process: methodologies/ruflo/ruflo-swarm-coordination