swarm-orchestration

Original：🇺🇸 English

Translated

2 scriptsChecked / no sensitive code detected

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.

1installs

Sourceruvnet/claude-flow

Added on2026-02-08

NPX Install

npx skill4agent add ruvnet/claude-flow swarm-orchestration

SKILL.md Content

View Translation Comparison →

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

Script	Path	Description
`swarm-start`	`.agents/scripts/swarm-start.sh`	Initialize swarm with default settings
`swarm-monitor`	`.agents/scripts/swarm-monitor.sh`	Real-time swarm monitoring dashboard

References

Document	Path	Description
`Agent Types`	`docs/agents.md`	Complete list of agent types and capabilities
`Topology Guide`	`docs/topology.md`	Swarm topology configuration guide

Best Practices

Check memory for existing patterns before starting
Use hierarchical topology for coordination
Store successful patterns after completion
Document any new learnings

swarm-orchestration

NPX Install

Tags

SKILL.md Content

Swarm Orchestration Skill

Purpose

When to Trigger

When to Skip

Commands

Initialize Swarm

Route Task

Spawn Agent

Monitor Status

Orchestrate Task

List Agents

Scripts

References

Best Practices