CrmClinicas/.claude/commands/claude-flow-swarm.md

name, description

name	description
claude-flow-swarm	Coordinate multi-agent swarms for complex tasks

🐝 Claude-Flow Swarm Coordination

Advanced multi-agent coordination system with timeout-free execution, distributed memory sharing, and intelligent load balancing.

Basic Usage

./claude-flow swarm "your complex task" --strategy <type> [options]

🎯 Swarm Strategies

• auto - Automatic strategy selection based on task analysis
• development - Code implementation with review and testing
• research - Information gathering and synthesis
• analysis - Data processing and pattern identification
• testing - Comprehensive quality assurance
• optimization - Performance tuning and refactoring
• maintenance - System updates and bug fixes

🤖 Agent Types

• coordinator - Plans and delegates tasks to other agents
• developer - Writes code and implements solutions
• researcher - Gathers and analyzes information
• analyzer - Identifies patterns and generates insights
• tester - Creates and runs tests for quality assurance
• reviewer - Performs code and design reviews
• documenter - Creates documentation and guides
• monitor - Tracks performance and system health
• specialist - Domain-specific expert agents

🔄 Coordination Modes

• centralized - Single coordinator manages all agents (default)
• distributed - Multiple coordinators share management
• hierarchical - Tree structure with nested coordination
• mesh - Peer-to-peer agent collaboration
• hybrid - Mixed coordination strategies

⚙️ Common Options

• --strategy <type> - Execution strategy
• --mode <type> - Coordination mode
• --max-agents <n> - Maximum concurrent agents (default: 5)
• --timeout <minutes> - Timeout in minutes (default: 60)
• --background - Run in background for tasks > 30 minutes
• --monitor - Enable real-time monitoring
• --ui - Launch terminal UI interface
• --parallel - Enable parallel execution
• --distributed - Enable distributed coordination
• --review - Enable peer review process
• --testing - Include automated testing
• --encryption - Enable data encryption
• --verbose - Detailed logging output
• --dry-run - Show configuration without executing

🌟 Examples

Development Swarm with Review

./claude-flow swarm "Build e-commerce REST API" \
  --strategy development \
  --monitor \
  --review \
  --testing

Long-Running Research Swarm

./claude-flow swarm "Analyze AI market trends 2024-2025" \
  --strategy research \
  --background \
  --distributed \
  --max-agents 8

Performance Optimization Swarm

./claude-flow swarm "Optimize database queries and API performance" \
  --strategy optimization \
  --testing \
  --parallel \
  --monitor

Enterprise Development Swarm

./claude-flow swarm "Implement secure payment processing system" \
  --strategy development \
  --mode distributed \
  --max-agents 10 \
  --parallel \
  --monitor \
  --review \
  --testing \
  --encryption \
  --verbose

Testing and QA Swarm

./claude-flow swarm "Comprehensive security audit and testing" \
  --strategy testing \
  --review \
  --verbose \
  --max-agents 6

📊 Monitoring and Control

Real-time monitoring:

# Monitor swarm activity
./claude-flow monitor

# Monitor specific component
./claude-flow monitor --focus swarm

Check swarm status:

# Overall system status
./claude-flow status

# Detailed swarm status
./claude-flow status --verbose

View agent activity:

# List all agents
./claude-flow agent list

# Agent details
./claude-flow agent info <agent-id>

💾 Memory Integration

Swarms automatically use distributed memory for collaboration:

# Store swarm objectives
./claude-flow memory store "swarm_objective" "Build scalable API" --namespace swarm

# Query swarm progress
./claude-flow memory query "swarm_progress" --namespace swarm

# Export swarm memory
./claude-flow memory export swarm-results.json --namespace swarm

🎯 Key Features

Timeout-Free Execution

• Background mode for long-running tasks
• State persistence across sessions
• Automatic checkpoint recovery

Work Stealing & Load Balancing

• Dynamic task redistribution
• Automatic agent scaling
• Resource-aware scheduling

Circuit Breakers & Fault Tolerance

• Automatic retry with exponential backoff
• Graceful degradation
• Health monitoring and recovery

Real-Time Collaboration

• Cross-agent communication
• Shared memory access
• Event-driven coordination

Enterprise Security

• Role-based access control
• Audit logging
• Data encryption
• Input validation

🔧 Advanced Configuration

Dry run to preview:

./claude-flow swarm "Test task" --dry-run --strategy development

Custom quality thresholds:

./claude-flow swarm "High quality API" \
  --strategy development \
  --quality-threshold 0.95

Scheduling algorithms:

• FIFO (First In, First Out)
• Priority-based
• Deadline-driven
• Shortest Job First
• Critical Path
• Resource-aware
• Adaptive

For detailed documentation, see: https://github.com/ruvnet/claude-code-flow/docs/swarm-system.md