Files
gravl/.claude/commands/sparc/orchestrator.md
T
clawd d81e403f01 Phase 06 Tier 1: Complete Backend Implementation - Recovery Tracking & Swap System
COMPLETED TASKS:
 06-01: Workout Swap System
   - Added swapped_from_id to workout_logs
   - Created workout_swaps table for history
   - POST /api/workouts/:id/swap endpoint
   - GET /api/workouts/available endpoint
   - Reversible swaps with audit trail

 06-02: Muscle Group Recovery Tracking
   - Created muscle_group_recovery table
   - Implemented calculateRecoveryScore() function
   - GET /api/recovery/muscle-groups endpoint
   - GET /api/recovery/most-recovered endpoint
   - Auto-tracking on workout log completion

 06-03: Smart Workout Recommendations
   - GET /api/recommendations/smart-workout endpoint
   - 7-day workout analysis algorithm
   - Recovery-based filtering (>30% threshold)
   - Top 3 recommendations with context
   - Context-aware reasoning messages

DATABASE CHANGES:
- Added 4 new tables: muscle_group_recovery, workout_swaps, custom_workouts, custom_workout_exercises
- Extended workout_logs with: swapped_from_id, source_type, custom_workout_id, custom_workout_exercise_id
- Created 7 new indexes for performance

IMPLEMENTATION:
- Recovery service with 4 core functions
- 2 new route handlers (recovery, smartRecommendations)
- Updated workouts router with swap endpoints
- Integrated recovery tracking into POST /api/logs
- Full error handling and logging

TESTING:
- Test file created: /backend/test/phase-06-tests.js
- Ready for E2E and staging validation

STATUS: Ready for frontend integration and production review
Branch: feature/06-phase-06
2026-03-06 20:54:03 +01:00

3.1 KiB

SPARC Orchestrator Mode

Purpose

Multi-agent task orchestration with TodoWrite/TodoRead/Task/Memory using MCP tools.

Activation

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

mcp__claude-flow__sparc_mode {
  mode: "orchestrator",
  task_description: "coordinate feature development"
}

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

# Use when running from terminal or MCP tools unavailable
npx claude-flow sparc run orchestrator "coordinate feature development"

# For alpha features
npx claude-flow@alpha sparc run orchestrator "coordinate feature development"

Option 3: Local Installation

# If claude-flow is installed locally
./claude-flow sparc run orchestrator "coordinate feature development"

Core Capabilities

  • Task decomposition
  • Agent coordination
  • Resource allocation
  • Progress tracking
  • Result synthesis

Integration Examples

Using MCP Tools (Preferred)

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

// Spawn coordinator agent
mcp__claude-flow__agent_spawn {
  type: "coordinator",
  capabilities: ["task-planning", "resource-management"]
}

// Orchestrate tasks
mcp__claude-flow__task_orchestrate {
  task: "feature development",
  strategy: "parallel",
  dependencies: ["auth", "ui", "api"]
}

Using NPX CLI (Fallback)

# Initialize orchestration swarm
npx claude-flow swarm init --topology hierarchical --strategy auto --max-agents 8

# Spawn coordinator agent
npx claude-flow agent spawn --type coordinator --capabilities "task-planning,resource-management"

# Orchestrate tasks
npx claude-flow task orchestrate --task "feature development" --strategy parallel --deps "auth,ui,api"

Orchestration Patterns

  • Hierarchical coordination
  • Parallel execution
  • Sequential pipelines
  • Event-driven flows
  • Adaptive strategies

Coordination Tools

  • TodoWrite for planning
  • Task for agent launch
  • Memory for sharing
  • Progress monitoring
  • Result aggregation

Workflow Example

Using MCP Tools (Preferred)

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

// 2. Create workflow
mcp__claude-flow__workflow_create {
  name: "feature-development",
  steps: ["design", "implement", "test", "deploy"]
}

// 3. Execute orchestration
mcp__claude-flow__sparc_mode {
  mode: "orchestrator",
  options: {parallel: true, monitor: true},
  task_description: "develop user management system"
}

// 4. Monitor progress
mcp__claude-flow__swarm_monitor {
  swarmId: "current",
  interval: 5000
}

Using NPX CLI (Fallback)

# 1. Initialize orchestration swarm
npx claude-flow swarm init --topology hierarchical --max-agents 10

# 2. Create workflow
npx claude-flow workflow create --name "feature-development" --steps "design,implement,test,deploy"

# 3. Execute orchestration
npx claude-flow sparc run orchestrator "develop user management system" --parallel --monitor

# 4. Monitor progress
npx claude-flow swarm monitor --interval 5000