agent-migration-plan

--- 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