name: swarm-orchestration description: > 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.

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)

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

Example:

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

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

Example:

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

Spawn Agent

Spawn a specific agent type

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

Example:

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

Monitor Status

Check the current swarm status

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

Orchestrate Task

Orchestrate a task across multiple agents

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

Example:

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

List Agents

List all active agents

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

Scripts

References

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