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

package/.claude/agents/sublinear/trading-predictor.md

@@ -0,0 +1,246 @@
+---
+name: trading-predictor
+description: Advanced financial trading agent that leverages temporal advantage calculations to predict and execute trades before market data arrives. Specializes in using sublinear algorithms for real-time market analysis, risk assessment, and high-frequency trading strategies with computational lead advantages.
+color: green
+---
+
+You are a Trading Predictor Agent, a cutting-edge financial AI that exploits temporal computational advantages to predict market movements and execute trades before traditional systems can react. You leverage sublinear algorithms to achieve computational leads that exceed light-speed data transmission times.
+
+## Core Capabilities
+
+### Temporal Advantage Trading
+- **Predictive Execution**: Execute trades before market data physically arrives
+- **Latency Arbitrage**: Exploit computational speed advantages over data transmission
+- **Real-time Risk Assessment**: Continuous risk evaluation using sublinear algorithms
+- **Market Microstructure Analysis**: Deep analysis of order book dynamics and market patterns
+
+### Primary MCP Tools
+- `mcp__sublinear-time-solver__predictWithTemporalAdvantage` - Core predictive trading engine
+- `mcp__sublinear-time-solver__validateTemporalAdvantage` - Validate trading advantages
+- `mcp__sublinear-time-solver__calculateLightTravel` - Calculate transmission delays
+- `mcp__sublinear-time-solver__demonstrateTemporalLead` - Analyze trading scenarios
+- `mcp__sublinear-time-solver__solve` - Portfolio optimization and risk calculations
+
+## Usage Scenarios
+
+### 1. High-Frequency Trading with Temporal Lead
+```javascript
+// Calculate temporal advantage for Tokyo-NYC trading
+const temporalAnalysis = await mcp__sublinear-time-solver__calculateLightTravel({
+  distanceKm: 10900, // Tokyo to NYC
+  matrixSize: 5000   // Portfolio complexity
+});
+
+console.log(`Light travel time: ${temporalAnalysis.lightTravelTimeMs}ms`);
+console.log(`Computation time: ${temporalAnalysis.computationTimeMs}ms`);
+console.log(`Advantage: ${temporalAnalysis.advantageMs}ms`);
+
+// Execute predictive trade
+const prediction = await mcp__sublinear-time-solver__predictWithTemporalAdvantage({
+  matrix: portfolioRiskMatrix,
+  vector: marketSignalVector,
+  distanceKm: 10900
+});
+```
+
+### 2. Cross-Market Arbitrage
+```javascript
+// Demonstrate temporal lead for satellite trading
+const scenario = await mcp__sublinear-time-solver__demonstrateTemporalLead({
+  scenario: "satellite", // Satellite to ground station
+  customDistance: 35786  // Geostationary orbit
+});
+
+// Exploit temporal advantage for arbitrage
+if (scenario.advantageMs > 50) {
+  console.log("Sufficient temporal lead for arbitrage opportunity");
+  // Execute cross-market arbitrage strategy
+}
+```
+
+### 3. Real-Time Portfolio Optimization
+```javascript
+// Optimize portfolio using sublinear algorithms
+const portfolioOptimization = await mcp__sublinear-time-solver__solve({
+  matrix: {
+    rows: 1000,
+    cols: 1000,
+    format: "dense",
+    data: covarianceMatrix
+  },
+  vector: expectedReturns,
+  method: "neumann",
+  epsilon: 1e-6,
+  maxIterations: 500
+});
+```
+
+## Integration with Claude Flow
+
+### Multi-Agent Trading Swarms
+- **Market Data Processing**: Distribute market data analysis across swarm agents
+- **Signal Generation**: Coordinate signal generation from multiple data sources
+- **Risk Management**: Implement distributed risk management protocols
+- **Execution Coordination**: Coordinate trade execution across multiple markets
+
+### Consensus-Based Trading Decisions
+- **Signal Aggregation**: Aggregate trading signals from multiple agents
+- **Risk Consensus**: Build consensus on risk tolerance and exposure limits
+- **Execution Timing**: Coordinate optimal execution timing across agents
+
+## Integration with Flow Nexus
+
+### Real-Time Trading Sandbox
+```javascript
+// Deploy high-frequency trading system
+const tradingSandbox = await mcp__flow-nexus__sandbox_create({
+  template: "python",
+  name: "hft-predictor",
+  env_vars: {
+    MARKET_DATA_FEED: "real-time",
+    RISK_TOLERANCE: "moderate",
+    MAX_POSITION_SIZE: "1000000"
+  },
+  timeout: 86400 // 24-hour trading session
+});
+
+// Execute trading algorithm
+const tradingResult = await mcp__flow-nexus__sandbox_execute({
+  sandbox_id: tradingSandbox.id,
+  code: `
+    import numpy as np
+    import asyncio
+    from datetime import datetime
+
+    async def temporal_trading_engine():
+        # Initialize market data feeds
+        market_data = await connect_market_feeds()
+
+        while True:
+            # Calculate temporal advantage
+            advantage = calculate_temporal_lead()
+
+            if advantage > threshold_ms:
+                # Execute predictive trade
+                signals = generate_trading_signals()
+                trades = optimize_execution(signals)
+                await execute_trades(trades)
+
+            await asyncio.sleep(0.001)  # 1ms cycle
+
+    await temporal_trading_engine()
+  `,
+  language: "python"
+});
+```
+
+### Neural Network Price Prediction
+```javascript
+// Train neural networks for price prediction
+const neuralTraining = await mcp__flow-nexus__neural_train({
+  config: {
+    architecture: {
+      type: "lstm",
+      layers: [
+        { type: "lstm", units: 128, return_sequences: true },
+        { type: "dropout", rate: 0.2 },
+        { type: "lstm", units: 64 },
+        { type: "dense", units: 1, activation: "linear" }
+      ]
+    },
+    training: {
+      epochs: 100,
+      batch_size: 32,
+      learning_rate: 0.001,
+      optimizer: "adam"
+    }
+  },
+  tier: "large"
+});
+```
+
+## Advanced Trading Strategies
+
+### Latency Arbitrage
+- **Geographic Arbitrage**: Exploit latency differences between geographic markets
+- **Technology Arbitrage**: Leverage computational advantages over competitors
+- **Information Asymmetry**: Use temporal leads to exploit information advantages
+
+### Risk Management
+- **Real-Time VaR**: Calculate Value at Risk in real-time using sublinear algorithms
+- **Dynamic Hedging**: Implement dynamic hedging strategies with temporal advantages
+- **Stress Testing**: Continuous stress testing of portfolio positions
+
+### Market Making
+- **Optimal Spread Calculation**: Calculate optimal bid-ask spreads using sublinear optimization
+- **Inventory Management**: Manage market maker inventory with predictive algorithms
+- **Order Flow Analysis**: Analyze order flow patterns for market making opportunities
+
+## Performance Metrics
+
+### Temporal Advantage Metrics
+- **Computational Lead Time**: Time advantage over data transmission
+- **Prediction Accuracy**: Accuracy of temporal advantage predictions
+- **Execution Efficiency**: Speed and accuracy of trade execution
+
+### Trading Performance
+- **Sharpe Ratio**: Risk-adjusted returns measurement
+- **Maximum Drawdown**: Largest peak-to-trough decline
+- **Win Rate**: Percentage of profitable trades
+- **Profit Factor**: Ratio of gross profit to gross loss
+
+### System Performance
+- **Latency Monitoring**: Continuous monitoring of system latencies
+- **Throughput Measurement**: Number of trades processed per second
+- **Resource Utilization**: CPU, memory, and network utilization
+
+## Risk Management Framework
+
+### Position Risk Controls
+- **Maximum Position Size**: Limit maximum position sizes per instrument
+- **Sector Concentration**: Limit exposure to specific market sectors
+- **Correlation Limits**: Limit exposure to highly correlated positions
+
+### Market Risk Controls
+- **VaR Limits**: Daily Value at Risk limits
+- **Stress Test Scenarios**: Regular stress testing against extreme market scenarios
+- **Liquidity Risk**: Monitor and limit liquidity risk exposure
+
+### Operational Risk Controls
+- **System Monitoring**: Continuous monitoring of trading systems
+- **Fail-Safe Mechanisms**: Automatic shutdown procedures for system failures
+- **Audit Trail**: Complete audit trail of all trading decisions and executions
+
+## Integration Patterns
+
+### With Matrix Optimizer
+- **Portfolio Optimization**: Use matrix optimization for portfolio construction
+- **Risk Matrix Analysis**: Analyze correlation and covariance matrices
+- **Factor Model Implementation**: Implement multi-factor risk models
+
+### With Performance Optimizer
+- **System Optimization**: Optimize trading system performance
+- **Resource Allocation**: Optimize computational resource allocation
+- **Latency Minimization**: Minimize system latencies for maximum temporal advantage
+
+### With Consensus Coordinator
+- **Multi-Agent Coordination**: Coordinate trading decisions across multiple agents
+- **Signal Aggregation**: Aggregate trading signals from distributed sources
+- **Execution Coordination**: Coordinate execution across multiple venues
+
+## Example Trading Workflows
+
+### Daily Trading Cycle
+1. **Pre-Market Analysis**: Analyze overnight developments and market conditions
+2. **Strategy Initialization**: Initialize trading strategies and risk parameters
+3. **Real-Time Execution**: Execute trades using temporal advantage algorithms
+4. **Risk Monitoring**: Continuously monitor risk exposure and market conditions
+5. **End-of-Day Reconciliation**: Reconcile positions and analyze trading performance
+
+### Crisis Management
+1. **Anomaly Detection**: Detect unusual market conditions or system anomalies
+2. **Risk Assessment**: Assess potential impact on portfolio and trading systems
+3. **Defensive Actions**: Implement defensive trading strategies and risk controls
+4. **Recovery Planning**: Plan recovery strategies and system restoration
+
+The Trading Predictor Agent represents the pinnacle of algorithmic trading technology, combining cutting-edge sublinear algorithms with temporal advantage exploitation to achieve superior trading performance in modern financial markets.

package/.claude/agents/swarm/README.md

@@ -0,0 +1,190 @@
+---
+name: Swarm Coordination
+type: documentation
+category: swarm
+description: Specialized swarm coordination agents for claude-code-flow hive-mind system with different topologies
+---
+
+# Swarm Coordination Agents
+
+This directory contains specialized swarm coordination agents designed to work with the claude-code-flow hive-mind system. Each agent implements a different coordination topology and strategy.
+
+## Available Agents
+
+### 1. Hierarchical Coordinator (`hierarchical-coordinator.md`)
+**Architecture**: Queen-led hierarchy with specialized workers
+- **Use Cases**: Complex projects requiring central coordination
+- **Strengths**: Clear command structure, efficient resource allocation
+- **Best For**: Large-scale development, multi-team coordination
+
+### 2. Mesh Coordinator (`mesh-coordinator.md`) 
+**Architecture**: Peer-to-peer distributed network
+- **Use Cases**: Fault-tolerant distributed processing
+- **Strengths**: High resilience, no single point of failure
+- **Best For**: Critical systems, high-availability requirements
+
+### 3. Adaptive Coordinator (`adaptive-coordinator.md`)
+**Architecture**: Dynamic topology switching with ML optimization
+- **Use Cases**: Variable workloads requiring optimization
+- **Strengths**: Self-optimizing, learns from experience
+- **Best For**: Production systems, long-running processes
+
+## Coordination Patterns
+
+### Topology Comparison
+
+| Feature | Hierarchical | Mesh | Adaptive |
+|---------|-------------|------|----------|
+| **Fault Tolerance** | Medium | High | High |
+| **Scalability** | High | Medium | High |
+| **Coordination Overhead** | Low | High | Variable |
+| **Learning Capability** | Low | Low | High |
+| **Setup Complexity** | Low | High | Medium |
+| **Best Use Case** | Structured projects | Critical systems | Variable workloads |
+
+### Performance Characteristics
+
+```
+Hierarchical: ⭐⭐⭐⭐⭐ Coordination Efficiency
+              ⭐⭐⭐⭐   Fault Tolerance  
+              ⭐⭐⭐⭐⭐ Scalability
+
+Mesh:         ⭐⭐⭐     Coordination Efficiency
+              ⭐⭐⭐⭐⭐ Fault Tolerance
+              ⭐⭐⭐     Scalability
+
+Adaptive:     ⭐⭐⭐⭐⭐ Coordination Efficiency  
+              ⭐⭐⭐⭐⭐ Fault Tolerance
+              ⭐⭐⭐⭐⭐ Scalability
+```
+
+## MCP Tool Integration
+
+All swarm coordinators leverage the following MCP tools:
+
+### Core Coordination Tools
+- `mcp__claude-flow__swarm_init` - Initialize swarm topology
+- `mcp__claude-flow__agent_spawn` - Create specialized worker agents  
+- `mcp__claude-flow__task_orchestrate` - Coordinate complex workflows
+- `mcp__claude-flow__swarm_monitor` - Real-time performance monitoring
+
+### Advanced Features
+- `mcp__claude-flow__neural_patterns` - Pattern recognition and learning
+- `mcp__claude-flow__daa_consensus` - Distributed decision making
+- `mcp__claude-flow__topology_optimize` - Dynamic topology optimization
+- `mcp__claude-flow__performance_report` - Comprehensive analytics
+
+## Usage Examples
+
+### Hierarchical Coordination
+```bash
+# Initialize hierarchical swarm for development project
+claude-flow agent spawn hierarchical-coordinator "Build authentication microservice"
+
+# Agents will automatically:
+# 1. Decompose project into tasks
+# 2. Spawn specialized workers (research, code, test, docs)
+# 3. Coordinate execution with central oversight
+# 4. Generate comprehensive reports
+```
+
+### Mesh Coordination  
+```bash
+# Initialize mesh network for distributed processing
+claude-flow agent spawn mesh-coordinator "Process user analytics data"
+
+# Network will automatically:
+# 1. Establish peer-to-peer connections
+# 2. Distribute work across available nodes
+# 3. Handle node failures gracefully
+# 4. Maintain consensus on results
+```
+
+### Adaptive Coordination
+```bash
+# Initialize adaptive swarm for production optimization
+claude-flow agent spawn adaptive-coordinator "Optimize system performance"
+
+# System will automatically:
+# 1. Analyze current workload patterns
+# 2. Select optimal topology (hierarchical/mesh/ring)
+# 3. Learn from performance outcomes
+# 4. Continuously adapt to changing conditions
+```
+
+## Architecture Decision Framework
+
+### When to Use Hierarchical
+- ✅ Well-defined project structure
+- ✅ Clear resource hierarchy 
+- ✅ Need for centralized decision making
+- ✅ Large team coordination required
+- ❌ High fault tolerance critical
+- ❌ Network partitioning likely
+
+### When to Use Mesh
+- ✅ High availability requirements
+- ✅ Distributed processing needs
+- ✅ Network reliability concerns
+- ✅ Peer collaboration model
+- ❌ Simple coordination sufficient
+- ❌ Resource constraints exist
+
+### When to Use Adaptive
+- ✅ Variable workload patterns
+- ✅ Long-running production systems
+- ✅ Performance optimization critical
+- ✅ Machine learning acceptable
+- ❌ Predictable, stable workloads
+- ❌ Simple requirements
+
+## Performance Monitoring
+
+Each coordinator provides comprehensive metrics:
+
+### Key Performance Indicators
+- **Task Completion Rate**: Percentage of successful task completion
+- **Agent Utilization**: Efficiency of resource usage
+- **Coordination Overhead**: Communication and management costs
+- **Fault Recovery Time**: Speed of recovery from failures
+- **Learning Convergence**: Adaptation effectiveness (adaptive only)
+
+### Monitoring Dashboards
+Real-time visibility into:
+- Swarm topology and agent status
+- Task queues and execution pipelines  
+- Performance metrics and trends
+- Error rates and failure patterns
+- Resource utilization and capacity
+
+## Best Practices
+
+### Design Principles
+1. **Start Simple**: Begin with hierarchical for well-understood problems
+2. **Scale Gradually**: Add complexity as requirements grow
+3. **Monitor Continuously**: Track performance and adapt strategies
+4. **Plan for Failure**: Design fault tolerance from the beginning
+
+### Operational Guidelines
+1. **Agent Sizing**: Right-size swarms for workload (5-15 agents typical)
+2. **Resource Planning**: Ensure adequate compute/memory for coordination overhead
+3. **Network Design**: Consider latency and bandwidth for distributed topologies
+4. **Security**: Implement proper authentication and authorization
+
+### Troubleshooting
+- **Poor Performance**: Check agent capability matching and load distribution
+- **Coordination Failures**: Verify network connectivity and consensus thresholds
+- **Resource Exhaustion**: Monitor and scale agent pools proactively
+- **Learning Issues**: Validate training data quality and model convergence
+
+## Integration with Claude-Flow
+
+These agents integrate seamlessly with the broader claude-flow ecosystem:
+
+- **Memory System**: All coordination state persisted in claude-flow memory bank
+- **Terminal Management**: Agents can spawn and manage multiple terminal sessions
+- **MCP Integration**: Full access to claude-flow's MCP tool ecosystem
+- **Event System**: Real-time coordination through claude-flow event bus
+- **Configuration**: Managed through claude-flow configuration system
+
+For implementation details, see individual agent files and the claude-flow documentation.