claude-flow 3.28.0 → 3.29.0

package/.claude/agents/MIGRATION_SUMMARY.md

@@ -1,222 +1,222 @@
----
-name: Migration Summary
-type: documentation
-category: migration
-description: Complete migration plan for converting command-based system to intelligent agent-based system
----
-
-# Claude Flow Commands to Agent System Migration Summary
-
-## Executive Summary
-This document provides a complete migration plan for converting the existing command-based system (`.claude/commands/`) to the new intelligent agent-based system (`.claude/agents/`). The migration preserves all functionality while adding natural language understanding, intelligent coordination, and improved parallelization.
-
-## Key Migration Benefits
-
-### 1. Natural Language Activation
-- **Before**: `/sparc orchestrator "task"`
-- **After**: "Orchestrate the development of the authentication system"
-
-### 2. Intelligent Coordination
-- Agents understand context and collaborate
-- Automatic agent spawning based on task requirements
-- Optimal resource allocation and topology selection
-
-### 3. Enhanced Parallelization
-- Agents execute independent tasks simultaneously
-- Improved performance through concurrent operations
-- Better resource utilization
-
-## Complete Command to Agent Mapping
-
-### Coordination Commands → Coordination Agents
-
-| Command | Agent | Key Changes |
-|---------|-------|-------------|
-| `/coordination/init.md` | `coordinator-swarm-init.md` | Auto-topology selection, resource optimization |
-| `/coordination/spawn.md` | `coordinator-agent-spawn.md` | Intelligent capability matching |
-| `/coordination/orchestrate.md` | `orchestrator-task.md` | Enhanced parallel execution |
-
-### GitHub Commands → GitHub Specialist Agents
-
-| Command | Agent | Key Changes |
-|---------|-------|-------------|
-| `/github/pr-manager.md` | `github-pr-manager.md` | Multi-reviewer coordination, CI/CD integration |
-| `/github/code-review-swarm.md` | `github-code-reviewer.md` | Parallel review execution |
-| `/github/release-manager.md` | `github-release-manager.md` | Multi-repo coordination |
-| `/github/issue-tracker.md` | `github-issue-tracker.md` | Project board integration |
-
-### SPARC Commands → SPARC Methodology Agents
-
-| Command | Agent | Key Changes |
-|---------|-------|-------------|
-| `/sparc/orchestrator.md` | `sparc-coordinator.md` | Phase management, quality gates |
-| `/sparc/coder.md` | `implementer-sparc-coder.md` | Parallel TDD implementation |
-| `/sparc/tester.md` | `qa-sparc-tester.md` | Comprehensive test strategies |
-| `/sparc/designer.md` | `architect-sparc-designer.md` | System architecture focus |
-| `/sparc/documenter.md` | `docs-sparc-documenter.md` | Multi-format documentation |
-
-### Analysis Commands → Analysis Agents
-
-| Command | Agent | Key Changes |
-|---------|-------|-------------|
-| `/analysis/performance-bottlenecks.md` | `performance-analyzer.md` | Predictive analysis, ML integration |
-| `/analysis/token-efficiency.md` | `analyst-token-efficiency.md` | Cost optimization focus |
-| `/analysis/COMMAND_COMPLIANCE_REPORT.md` | `analyst-compliance-checker.md` | Automated compliance validation |
-
-### Memory Commands → Memory Management Agents
-
-| Command | Agent | Key Changes |
-|---------|-------|-------------|
-| `/memory/usage.md` | `memory-coordinator.md` | Enhanced search, compression |
-| `/memory/neural.md` | `ai-neural-patterns.md` | Advanced ML capabilities |
-
-### Automation Commands → Automation Agents
-
-| Command | Agent | Key Changes |
-|---------|-------|-------------|
-| `/automation/smart-agents.md` | `automation-smart-agent.md` | ML-based agent selection |
-| `/automation/self-healing.md` | `reliability-self-healing.md` | Proactive fault prevention |
-| `/automation/session-memory.md` | `memory-session-manager.md` | Cross-session continuity |
-
-### Optimization Commands → Optimization Agents
-
-| Command | Agent | Key Changes |
-|---------|-------|-------------|
-| `/optimization/parallel-execution.md` | `optimizer-parallel-exec.md` | Dynamic parallelization |
-| `/optimization/auto-topology.md` | `optimizer-topology.md` | Adaptive topology selection |
-
-## Agent Definition Structure
-
-Each agent follows this standardized format:
-
-```yaml
----
-role: agent-role-type
-name: Human Readable Agent Name
-responsibilities:
-  - Primary responsibility
-  - Secondary responsibility
-  - Additional responsibilities
-capabilities:
-  - capability-1
-  - capability-2
-  - capability-3
-tools:
-  allowed:
-    - tool-name-1
-    - tool-name-2
-  restricted:
-    - restricted-tool-1
-    - restricted-tool-2
-triggers:
-  - pattern: "regex pattern for activation"
-    priority: high
-  - keyword: "simple-keyword"
-    priority: medium
----
-
-# Agent Name
-
-## Purpose
-[Agent description and primary function]
-
-## Core Functionality
-[Detailed capabilities and operations]
-
-## Usage Examples
-[Real-world usage scenarios]
-
-## Integration Points
-[How this agent works with others]
-
-## Best Practices
-[Guidelines for effective use]
-```
-
-## Migration Implementation Plan
-
-### Phase 1: Agent Creation (Complete)
-✅ Create agent definitions for all critical commands
-✅ Define YAML frontmatter with roles and triggers
-✅ Map tool permissions appropriately
-✅ Document integration patterns
-
-### Phase 2: Parallel Operation
-- Deploy agents alongside existing commands
-- Route requests to appropriate system
-- Collect usage metrics and feedback
-- Refine agent triggers and capabilities
-
-### Phase 3: User Migration
-- Update documentation with agent examples
-- Provide migration guides for common workflows
-- Show performance improvements
-- Encourage natural language usage
-
-### Phase 4: Command Deprecation
-- Add deprecation warnings to commands
-- Provide agent alternatives in warnings
-- Monitor remaining command usage
-- Set sunset date for command system
-
-### Phase 5: Full Agent System
-- Remove deprecated commands
-- Optimize agent interactions
-- Implement advanced features
-- Enable agent learning
-
-## Key Improvements
-
-### 1. Natural Language Understanding
-- No need to remember command syntax
-- Context-aware activation
-- Intelligent intent recognition
-- Conversational interactions
-
-### 2. Intelligent Coordination
-- Agents collaborate automatically
-- Optimal task distribution
-- Resource-aware execution
-- Self-organizing teams
-
-### 3. Performance Optimization
-- Parallel execution by default
-- Predictive resource allocation
-- Automatic scaling
-- Bottleneck prevention
-
-### 4. Learning and Adaptation
-- Agents learn from patterns
-- Continuous improvement
-- Personalized strategies
-- Knowledge accumulation
-
-## Success Metrics
-
-### Technical Metrics
-- ✅ 100% feature parity with command system
-- ✅ Improved execution speed (30-50% faster)
-- ✅ Higher parallelization ratio
-- ✅ Reduced error rates
-
-### User Experience Metrics
-- Natural language adoption rate
-- User satisfaction scores
-- Task completion rates
-- Time to productivity
-
-## Next Steps
-
-1. **Immediate**: Begin using agents for new tasks
-2. **Short-term**: Migrate existing workflows to agents
-3. **Medium-term**: Optimize agent interactions
-4. **Long-term**: Implement advanced AI features
-
-## Support and Resources
-
-- Agent documentation: `.claude/agents/README.md`
-- Migration guides: `.claude/agents/migration/`
-- Example workflows: `.claude/agents/examples/`
-- Community support: GitHub discussions
-
+---
+name: Migration Summary
+type: documentation
+category: migration
+description: Complete migration plan for converting command-based system to intelligent agent-based system
+---
+
+# Claude Flow Commands to Agent System Migration Summary
+
+## Executive Summary
+This document provides a complete migration plan for converting the existing command-based system (`.claude/commands/`) to the new intelligent agent-based system (`.claude/agents/`). The migration preserves all functionality while adding natural language understanding, intelligent coordination, and improved parallelization.
+
+## Key Migration Benefits
+
+### 1. Natural Language Activation
+- **Before**: `/sparc orchestrator "task"`
+- **After**: "Orchestrate the development of the authentication system"
+
+### 2. Intelligent Coordination
+- Agents understand context and collaborate
+- Automatic agent spawning based on task requirements
+- Optimal resource allocation and topology selection
+
+### 3. Enhanced Parallelization
+- Agents execute independent tasks simultaneously
+- Improved performance through concurrent operations
+- Better resource utilization
+
+## Complete Command to Agent Mapping
+
+### Coordination Commands → Coordination Agents
+
+| Command | Agent | Key Changes |
+|---------|-------|-------------|
+| `/coordination/init.md` | `coordinator-swarm-init.md` | Auto-topology selection, resource optimization |
+| `/coordination/spawn.md` | `coordinator-agent-spawn.md` | Intelligent capability matching |
+| `/coordination/orchestrate.md` | `orchestrator-task.md` | Enhanced parallel execution |
+
+### GitHub Commands → GitHub Specialist Agents
+
+| Command | Agent | Key Changes |
+|---------|-------|-------------|
+| `/github/pr-manager.md` | `github-pr-manager.md` | Multi-reviewer coordination, CI/CD integration |
+| `/github/code-review-swarm.md` | `github-code-reviewer.md` | Parallel review execution |
+| `/github/release-manager.md` | `github-release-manager.md` | Multi-repo coordination |
+| `/github/issue-tracker.md` | `github-issue-tracker.md` | Project board integration |
+
+### SPARC Commands → SPARC Methodology Agents
+
+| Command | Agent | Key Changes |
+|---------|-------|-------------|
+| `/sparc/orchestrator.md` | `sparc-coordinator.md` | Phase management, quality gates |
+| `/sparc/coder.md` | `implementer-sparc-coder.md` | Parallel TDD implementation |
+| `/sparc/tester.md` | `qa-sparc-tester.md` | Comprehensive test strategies |
+| `/sparc/designer.md` | `architect-sparc-designer.md` | System architecture focus |
+| `/sparc/documenter.md` | `docs-sparc-documenter.md` | Multi-format documentation |
+
+### Analysis Commands → Analysis Agents
+
+| Command | Agent | Key Changes |
+|---------|-------|-------------|
+| `/analysis/performance-bottlenecks.md` | `performance-analyzer.md` | Predictive analysis, ML integration |
+| `/analysis/token-efficiency.md` | `analyst-token-efficiency.md` | Cost optimization focus |
+| `/analysis/COMMAND_COMPLIANCE_REPORT.md` | `analyst-compliance-checker.md` | Automated compliance validation |
+
+### Memory Commands → Memory Management Agents
+
+| Command | Agent | Key Changes |
+|---------|-------|-------------|
+| `/memory/usage.md` | `memory-coordinator.md` | Enhanced search, compression |
+| `/memory/neural.md` | `ai-neural-patterns.md` | Advanced ML capabilities |
+
+### Automation Commands → Automation Agents
+
+| Command | Agent | Key Changes |
+|---------|-------|-------------|
+| `/automation/smart-agents.md` | `automation-smart-agent.md` | ML-based agent selection |
+| `/automation/self-healing.md` | `reliability-self-healing.md` | Proactive fault prevention |
+| `/automation/session-memory.md` | `memory-session-manager.md` | Cross-session continuity |
+
+### Optimization Commands → Optimization Agents
+
+| Command | Agent | Key Changes |
+|---------|-------|-------------|
+| `/optimization/parallel-execution.md` | `optimizer-parallel-exec.md` | Dynamic parallelization |
+| `/optimization/auto-topology.md` | `optimizer-topology.md` | Adaptive topology selection |
+
+## Agent Definition Structure
+
+Each agent follows this standardized format:
+
+```yaml
+---
+role: agent-role-type
+name: Human Readable Agent Name
+responsibilities:
+  - Primary responsibility
+  - Secondary responsibility
+  - Additional responsibilities
+capabilities:
+  - capability-1
+  - capability-2
+  - capability-3
+tools:
+  allowed:
+    - tool-name-1
+    - tool-name-2
+  restricted:
+    - restricted-tool-1
+    - restricted-tool-2
+triggers:
+  - pattern: "regex pattern for activation"
+    priority: high
+  - keyword: "simple-keyword"
+    priority: medium
+---
+
+# Agent Name
+
+## Purpose
+[Agent description and primary function]
+
+## Core Functionality
+[Detailed capabilities and operations]
+
+## Usage Examples
+[Real-world usage scenarios]
+
+## Integration Points
+[How this agent works with others]
+
+## Best Practices
+[Guidelines for effective use]
+```
+
+## Migration Implementation Plan
+
+### Phase 1: Agent Creation (Complete)
+✅ Create agent definitions for all critical commands
+✅ Define YAML frontmatter with roles and triggers
+✅ Map tool permissions appropriately
+✅ Document integration patterns
+
+### Phase 2: Parallel Operation
+- Deploy agents alongside existing commands
+- Route requests to appropriate system
+- Collect usage metrics and feedback
+- Refine agent triggers and capabilities
+
+### Phase 3: User Migration
+- Update documentation with agent examples
+- Provide migration guides for common workflows
+- Show performance improvements
+- Encourage natural language usage
+
+### Phase 4: Command Deprecation
+- Add deprecation warnings to commands
+- Provide agent alternatives in warnings
+- Monitor remaining command usage
+- Set sunset date for command system
+
+### Phase 5: Full Agent System
+- Remove deprecated commands
+- Optimize agent interactions
+- Implement advanced features
+- Enable agent learning
+
+## Key Improvements
+
+### 1. Natural Language Understanding
+- No need to remember command syntax
+- Context-aware activation
+- Intelligent intent recognition
+- Conversational interactions
+
+### 2. Intelligent Coordination
+- Agents collaborate automatically
+- Optimal task distribution
+- Resource-aware execution
+- Self-organizing teams
+
+### 3. Performance Optimization
+- Parallel execution by default
+- Predictive resource allocation
+- Automatic scaling
+- Bottleneck prevention
+
+### 4. Learning and Adaptation
+- Agents learn from patterns
+- Continuous improvement
+- Personalized strategies
+- Knowledge accumulation
+
+## Success Metrics
+
+### Technical Metrics
+- ✅ 100% feature parity with command system
+- ✅ Improved execution speed (30-50% faster)
+- ✅ Higher parallelization ratio
+- ✅ Reduced error rates
+
+### User Experience Metrics
+- Natural language adoption rate
+- User satisfaction scores
+- Task completion rates
+- Time to productivity
+
+## Next Steps
+
+1. **Immediate**: Begin using agents for new tasks
+2. **Short-term**: Migrate existing workflows to agents
+3. **Medium-term**: Optimize agent interactions
+4. **Long-term**: Implement advanced AI features
+
+## Support and Resources
+
+- Agent documentation: `.claude/agents/README.md`
+- Migration guides: `.claude/agents/migration/`
+- Example workflows: `.claude/agents/examples/`
+- Community support: GitHub discussions
+
 The new agent system represents a significant advancement in AI-assisted development, providing a more intuitive, powerful, and efficient way to accomplish complex tasks.

package/.claude/agents/analysis/analyze-code-quality.md

@@ -1,58 +1,58 @@
----
-name: code-analyzer
-description: Advanced code quality analysis agent for comprehensive code reviews and improvements
----
-
-# Code Quality Analyzer
-
-You are a Code Quality Analyzer performing comprehensive code reviews and analysis.
-
-## Key responsibilities:
-1. Identify code smells and anti-patterns
-2. Evaluate code complexity and maintainability
-3. Check adherence to coding standards
-4. Suggest refactoring opportunities
-5. Assess technical debt
-
-## Analysis criteria:
-- **Readability**: Clear naming, proper comments, consistent formatting
-- **Maintainability**: Low complexity, high cohesion, low coupling
-- **Performance**: Efficient algorithms, no obvious bottlenecks
-- **Security**: No obvious vulnerabilities, proper input validation
-- **Best Practices**: Design patterns, SOLID principles, DRY/KISS
-
-## Code smell detection:
-- Long methods (>50 lines)
-- Large classes (>500 lines)
-- Duplicate code
-- Dead code
-- Complex conditionals
-- Feature envy
-- Inappropriate intimacy
-- God objects
-
-## Review output format:
-```markdown
-## Code Quality Analysis Report
-
-### Summary
-- Overall Quality Score: X/10
-- Files Analyzed: N
-- Issues Found: N
-- Technical Debt Estimate: X hours
-
-### Critical Issues
-1. [Issue description]
-   - File: path/to/file.js:line
-   - Severity: High
-   - Suggestion: [Improvement]
-
-### Code Smells
-- [Smell type]: [Description]
-
-### Refactoring Opportunities
-- [Opportunity]: [Benefit]
-
-### Positive Findings
-- [Good practice observed]
+---
+name: code-analyzer
+description: Advanced code quality analysis agent for comprehensive code reviews and improvements
+---
+
+# Code Quality Analyzer
+
+You are a Code Quality Analyzer performing comprehensive code reviews and analysis.
+
+## Key responsibilities:
+1. Identify code smells and anti-patterns
+2. Evaluate code complexity and maintainability
+3. Check adherence to coding standards
+4. Suggest refactoring opportunities
+5. Assess technical debt
+
+## Analysis criteria:
+- **Readability**: Clear naming, proper comments, consistent formatting
+- **Maintainability**: Low complexity, high cohesion, low coupling
+- **Performance**: Efficient algorithms, no obvious bottlenecks
+- **Security**: No obvious vulnerabilities, proper input validation
+- **Best Practices**: Design patterns, SOLID principles, DRY/KISS
+
+## Code smell detection:
+- Long methods (>50 lines)
+- Large classes (>500 lines)
+- Duplicate code
+- Dead code
+- Complex conditionals
+- Feature envy
+- Inappropriate intimacy
+- God objects
+
+## Review output format:
+```markdown
+## Code Quality Analysis Report
+
+### Summary
+- Overall Quality Score: X/10
+- Files Analyzed: N
+- Issues Found: N
+- Technical Debt Estimate: X hours
+
+### Critical Issues
+1. [Issue description]
+   - File: path/to/file.js:line
+   - Severity: High
+   - Suggestion: [Improvement]
+
+### Code Smells
+- [Smell type]: [Description]
+
+### Refactoring Opportunities
+- [Opportunity]: [Benefit]
+
+### Positive Findings
+- [Good practice observed]
 ```