/swarm
Main swarm orchestration command for Claude Flow V3.
> /plugin marketplace add proffesor-for-testing/agentic-qe > /plugin install agentic-qe-fleet@agentic-qe
How it fires
How this command gets triggered: by you, by Claude, or both.
- Fires itselfClaude auto-loads it when your prompt matches the work.
- You can call itInvoke it directly when you want it.
- Slash command
/swarm
Context preview
What this command does when you run it.
Main swarm orchestration command for Claude Flow V3.
Command definition
swarm.md/swarm
Main swarm orchestration command for Claude Flow V3.
🚨 CRITICAL: Background Execution Pattern
**When spawning a swarm, Claude Code MUST:**
1. **Spawn ALL agents in background** using `run_in_background: true` 2. **Put ALL Task calls in ONE message** for parallel execution 3. **Display status board** with ASCII table and emojis 4. **STOP and WAIT** - don't add more tool calls or poll status
✅ CORRECT Spawn Pattern
// Spawn ALL agents IN BACKGROUND in ONE message
Task({ prompt: "Research...", subagent_type: "researcher", run_in_background: true })
Task({ prompt: "Design...", subagent_type: "architect", run_in_background: true })
Task({ prompt: "Implement...", subagent_type: "coder", run_in_background: true })
Task({ prompt: "Test...", subagent_type: "tester", run_in_background: true })
Task({ prompt: "Review...", subagent_type: "reviewer", run_in_background: true })📊 Required Status Display (ASCII Table)
**After spawning, Claude Code MUST display this status board:**
╔══════════════════════════════════════════════════════════════╗
║ 🐝 SWARM LAUNCHED ║
╠══════════════════════════════════════════════════════════════╣
║ 📋 Task: [user's task description] ║
║ 🔄 Topology: hierarchical │ 👥 Agents: 5/15 ║
╠══════════════════════════════════════════════════════════════╣
║ AGENT │ STATUS │ TASK ║
╠══════════════════════════════════════════════════════════════╣
║ 🔍 Researcher │ 🟢 ACTIVE │ Analyzing requirements ║
║ 🏗️ Architect │ 🟢 ACTIVE │ Designing approach ║
║ 💻 Coder │ 🟢 ACTIVE │ Implementing solution ║
║ 🧪 Tester │ 🟢 ACTIVE │ Writing tests ║
║ 👀 Reviewer │ 🟢 ACTIVE │ Code review & security ║
╠══════════════════════════════════════════════════════════════╣
║ ⏳ Working in parallel... Results will arrive automatically ║
╚══════════════════════════════════════════════════════════════╝
❌ DO NOT
TaskOutput({ task_id: "..." }) // ❌ Don't poll
"Should I check on agents?" // ❌ Don't ask
swarm status // ❌ Don't check repeatedly📋 Agent Types by Task
╔═══════════════════╦═════════════════════════════════════════════╗
║ TASK TYPE ║ AGENTS ║
╠═══════════════════╬═════════════════════════════════════════════╣
║ 🆕 New Feature ║ researcher, architect, coder, tester, rev ║
║ 🐛 Bug Fix ║ researcher, coder, tester ║
║ ♻️ Refactor ║ architect, coder, reviewer ║
║ 🔒 Security ║ security-architect, auditor, reviewer ║
║ ⚡ Performance ║ researcher, perf-engineer, coder ║
║ 📚 Documentation ║ researcher, api-docs ║
╚═══════════════════╩═════════════════════════════════════════════╝
Usage
npx @claude-flow/cli@latest swarm init --topology hierarchical
npx @claude-flow/cli@latest swarm status # Only after completion
Options
╔════════════════════════╦═══════════════════════════════════════╗
║ OPTION ║ DESCRIPTION ║
╠════════════════════════╬═══════════════════════════════════════╣
║ --strategy <type> ║ research, development, analysis ║
║ --topology <type> ║ hierarchical, mesh, ring, star ║
║ --max-agents <n> ║ Maximum agents (default: 15) ║
║ --background ║ Run in background (default: true) ║
╚════════════════════════╩═══════════════════════════════════════╝
Read more
/swarm
Main swarm orchestration command for Claude Flow V3.
🚨 CRITICAL: Background Execution Pattern
**When spawning a swarm, Claude Code MUST:**
1. **Spawn ALL agents in background** using `run_in_background: true` 2. **Put ALL Task calls in ONE message** for parallel execution 3. **Display status board** with ASCII table and emojis 4. **STOP and WAIT** - don't add more tool calls or poll status
✅ CORRECT Spawn Pattern
// Spawn ALL agents IN BACKGROUND in ONE message
Task({ prompt: "Research...", subagent_type: "researcher", run_in_background: true })
Task({ prompt: "Design...", subagent_type: "architect", run_in_background: true })
Task({ prompt: "Implement...", subagent_type: "coder", run_in_background: true })
Task({ prompt: "Test...", subagent_type: "tester", run_in_background: true })
Task({ prompt: "Review...", subagent_type: "reviewer", run_in_background: true })📊 Required Status Display (ASCII Table)
**After spawning, Claude Code MUST display this status board:**
╔══════════════════════════════════════════════════════════════╗ ║ 🐝 SWARM LAUNCHED ║ ╠══════════════════════════════════════════════════════════════╣ ║ 📋 Task: [user's task description] ║ ║ 🔄 Topology: hierarchical │ 👥 Agents: 5/15 ║ ╠══════════════════════════════════════════════════════════════╣ ║ AGENT │ STATUS │ TASK ║ ╠══════════════════════════════════════════════════════════════╣ ║ 🔍 Researcher │ 🟢 ACTIVE │ Analyzing requirements ║ ║ 🏗️ Architect │ 🟢 ACTIVE │ Designing approach ║ ║ 💻 Coder │ 🟢 ACTIVE │ Implementing solution ║ ║ 🧪 Tester │ 🟢 ACTIVE │ Writing tests ║ ║ 👀 Reviewer │ 🟢 ACTIVE │ Code review & security ║ ╠══════════════════════════════════════════════════════════════╣ ║ ⏳ Working in parallel... Results will arrive automatically ║ ╚══════════════════════════════════════════════════════════════╝
❌ DO NOT
TaskOutput({ task_id: "..." }) // ❌ Don't poll
"Should I check on agents?" // ❌ Don't ask
swarm status // ❌ Don't check repeatedly📋 Agent Types by Task
╔═══════════════════╦═════════════════════════════════════════════╗ ║ TASK TYPE ║ AGENTS ║ ╠═══════════════════╬═════════════════════════════════════════════╣ ║ 🆕 New Feature ║ researcher, architect, coder, tester, rev ║ ║ 🐛 Bug Fix ║ researcher, coder, tester ║ ║ ♻️ Refactor ║ architect, coder, reviewer ║ ║ 🔒 Security ║ security-architect, auditor, reviewer ║ ║ ⚡ Performance ║ researcher, perf-engineer, coder ║ ║ 📚 Documentation ║ researcher, api-docs ║ ╚═══════════════════╩═════════════════════════════════════════════╝
Usage
npx @claude-flow/cli@latest swarm init --topology hierarchical npx @claude-flow/cli@latest swarm status # Only after completion
Options
╔════════════════════════╦═══════════════════════════════════════╗ ║ OPTION ║ DESCRIPTION ║ ╠════════════════════════╬═══════════════════════════════════════╣ ║ --strategy <type> ║ research, development, analysis ║ ║ --topology <type> ║ hierarchical, mesh, ring, star ║ ║ --max-agents <n> ║ Maximum agents (default: 15) ║ ║ --background ║ Run in background (default: true) ║ ╚════════════════════════╩═══════════════════════════════════════╝
AI-powered quality engineering agents that generate tests, find coverage gaps, detect flaky tests, and learn your codebase patterns — across 11 coding agent platforms.
Repo: proffesor-for-testing/agentic-qe
Other commands on agentic-qe.
- /agent-capabilities
Capability matrix for all agent types
Open command - /agent-coordination
Coordination patterns for multi-agent collaboration.
Open command - /agent-spawning
Guide to spawning agents with Claude Code's Task tool.
Open command - /agent-types
Complete guide to all 87 available agent types in Claude Flow V3
Open command - /health
Show agent health and metrics
Open command - /list
List all active agents
Open command