CrmClinicas/.claude/commands/sparc/sparc-modes.md

SPARC Modes Overview

SPARC (Specification, Planning, Architecture, Review, Code) is a comprehensive development methodology with 17 specialized modes, all integrated with MCP tools for enhanced coordination and execution.

Available Modes

Core Orchestration Modes

• orchestrator: Multi-agent task orchestration
• swarm-coordinator: Specialized swarm management
• workflow-manager: Process automation
• batch-executor: Parallel task execution

Development Modes

• coder: Autonomous code generation
• architect: System design
• reviewer: Code review
• tdd: Test-driven development

Analysis and Research Modes

• researcher: Deep research capabilities
• analyzer: Code and data analysis
• optimizer: Performance optimization

Creative and Support Modes

• designer: UI/UX design
• innovator: Creative problem solving
• documenter: Documentation generation
• debugger: Systematic debugging
• tester: Comprehensive testing
• memory-manager: Knowledge management

Usage

Option 1: Using MCP Tools (Preferred in Claude Code)

// Execute SPARC mode directly
mcp__claude-flow__sparc_mode {
  mode: "<mode>",
  task_description: "<task>",
  options: {
    // mode-specific options
  }
}

// Initialize swarm for advanced coordination
mcp__claude-flow__swarm_init {
  topology: "hierarchical",
  strategy: "auto",
  maxAgents: 8
}

// Spawn specialized agents
mcp__claude-flow__agent_spawn {
  type: "<agent-type>",
  capabilities: ["<capability1>", "<capability2>"]
}

// Monitor execution
mcp__claude-flow__swarm_monitor {
  swarmId: "current",
  interval: 5000
}

Option 2: Using NPX CLI (Fallback when MCP not available)

# Use when running from terminal or MCP tools unavailable
npx claude-flow sparc run <mode> "task description"

# For alpha features
npx claude-flow@alpha sparc run <mode> "task description"

# List all modes
npx claude-flow sparc modes

# Get help for a mode
npx claude-flow sparc help <mode>

# Run with options
npx claude-flow sparc run <mode> "task" --parallel --monitor

Option 3: Local Installation

# If claude-flow is installed locally
./claude-flow sparc run <mode> "task description"

Common Workflows

Full Development Cycle

Using MCP Tools (Preferred)

// 1. Initialize development swarm
mcp__claude-flow__swarm_init {
  topology: "hierarchical",
  maxAgents: 12
}

// 2. Architecture design
mcp__claude-flow__sparc_mode {
  mode: "architect",
  task_description: "design microservices"
}

// 3. Implementation
mcp__claude-flow__sparc_mode {
  mode: "coder",
  task_description: "implement services"
}

// 4. Testing
mcp__claude-flow__sparc_mode {
  mode: "tdd",
  task_description: "test all services"
}

// 5. Review
mcp__claude-flow__sparc_mode {
  mode: "reviewer",
  task_description: "review implementation"
}

Using NPX CLI (Fallback)

# 1. Architecture design
npx claude-flow sparc run architect "design microservices"

# 2. Implementation
npx claude-flow sparc run coder "implement services"

# 3. Testing
npx claude-flow sparc run tdd "test all services"

# 4. Review
npx claude-flow sparc run reviewer "review implementation"

Research and Innovation

Using MCP Tools (Preferred)

// 1. Research phase
mcp__claude-flow__sparc_mode {
  mode: "researcher",
  task_description: "research best practices"
}

// 2. Innovation
mcp__claude-flow__sparc_mode {
  mode: "innovator",
  task_description: "propose novel solutions"
}

// 3. Documentation
mcp__claude-flow__sparc_mode {
  mode: "documenter",
  task_description: "document findings"
}

Using NPX CLI (Fallback)

# 1. Research phase
npx claude-flow sparc run researcher "research best practices"

# 2. Innovation
npx claude-flow sparc run innovator "propose novel solutions"

# 3. Documentation
npx claude-flow sparc run documenter "document findings"