claude-flow 3.0.0-alpha.16 → 3.0.0-alpha.19

package/.claude/agents/templates/migration-plan.md

@@ -1,746 +0,0 @@
----
-name: migration-planner
-type: planning
-color: red
-description: Comprehensive migration plan for converting commands to agent-based system
-capabilities:
-  - migration-planning
-  - system-transformation
-  - agent-mapping
-  - compatibility-analysis
-  - rollout-coordination
-priority: medium
-hooks:
-  pre: |
-    echo "📋 Agent System Migration Planner activated"
-    echo "🔄 Analyzing current command structure for migration"
-    # Check existing command structure
-    if [ -d ".claude/commands" ]; then
-      echo "📁 Found existing command directory - will map to agents"
-      find .claude/commands -name "*.md" | wc -l | xargs echo "Commands to migrate:"
-    fi
-  post: |
-    echo "✅ Migration planning completed"
-    echo "📊 Agent mapping strategy defined"
-    echo "🚀 Ready for systematic agent system rollout"
----
-
-# Claude Flow Commands to Agent System Migration Plan
-
-## Overview
-This document provides a comprehensive migration plan to convert existing .claude/commands to the new agent-based system. Each command is mapped to an equivalent agent with defined roles, responsibilities, capabilities, and tool access restrictions.
-
-## Agent Definition Format
-Each agent uses YAML frontmatter with the following structure:
-```yaml
----
-role: agent-type
-name: Agent Display Name
-responsibilities:
-  - Primary responsibility
-  - Secondary responsibility
-capabilities:
-  - capability-1
-  - capability-2
-tools:
-  allowed:
-    - tool-name
-  restricted:
-    - restricted-tool
-triggers:
-  - pattern: "regex pattern"
-    priority: high|medium|low
-  - keyword: "activation keyword"
----
-```
-
-## Migration Categories
-
-### 1. Coordination Agents
-
-#### Swarm Initializer Agent
-**Command**: `.claude/commands/coordination/init.md`
-```yaml
----
-role: coordinator
-name: Swarm Initializer
-responsibilities:
-  - Initialize agent swarms with optimal topology
-  - Configure distributed coordination systems
-  - Set up inter-agent communication channels
-capabilities:
-  - swarm-initialization
-  - topology-optimization
-  - resource-allocation
-  - network-configuration
-tools:
-  allowed:
-    - mcp__claude-flow__swarm_init
-    - mcp__claude-flow__topology_optimize
-    - mcp__claude-flow__memory_usage
-    - TodoWrite
-  restricted:
-    - Bash
-    - Write
-    - Edit
-triggers:
-  - pattern: "init.*swarm|create.*swarm|setup.*agents"
-    priority: high
-  - keyword: "swarm-init"
----
-```
-
-#### Agent Spawner
-**Command**: `.claude/commands/coordination/spawn.md`
-```yaml
----
-role: coordinator
-name: Agent Spawner
-responsibilities:
-  - Create specialized cognitive patterns for task execution
-  - Assign capabilities to agents based on requirements
-  - Manage agent lifecycle and resource allocation
-capabilities:
-  - agent-creation
-  - capability-assignment
-  - resource-management
-  - pattern-recognition
-tools:
-  allowed:
-    - mcp__claude-flow__agent_spawn
-    - mcp__claude-flow__daa_agent_create
-    - mcp__claude-flow__agent_list
-    - mcp__claude-flow__memory_usage
-  restricted:
-    - Bash
-    - Write
-    - Edit
-triggers:
-  - pattern: "spawn.*agent|create.*agent|add.*agent"
-    priority: high
-  - keyword: "agent-spawn"
----
-```
-
-#### Task Orchestrator
-**Command**: `.claude/commands/coordination/orchestrate.md`
-```yaml
----
-role: orchestrator
-name: Task Orchestrator
-responsibilities:
-  - Decompose complex tasks into manageable subtasks
-  - Coordinate parallel and sequential execution strategies
-  - Monitor task progress and dependencies
-  - Synthesize results from multiple agents
-capabilities:
-  - task-decomposition
-  - execution-planning
-  - dependency-management
-  - result-aggregation
-  - progress-tracking
-tools:
-  allowed:
-    - mcp__claude-flow__task_orchestrate
-    - mcp__claude-flow__task_status
-    - mcp__claude-flow__task_results
-    - mcp__claude-flow__parallel_execute
-    - TodoWrite
-    - TodoRead
-  restricted:
-    - Bash
-    - Write
-    - Edit
-triggers:
-  - pattern: "orchestrate|coordinate.*task|manage.*workflow"
-    priority: high
-  - keyword: "orchestrate"
----
-```
-
-### 2. GitHub Integration Agents
-
-#### PR Manager Agent
-**Command**: `.claude/commands/github/pr-manager.md`
-```yaml
----
-role: github-specialist
-name: Pull Request Manager
-responsibilities:
-  - Manage complete pull request lifecycle
-  - Coordinate multi-reviewer workflows
-  - Handle merge strategies and conflict resolution
-  - Track PR progress with issue integration
-capabilities:
-  - pr-creation
-  - review-coordination
-  - merge-management
-  - conflict-resolution
-  - status-tracking
-tools:
-  allowed:
-    - Bash  # For gh CLI commands
-    - mcp__claude-flow__swarm_init
-    - mcp__claude-flow__agent_spawn
-    - mcp__claude-flow__task_orchestrate
-    - mcp__claude-flow__memory_usage
-    - TodoWrite
-    - Read
-  restricted:
-    - Write  # Should use gh CLI for GitHub operations
-    - Edit
-triggers:
-  - pattern: "pr|pull.?request|merge.*request"
-    priority: high
-  - keyword: "pr-manager"
----
-```
-
-#### Code Review Swarm Agent
-**Command**: `.claude/commands/github/code-review-swarm.md`
-```yaml
----
-role: reviewer
-name: Code Review Coordinator
-responsibilities:
-  - Orchestrate multi-agent code reviews
-  - Ensure code quality and standards compliance
-  - Coordinate security and performance reviews
-  - Generate comprehensive review reports
-capabilities:
-  - code-analysis
-  - quality-assessment
-  - security-scanning
-  - performance-review
-  - report-generation
-tools:
-  allowed:
-    - Bash  # For gh CLI
-    - Read
-    - Grep
-    - mcp__claude-flow__swarm_init
-    - mcp__claude-flow__agent_spawn
-    - mcp__claude-flow__github_code_review
-    - mcp__claude-flow__memory_usage
-  restricted:
-    - Write
-    - Edit
-triggers:
-  - pattern: "review.*code|code.*review|check.*pr"
-    priority: high
-  - keyword: "code-review"
----
-```
-
-#### Release Manager Agent
-**Command**: `.claude/commands/github/release-manager.md`
-```yaml
----
-role: release-coordinator
-name: Release Manager
-responsibilities:
-  - Coordinate release preparation and deployment
-  - Manage version tagging and changelog generation
-  - Orchestrate multi-repository releases
-  - Handle rollback procedures
-capabilities:
-  - release-planning
-  - version-management
-  - changelog-generation
-  - deployment-coordination
-  - rollback-execution
-tools:
-  allowed:
-    - Bash
-    - Read
-    - mcp__claude-flow__github_release_coord
-    - mcp__claude-flow__swarm_init
-    - mcp__claude-flow__task_orchestrate
-    - TodoWrite
-  restricted:
-    - Write  # Use version control for releases
-    - Edit
-triggers:
-  - pattern: "release|deploy|tag.*version|create.*release"
-    priority: high
-  - keyword: "release-manager"
----
-```
-
-### 3. SPARC Methodology Agents
-
-#### SPARC Orchestrator Agent
-**Command**: `.claude/commands/sparc/orchestrator.md`
-```yaml
----
-role: sparc-coordinator
-name: SPARC Orchestrator
-responsibilities:
-  - Coordinate SPARC methodology phases
-  - Manage task decomposition and agent allocation
-  - Track progress across all SPARC phases
-  - Synthesize results from specialized agents
-capabilities:
-  - sparc-coordination
-  - phase-management
-  - task-planning
-  - resource-allocation
-  - result-synthesis
-tools:
-  allowed:
-    - mcp__claude-flow__sparc_mode
-    - mcp__claude-flow__swarm_init
-    - mcp__claude-flow__agent_spawn
-    - mcp__claude-flow__task_orchestrate
-    - TodoWrite
-    - TodoRead
-    - mcp__claude-flow__memory_usage
-  restricted:
-    - Bash
-    - Write
-    - Edit
-triggers:
-  - pattern: "sparc.*orchestrat|coordinate.*sparc"
-    priority: high
-  - keyword: "sparc-orchestrator"
----
-```
-
-#### SPARC Coder Agent
-**Command**: `.claude/commands/sparc/coder.md`
-```yaml
----
-role: implementer
-name: SPARC Implementation Specialist
-responsibilities:
-  - Transform specifications into working code
-  - Implement TDD practices with parallel test creation
-  - Ensure code quality and standards compliance
-  - Optimize implementation for performance
-capabilities:
-  - code-generation
-  - test-implementation
-  - refactoring
-  - optimization
-  - documentation
-tools:
-  allowed:
-    - Read
-    - Write
-    - Edit
-    - MultiEdit
-    - Bash
-    - mcp__claude-flow__sparc_mode
-    - TodoWrite
-  restricted:
-    - mcp__claude-flow__swarm_init  # Focus on implementation
-triggers:
-  - pattern: "implement|code|develop|build.*feature"
-    priority: high
-  - keyword: "sparc-coder"
----
-```
-
-#### SPARC Tester Agent
-**Command**: `.claude/commands/sparc/tester.md`
-```yaml
----
-role: quality-assurance
-name: SPARC Testing Specialist
-responsibilities:
-  - Design comprehensive test strategies
-  - Implement parallel test execution
-  - Ensure coverage requirements are met
-  - Coordinate testing across different levels
-capabilities:
-  - test-design
-  - test-implementation
-  - coverage-analysis
-  - performance-testing
-  - security-testing
-tools:
-  allowed:
-    - Read
-    - Write
-    - Edit
-    - Bash
-    - mcp__claude-flow__sparc_mode
-    - TodoWrite
-    - mcp__claude-flow__parallel_execute
-  restricted:
-    - mcp__claude-flow__swarm_init
-triggers:
-  - pattern: "test|verify|validate|check.*quality"
-    priority: high
-  - keyword: "sparc-tester"
----
-```
-
-### 4. Analysis Agents
-
-#### Performance Analyzer Agent
-**Command**: `.claude/commands/analysis/performance-bottlenecks.md`
-```yaml
----
-role: analyst
-name: Performance Bottleneck Analyzer
-responsibilities:
-  - Identify performance bottlenecks in workflows
-  - Analyze execution patterns and resource usage
-  - Recommend optimization strategies
-  - Monitor improvement metrics
-capabilities:
-  - performance-analysis
-  - bottleneck-detection
-  - metric-collection
-  - pattern-recognition
-  - optimization-planning
-tools:
-  allowed:
-    - mcp__claude-flow__bottleneck_analyze
-    - mcp__claude-flow__performance_report
-    - mcp__claude-flow__metrics_collect
-    - mcp__claude-flow__trend_analysis
-    - Read
-    - Grep
-  restricted:
-    - Write
-    - Edit
-    - Bash
-triggers:
-  - pattern: "analyze.*performance|bottleneck|slow.*execution"
-    priority: high
-  - keyword: "performance-analyzer"
----
-```
-
-#### Token Efficiency Analyst Agent
-**Command**: `.claude/commands/analysis/token-efficiency.md`
-```yaml
----
-role: analyst
-name: Token Efficiency Analyzer
-responsibilities:
-  - Monitor token consumption across operations
-  - Identify inefficient token usage patterns
-  - Recommend optimization strategies
-  - Track cost implications
-capabilities:
-  - token-analysis
-  - cost-optimization
-  - usage-tracking
-  - pattern-detection
-  - report-generation
-tools:
-  allowed:
-    - mcp__claude-flow__token_usage
-    - mcp__claude-flow__cost_analysis
-    - mcp__claude-flow__usage_stats
-    - mcp__claude-flow__memory_analytics
-    - Read
-  restricted:
-    - Write
-    - Edit
-    - Bash
-triggers:
-  - pattern: "token.*usage|analyze.*cost|efficiency.*report"
-    priority: medium
-  - keyword: "token-analyzer"
----
-```
-
-### 5. Memory Management Agents
-
-#### Memory Coordinator Agent
-**Command**: `.claude/commands/memory/usage.md`
-```yaml
----
-role: memory-manager
-name: Memory Coordination Specialist
-responsibilities:
-  - Manage persistent memory across sessions
-  - Coordinate memory namespaces and TTL
-  - Optimize memory usage and compression
-  - Facilitate cross-agent memory sharing
-capabilities:
-  - memory-management
-  - namespace-coordination
-  - data-persistence
-  - compression-optimization
-  - synchronization
-tools:
-  allowed:
-    - mcp__claude-flow__memory_usage
-    - mcp__claude-flow__memory_search
-    - mcp__claude-flow__memory_namespace
-    - mcp__claude-flow__memory_compress
-    - mcp__claude-flow__memory_sync
-  restricted:
-    - Write
-    - Edit
-    - Bash
-triggers:
-  - pattern: "memory|remember|store.*context|retrieve.*data"
-    priority: high
-  - keyword: "memory-manager"
----
-```
-
-#### Neural Pattern Agent
-**Command**: `.claude/commands/memory/neural.md`
-```yaml
----
-role: ai-specialist
-name: Neural Pattern Coordinator
-responsibilities:
-  - Train and manage neural patterns
-  - Coordinate cognitive behavior analysis
-  - Implement adaptive learning strategies
-  - Optimize AI model performance
-capabilities:
-  - neural-training
-  - pattern-recognition
-  - cognitive-analysis
-  - model-optimization
-  - transfer-learning
-tools:
-  allowed:
-    - mcp__claude-flow__neural_train
-    - mcp__claude-flow__neural_patterns
-    - mcp__claude-flow__neural_predict
-    - mcp__claude-flow__cognitive_analyze
-    - mcp__claude-flow__learning_adapt
-  restricted:
-    - Write
-    - Edit
-    - Bash
-triggers:
-  - pattern: "neural|ai.*pattern|cognitive|machine.*learning"
-    priority: high
-  - keyword: "neural-patterns"
----
-```
-
-### 6. Automation Agents
-
-#### Smart Agent Coordinator
-**Command**: `.claude/commands/automation/smart-agents.md`
-```yaml
----
-role: automation-specialist
-name: Smart Agent Coordinator
-responsibilities:
-  - Automate agent spawning based on task requirements
-  - Implement intelligent capability matching
-  - Manage dynamic agent allocation
-  - Optimize resource utilization
-capabilities:
-  - intelligent-spawning
-  - capability-matching
-  - resource-optimization
-  - pattern-learning
-  - auto-scaling
-tools:
-  allowed:
-    - mcp__claude-flow__daa_agent_create
-    - mcp__claude-flow__daa_capability_match
-    - mcp__claude-flow__daa_resource_alloc
-    - mcp__claude-flow__swarm_scale
-    - mcp__claude-flow__agent_metrics
-  restricted:
-    - Write
-    - Edit
-    - Bash
-triggers:
-  - pattern: "smart.*agent|auto.*spawn|intelligent.*coordination"
-    priority: high
-  - keyword: "smart-agents"
----
-```
-
-#### Self-Healing Coordinator Agent
-**Command**: `.claude/commands/automation/self-healing.md`
-```yaml
----
-role: reliability-engineer
-name: Self-Healing System Coordinator
-responsibilities:
-  - Detect and recover from system failures
-  - Implement fault tolerance strategies
-  - Coordinate automatic recovery procedures
-  - Monitor system health continuously
-capabilities:
-  - fault-detection
-  - automatic-recovery
-  - health-monitoring
-  - resilience-planning
-  - error-analysis
-tools:
-  allowed:
-    - mcp__claude-flow__daa_fault_tolerance
-    - mcp__claude-flow__health_check
-    - mcp__claude-flow__error_analysis
-    - mcp__claude-flow__diagnostic_run
-    - Bash  # For system commands
-  restricted:
-    - Write  # Prevent accidental file modifications during recovery
-    - Edit
-triggers:
-  - pattern: "self.*heal|auto.*recover|fault.*toleran|system.*health"
-    priority: high
-  - keyword: "self-healing"
----
-```
-
-### 7. Optimization Agents
-
-#### Parallel Execution Optimizer Agent
-**Command**: `.claude/commands/optimization/parallel-execution.md`
-```yaml
----
-role: optimizer
-name: Parallel Execution Optimizer
-responsibilities:
-  - Optimize task execution for parallelism
-  - Identify parallelization opportunities
-  - Coordinate concurrent operations
-  - Monitor parallel execution efficiency
-capabilities:
-  - parallelization-analysis
-  - execution-optimization
-  - load-balancing
-  - performance-monitoring
-  - bottleneck-removal
-tools:
-  allowed:
-    - mcp__claude-flow__parallel_execute
-    - mcp__claude-flow__load_balance
-    - mcp__claude-flow__batch_process
-    - mcp__claude-flow__performance_report
-    - TodoWrite
-  restricted:
-    - Write
-    - Edit
-triggers:
-  - pattern: "parallel|concurrent|simultaneous|batch.*execution"
-    priority: high
-  - keyword: "parallel-optimizer"
----
-```
-
-#### Auto-Topology Optimizer Agent
-**Command**: `.claude/commands/optimization/auto-topology.md`
-```yaml
----
-role: optimizer
-name: Topology Optimization Specialist
-responsibilities:
-  - Analyze and optimize swarm topology
-  - Adapt topology based on workload
-  - Balance communication overhead
-  - Ensure optimal agent distribution
-capabilities:
-  - topology-analysis
-  - graph-optimization
-  - network-design
-  - load-distribution
-  - adaptive-configuration
-tools:
-  allowed:
-    - mcp__claude-flow__topology_optimize
-    - mcp__claude-flow__swarm_monitor
-    - mcp__claude-flow__coordination_sync
-    - mcp__claude-flow__swarm_status
-    - mcp__claude-flow__metrics_collect
-  restricted:
-    - Write
-    - Edit
-    - Bash
-triggers:
-  - pattern: "topology|optimize.*swarm|network.*structure"
-    priority: medium
-  - keyword: "topology-optimizer"
----
-```
-
-### 8. Monitoring Agents
-
-#### Swarm Monitor Agent
-**Command**: `.claude/commands/monitoring/status.md`
-```yaml
----
-role: monitor
-name: Swarm Status Monitor
-responsibilities:
-  - Monitor swarm health and performance
-  - Track agent status and utilization
-  - Generate real-time status reports
-  - Alert on anomalies or failures
-capabilities:
-  - health-monitoring
-  - performance-tracking
-  - status-reporting
-  - anomaly-detection
-  - alert-generation
-tools:
-  allowed:
-    - mcp__claude-flow__swarm_status
-    - mcp__claude-flow__swarm_monitor
-    - mcp__claude-flow__agent_metrics
-    - mcp__claude-flow__health_check
-    - mcp__claude-flow__performance_report
-  restricted:
-    - Write
-    - Edit
-    - Bash
-triggers:
-  - pattern: "monitor|status|health.*check|swarm.*status"
-    priority: medium
-  - keyword: "swarm-monitor"
----
-```
-
-## Implementation Guidelines
-
-### 1. Agent Activation
-- Agents are activated by pattern matching in user messages
-- Higher priority patterns take precedence
-- Multiple agents can be activated for complex tasks
-
-### 2. Tool Restrictions
-- Each agent has specific allowed and restricted tools
-- Restrictions ensure agents stay within their domain
-- Critical operations require specialized agents
-
-### 3. Inter-Agent Communication
-- Agents communicate through shared memory
-- Task orchestrator coordinates multi-agent workflows
-- Results are aggregated by coordinator agents
-
-### 4. Migration Steps
-1. Create `.claude/agents/` directory structure
-2. Convert each command to agent definition format
-3. Update activation patterns for natural language
-4. Test agent interactions and handoffs
-5. Implement gradual rollout with fallbacks
-
-### 5. Backwards Compatibility
-- Keep command files during transition
-- Map command invocations to agent activations
-- Provide migration warnings for deprecated commands
-
-## Monitoring Migration Success
-
-### Key Metrics
-- Agent activation accuracy
-- Task completion rates
-- Inter-agent coordination efficiency
-- User satisfaction scores
-- Performance improvements
-
-### Validation Criteria
-- All commands have equivalent agents
-- No functionality loss during migration
-- Improved natural language understanding
-- Better task decomposition and parallelization
-- Enhanced error handling and recovery