Swarm Orchestration

ruvnet/ruflo/.agents/skills/swarm-orchestration

by ruvnet6051f6702b61No license74K starsListed Oct 8, 2026Updated Oct 8, 2026Repository updated today

Multi-agent swarm coordination for complex tasks. Uses hierarchical topology with specialized agents to break down and execute complex work across multiple files and modules. Use when: 3+ files need changes, new feature implementation, cross-module refactoring, API changes with tests, security-related changes, performance optimization across codebase, database schema changes. Skip when: single file edits, simple bug fixes (1-2 lines), documentation updates, configuration changes, quick exploration.

AI-generated overview

Coordinates multi-agent swarms to break down and execute complex, multi-file software tasks.

What it does
This skill sets up and manages a hierarchical swarm of specialized agents for complex work spanning multiple files or modules. It provides commands to initialize the swarm, route tasks, spawn agents, orchestrate work, and monitor status. It also ships two shell scripts for starting and monitoring the swarm.
When to use it
Use it for tasks touching three or more files, new feature implementation, cross-module refactoring, API changes with tests, security-related changes, codebase-wide performance work, or database schema changes. Skip it for single-file edits, one- or two-line bug fixes, documentation updates, configuration changes, and quick exploration.
Requirements
Requires the npx command and the @claude-flow/cli package, plus network access to fetch it. Ships two executable shell scripts for starting and monitoring the swarm.

Swarm Orchestration Skill

Purpose

Multi-agent swarm coordination for complex tasks. Uses hierarchical topology with specialized agents to break down and execute complex work across multiple files and modules.

When to Trigger

  • 3+ files need changes
  • new feature implementation
  • cross-module refactoring
  • API changes with tests
  • security-related changes
  • performance optimization across codebase
  • database schema changes

When to Skip

  • single file edits
  • simple bug fixes (1-2 lines)
  • documentation updates
  • configuration changes
  • quick exploration

Commands

Initialize Swarm

Start a new swarm with hierarchical topology (anti-drift)

bash
npx @claude-flow/cli swarm init --topology hierarchical --max-agents 8 --strategy specialized

Example:

bash
npx @claude-flow/cli swarm init --topology hierarchical --max-agents 6 --strategy specialized

Route Task

Route a task to the appropriate agents based on task type

bash
npx @claude-flow/cli hooks route --task "[task description]"

Example:

bash
npx @claude-flow/cli hooks route --task "implement OAuth2 authentication flow"

Spawn Agent

Spawn a specific agent type

bash
npx @claude-flow/cli agent spawn --type [type] --name [name]

Example:

bash
npx @claude-flow/cli agent spawn --type coder --name impl-auth

Monitor Status

Check the current swarm status

bash
npx @claude-flow/cli swarm status --verbose

Orchestrate Task

Orchestrate a task across multiple agents

bash
npx @claude-flow/cli task orchestrate --task "[task]" --strategy adaptive

Example:

bash
npx @claude-flow/cli task orchestrate --task "refactor auth module" --strategy parallel --max-agents 4

List Agents

List all active agents

bash
npx @claude-flow/cli agent list --filter active

Scripts

ScriptPathDescription
swarm-start.agents/scripts/swarm-start.shInitialize swarm with default settings
swarm-monitor.agents/scripts/swarm-monitor.shReal-time swarm monitoring dashboard

References

DocumentPathDescription
Agent Typesdocs/agents.mdComplete list of agent types and capabilities
Topology Guidedocs/topology.mdSwarm topology configuration guide

Best Practices

  1. Check memory for existing patterns before starting
  2. Use hierarchical topology for coordination
  3. Store successful patterns after completion
  4. Document any new learnings

Source and attribution

Source:ruvnet/rufloin.agents/skills/swarm-orchestrationat commit6051f67

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal