agentic-flow 1.0.0

package/.claude/agents/goal/goal-planner.md

@@ -0,0 +1,73 @@
+---
+name: goal-planner
+description: "Goal-Oriented Action Planning (GOAP) specialist that dynamically creates intelligent plans to achieve complex objectives. Uses gaming AI techniques to discover novel solutions by combining actions in creative ways. Excels at adaptive replanning, multi-step reasoning, and finding optimal paths through complex state spaces."
+color: purple
+---
+
+You are a Goal-Oriented Action Planning (GOAP) specialist, an advanced AI planner that uses intelligent algorithms to dynamically create optimal action sequences for achieving complex objectives. Your expertise combines gaming AI techniques with practical software engineering to discover novel solutions through creative action composition.
+
+Your core capabilities:
+- **Dynamic Planning**: Use A* search algorithms to find optimal paths through state spaces
+- **Precondition Analysis**: Evaluate action requirements and dependencies
+- **Effect Prediction**: Model how actions change world state
+- **Adaptive Replanning**: Adjust plans based on execution results and changing conditions
+- **Goal Decomposition**: Break complex objectives into achievable sub-goals
+- **Cost Optimization**: Find the most efficient path considering action costs
+- **Novel Solution Discovery**: Combine known actions in creative ways
+- **Mixed Execution**: Blend LLM-based reasoning with deterministic code actions
+- **Tool Group Management**: Match actions to available tools and capabilities
+- **Domain Modeling**: Work with strongly-typed state representations
+- **Continuous Learning**: Update planning strategies based on execution feedback
+
+Your planning methodology follows the GOAP algorithm:
+
+1. **State Assessment**:
+   - Analyze current world state (what is true now)
+   - Define goal state (what should be true)
+   - Identify the gap between current and goal states
+
+2. **Action Analysis**:
+   - Inventory available actions with their preconditions and effects
+   - Determine which actions are currently applicable
+   - Calculate action costs and priorities
+
+3. **Plan Generation**:
+   - Use A* pathfinding to search through possible action sequences
+   - Evaluate paths based on cost and heuristic distance to goal
+   - Generate optimal plan that transforms current state to goal state
+
+4. **Execution Monitoring** (OODA Loop):
+   - **Observe**: Monitor current state and execution progress
+   - **Orient**: Analyze changes and deviations from expected state
+   - **Decide**: Determine if replanning is needed
+   - **Act**: Execute next action or trigger replanning
+
+5. **Dynamic Replanning**:
+   - Detect when actions fail or produce unexpected results
+   - Recalculate optimal path from new current state
+   - Adapt to changing conditions and new information
+
+## MCP Integration Examples
+
+```javascript
+// Orchestrate complex goal achievement
+mcp__claude-flow__task_orchestrate {
+  task: "achieve_production_deployment",
+  strategy: "adaptive",
+  priority: "high"
+}
+
+// Coordinate with swarm for parallel planning
+mcp__claude-flow__swarm_init {
+  topology: "hierarchical",
+  maxAgents: 5
+}
+
+// Store successful plans for reuse
+mcp__claude-flow__memory_usage {
+  action: "store",
+  namespace: "goap-plans",
+  key: "deployment_plan_v1",
+  value: JSON.stringify(successful_plan)
+}
+```

package/.claude/agents/optimization/README.md

@@ -0,0 +1,250 @@
+---
+name: Performance Optimization
+type: documentation
+category: optimization
+description: Comprehensive suite of performance optimization agents for swarm efficiency and scalability
+---
+
+# Performance Optimization Agents
+
+This directory contains a comprehensive suite of performance optimization agents designed to maximize swarm efficiency, scalability, and reliability.
+
+## Agent Overview
+
+### 1. Load Balancing Coordinator (`load-balancer.md`)
+**Purpose**: Dynamic task distribution and resource allocation optimization
+- **Key Features**:
+  - Work-stealing algorithms for efficient task distribution
+  - Dynamic load balancing based on agent capacity
+  - Advanced scheduling algorithms (Round Robin, Weighted Fair Queuing, CFS)
+  - Queue management and prioritization systems
+  - Circuit breaker patterns for fault tolerance
+
+### 2. Performance Monitor (`performance-monitor.md`)
+**Purpose**: Real-time metrics collection and bottleneck analysis
+- **Key Features**:
+  - Multi-dimensional metrics collection (CPU, memory, network, agents)
+  - Advanced bottleneck detection using multiple algorithms
+  - SLA monitoring and alerting with threshold management
+  - Anomaly detection using statistical and ML models
+  - Real-time dashboard integration with WebSocket streaming
+
+### 3. Topology Optimizer (`topology-optimizer.md`)
+**Purpose**: Dynamic swarm topology reconfiguration and network optimization
+- **Key Features**:
+  - Intelligent topology selection (hierarchical, mesh, ring, star, hybrid)
+  - Network latency optimization and routing strategies
+  - AI-powered agent placement using genetic algorithms
+  - Communication pattern optimization and protocol selection
+  - Neural network integration for topology prediction
+
+### 4. Resource Allocator (`resource-allocator.md`)
+**Purpose**: Adaptive resource allocation and predictive scaling
+- **Key Features**:
+  - Workload pattern analysis and adaptive allocation
+  - ML-powered predictive scaling with LSTM and reinforcement learning
+  - Multi-objective resource optimization using genetic algorithms
+  - Advanced circuit breaker patterns with adaptive thresholds
+  - Comprehensive performance profiling with flame graphs
+
+### 5. Benchmark Suite (`benchmark-suite.md`)
+**Purpose**: Comprehensive performance benchmarking and validation
+- **Key Features**:
+  - Automated performance testing (load, stress, volume, endurance)
+  - Performance regression detection using multiple algorithms
+  - SLA validation and quality assessment frameworks
+  - Continuous integration with CI/CD pipelines
+  - Error pattern analysis and trend detection
+
+## Architecture Overview
+
+```
+┌─────────────────────────────────────────────────────┐
+│                 MCP Integration Layer                │
+├─────────────────────────────────────────────────────┤
+│  Performance  │  Load        │  Topology  │  Resource │
+│  Monitor      │  Balancer    │  Optimizer │  Allocator│
+├─────────────────────────────────────────────────────┤
+│              Benchmark Suite & Validation           │
+├─────────────────────────────────────────────────────┤
+│           Swarm Infrastructure Integration           │
+└─────────────────────────────────────────────────────┘
+```
+
+## Key Performance Features
+
+### Advanced Algorithms
+- **Genetic Algorithms**: For topology optimization and resource allocation
+- **Simulated Annealing**: For topology reconfiguration optimization
+- **Reinforcement Learning**: For adaptive scaling decisions
+- **Machine Learning**: For anomaly detection and predictive analytics
+- **Work-Stealing**: For efficient task distribution
+
+### Monitoring & Analytics
+- **Real-time Metrics**: CPU, memory, network, agent performance
+- **Bottleneck Detection**: Multi-algorithm approach for identifying performance issues
+- **Trend Analysis**: Historical performance pattern recognition
+- **Predictive Analytics**: ML-based forecasting for resource needs
+- **Cost Optimization**: Resource efficiency and cost analysis
+
+### Fault Tolerance
+- **Circuit Breaker Patterns**: Adaptive thresholds for system protection
+- **Bulkhead Isolation**: Resource pool separation for failure containment
+- **Graceful Degradation**: Fallback mechanisms for service continuity
+- **Recovery Strategies**: Automated system recovery and healing
+
+### Integration Capabilities
+- **MCP Tools**: Extensive use of claude-flow MCP performance tools
+- **Real-time Dashboards**: WebSocket-based live performance monitoring
+- **CI/CD Integration**: Automated performance validation in deployment pipelines
+- **Alert Systems**: Multi-channel notification for performance issues
+
+## Usage Examples
+
+### Basic Optimization Workflow
+```bash
+# 1. Start performance monitoring
+npx claude-flow swarm-monitor --swarm-id production --interval 30
+
+# 2. Analyze current performance
+npx claude-flow performance-report --format detailed --timeframe 24h
+
+# 3. Optimize topology if needed
+npx claude-flow topology-optimize --swarm-id production --strategy adaptive
+
+# 4. Load balance based on current metrics
+npx claude-flow load-balance --swarm-id production --strategy work-stealing
+
+# 5. Scale resources predictively
+npx claude-flow swarm-scale --swarm-id production --target-size auto
+```
+
+### Comprehensive Benchmarking
+```bash
+# Run full benchmark suite
+npx claude-flow benchmark-run --suite comprehensive --duration 300
+
+# Validate against SLA requirements
+npx claude-flow quality-assess --target swarm-performance --criteria throughput,latency,reliability
+
+# Detect performance regressions
+npx claude-flow detect-regression --current latest-results.json --historical baseline.json
+```
+
+### Advanced Resource Management
+```bash
+# Analyze resource patterns
+npx claude-flow metrics-collect --components ["cpu", "memory", "network", "agents"]
+
+# Optimize resource allocation
+npx claude-flow daa-resource-alloc --resources optimal-config.json
+
+# Profile system performance
+npx claude-flow profile-performance --duration 60000 --components all
+```
+
+## Performance Optimization Strategies
+
+### 1. Reactive Optimization
+- Monitor performance metrics in real-time
+- Detect bottlenecks and performance issues
+- Apply immediate optimizations (load balancing, resource reallocation)
+- Validate optimization effectiveness
+
+### 2. Predictive Optimization
+- Analyze historical performance patterns
+- Predict future resource needs and bottlenecks
+- Proactively scale resources and adjust configurations
+- Prevent performance degradation before it occurs
+
+### 3. Adaptive Optimization
+- Continuously learn from system behavior
+- Adapt optimization strategies based on workload patterns
+- Self-tune parameters and thresholds
+- Evolve topology and resource allocation strategies
+
+## Integration with Swarm Infrastructure
+
+### Core Swarm Components
+- **Task Orchestrator**: Coordinates task distribution with load balancing
+- **Agent Coordinator**: Manages agent lifecycle with resource considerations
+- **Memory System**: Stores optimization history and learned patterns
+- **Communication Layer**: Optimizes message routing and protocols
+
+### External Systems
+- **Monitoring Systems**: Grafana, Prometheus integration
+- **Alert Managers**: PagerDuty, Slack, email notifications
+- **CI/CD Pipelines**: Jenkins, GitHub Actions, GitLab CI
+- **Cost Management**: Cloud provider cost optimization tools
+
+## Performance Metrics & KPIs
+
+### System Performance
+- **Throughput**: Requests/tasks per second
+- **Latency**: Response time percentiles (P50, P90, P95, P99)
+- **Availability**: System uptime and reliability
+- **Resource Utilization**: CPU, memory, network efficiency
+
+### Optimization Effectiveness
+- **Load Balance Variance**: Distribution of work across agents
+- **Scaling Efficiency**: Resource scaling response time and accuracy
+- **Topology Optimization Impact**: Communication latency improvement
+- **Cost Efficiency**: Performance per dollar metrics
+
+### Quality Assurance
+- **SLA Compliance**: Meeting defined service level agreements
+- **Regression Detection**: Catching performance degradations
+- **Error Rates**: System failure and recovery metrics
+- **User Experience**: End-to-end performance from user perspective
+
+## Best Practices
+
+### Performance Monitoring
+1. Establish baseline performance metrics
+2. Set up automated alerting for critical thresholds
+3. Monitor trends, not just point-in-time metrics
+4. Correlate performance with business metrics
+
+### Optimization Implementation
+1. Test optimizations in staging environments first
+2. Implement gradual rollouts for major changes
+3. Maintain rollback capabilities for all optimizations
+4. Document optimization decisions and their impacts
+
+### Continuous Improvement
+1. Regular performance reviews and optimization cycles
+2. Automated regression testing in CI/CD pipelines
+3. Capacity planning based on growth projections
+4. Knowledge sharing and optimization pattern libraries
+
+## Troubleshooting Guide
+
+### Common Performance Issues
+1. **High CPU Usage**: Check for inefficient algorithms, infinite loops
+2. **Memory Leaks**: Monitor memory growth patterns, object retention
+3. **Network Bottlenecks**: Analyze communication patterns, optimize protocols
+4. **Load Imbalance**: Review task distribution algorithms, agent capacity
+
+### Optimization Failures
+1. **Topology Changes Not Effective**: Verify network constraints, communication patterns
+2. **Scaling Not Responsive**: Check predictive model accuracy, threshold tuning
+3. **Circuit Breakers Triggering**: Analyze failure patterns, adjust thresholds
+4. **Resource Allocation Conflicts**: Review constraint definitions, priority settings
+
+## Future Enhancements
+
+### Planned Features
+- **Advanced AI Models**: GPT-based optimization recommendations
+- **Multi-Cloud Optimization**: Cross-cloud resource optimization
+- **Edge Computing Support**: Edge node performance optimization
+- **Real-time Visualization**: 3D performance visualization dashboards
+
+### Research Areas
+- **Quantum-Inspired Algorithms**: For complex optimization problems
+- **Federated Learning**: For distributed performance model training
+- **Autonomous Systems**: Self-healing and self-optimizing swarms
+- **Sustainability Metrics**: Energy efficiency and carbon footprint optimization
+
+---
+
+For detailed implementation guides and API documentation, refer to the individual agent files in this directory.