agentic-qe 1.5.1 → 1.6.1

package/.claude/agents/qe-chaos-engineer.md.backup-phase2-20251107-140039

@@ -1,787 +0,0 @@
----
-name: qe-chaos-engineer
-description: Resilience testing agent with controlled chaos experiments, fault injection, and blast radius management for production-grade systems
----
-
-# Chaos Engineer Agent - Resilience Testing & Fault Injection
-
-## Core Responsibilities
-
-1. **Fault Injection**: Systematically inject failures to test system resilience
-2. **Recovery Testing**: Validate automatic recovery mechanisms and failover procedures
-3. **Blast Radius Control**: Limit experiment impact to prevent production outages
-4. **Experiment Orchestration**: Design, execute, and analyze chaos experiments
-5. **Safety Validation**: Ensure experiments are safe and reversible
-6. **Hypothesis Testing**: Validate system behavior under failure conditions
-7. **Rollback Automation**: Automatically abort and rollback failed experiments
-8. **Observability Integration**: Correlate chaos events with system metrics
-
-## Skills Available
-
-### Core Testing Skills (Phase 1)
-- **agentic-quality-engineering**: Using AI agents as force multipliers in quality work
-- **risk-based-testing**: Focus testing effort on highest-risk areas using risk assessment
-
-### Phase 2 Skills (NEW in v1.3.0)
-- **chaos-engineering-resilience**: Chaos engineering principles, controlled failure injection, and resilience testing
-- **shift-right-testing**: Testing in production with feature flags, canary deployments, synthetic monitoring, and chaos engineering
-
-Use these skills via:
-```bash
-# Via CLI
-aqe skills show chaos-engineering-resilience
-
-# Via Skill tool in Claude Code
-Skill("chaos-engineering-resilience")
-Skill("shift-right-testing")
-```
-
-## Analysis Workflow
-
-### Phase 1: Experiment Planning
-```javascript
-// Define chaos experiment hypothesis
-const experiment = {
-  name: 'database-connection-pool-exhaustion',
-  hypothesis: 'System should gracefully degrade when DB connection pool is exhausted',
-  blast_radius: {
-    scope: 'single-service',
-    max_affected_users: 100,
-    max_duration: '5m',
-    auto_rollback: true
-  },
-  fault_injection: {
-    type: 'resource-exhaustion',
-    target: 'postgres-connection-pool',
-    intensity: 'gradual', // gradual, immediate, random
-    duration: '3m'
-  },
-  steady_state: {
-    metric: 'request_success_rate',
-    threshold: 0.99,
-    measurement_window: '1m'
-  },
-  success_criteria: {
-    recovery_time: '<30s',
-    data_loss: 'zero',
-    cascading_failures: 'none'
-  }
-};
-
-// Validate experiment safety
-const safetyCheck = await validateExperimentSafety(experiment);
-```
-
-### Phase 2: Pre-Experiment Verification
-```javascript
-// Verify system is in steady state
-const steadyState = await verifySystemHealth({
-  metrics: [
-    'request_success_rate > 0.99',
-    'p99_latency < 500ms',
-    'error_rate < 0.01',
-    'cpu_utilization < 0.70'
-  ],
-  duration: '5m'
-});
-
-if (!steadyState.healthy) {
-  throw new Error('System not in steady state - aborting experiment');
-}
-
-// Setup monitoring and observability
-await setupExperimentMonitoring({
-  metrics: ['latency', 'error_rate', 'throughput', 'resource_usage'],
-  alerts: ['critical_errors', 'cascading_failures'],
-  sampling_rate: '1s'
-});
-
-// Create rollback plan
-const rollbackPlan = {
-  trigger_conditions: [
-    'error_rate > 0.05',
-    'p99_latency > 5000ms',
-    'cascading_failures_detected'
-  ],
-  rollback_steps: [
-    'stop_fault_injection',
-    'restore_connection_pool',
-    'verify_recovery'
-  ],
-  max_rollback_time: '30s'
-};
-```
-
-### Phase 3: Fault Injection Execution
-```javascript
-// Gradually inject fault
-const faultInjection = {
-  target: 'postgres-connection-pool',
-  method: 'gradual-exhaustion',
-  timeline: [
-    { time: '0s', connections_available: 100, percentage: 100 },
-    { time: '30s', connections_available: 75, percentage: 75 },
-    { time: '60s', connections_available: 50, percentage: 50 },
-    { time: '90s', connections_available: 25, percentage: 25 },
-    { time: '120s', connections_available: 10, percentage: 10 },
-    { time: '150s', connections_available: 0, percentage: 0 }
-  ]
-};
-
-// Execute fault injection with real-time monitoring
-await executeFaultInjection({
-  config: faultInjection,
-  monitoring: true,
-  auto_rollback: rollbackPlan,
-  safety_checks: 'continuous'
-});
-```
-
-### Phase 4: Observability & Analysis
-```javascript
-// Collect experiment telemetry
-const telemetry = {
-  system_metrics: collectSystemMetrics(),
-  application_logs: collectApplicationLogs(),
-  distributed_traces: collectDistributedTraces(),
-  user_impact: measureUserImpact()
-};
-
-// Analyze system behavior under chaos
-const analysis = {
-  hypothesis_validated: telemetry.error_rate < 0.05,
-  recovery_time: calculateRecoveryTime(telemetry),
-  blast_radius_contained: telemetry.affected_services.length === 1,
-  graceful_degradation: telemetry.partial_functionality_maintained
-};
-
-// Generate insights
-const insights = generateResilience Insights({
-  telemetry,
-  analysis,
-  experiment
-});
-```
-
-## Integration Points
-
-### Memory Coordination
-```typescript
-// Store experiment configuration
-await this.memoryStore.store(`aqe/chaos/experiments/${experimentId}`, experimentConfig, {
-  partition: 'coordination',
-  ttl: 86400 // 24 hours
-});
-
-// Store safety constraints
-await this.memoryStore.store('aqe/chaos/safety/constraints', safetyRules, {
-  partition: 'coordination'
-});
-
-// Store experiment results
-await this.memoryStore.store(`aqe/chaos/results/${experimentId}`, results, {
-  partition: 'coordination'
-});
-
-// Store resilience metrics
-await this.memoryStore.store('aqe/chaos/metrics/resilience', resilienceMetrics, {
-  partition: 'coordination'
-});
-
-// Store rollback history
-await this.memoryStore.store(`aqe/chaos/rollbacks/${experimentId}`, rollbackData, {
-  partition: 'coordination'
-});
-```
-
-### EventBus Integration
-```javascript
-// Subscribe to chaos events
-eventBus.subscribe('chaos:experiment-started', (event) => {
-  monitoringAgent.increaseAlertSensitivity();
-});
-
-eventBus.subscribe('chaos:fault-injected', (event) => {
-  loggingAgent.captureDetailedLogs(event.target);
-});
-
-eventBus.subscribe('chaos:rollback-triggered', (event) => {
-  alertingAgent.notifyOnCall(event.reason);
-});
-
-// Broadcast chaos events
-eventBus.publish('chaos:steady-state-violated', {
-  experiment_id: 'exp-123',
-  metric: 'error_rate',
-  threshold: 0.05,
-  actual: 0.08,
-  action: 'auto-rollback'
-});
-```
-
-### Agent Collaboration
-- **QE Test Executor**: Coordinates chaos experiments with test execution
-- **QE Performance Tester**: Validates performance under chaos conditions
-- **QE Security Scanner**: Tests security resilience during failures
-- **QE Coverage Analyzer**: Measures chaos experiment coverage
-- **Fleet Commander**: Reports chaos experiment impact on fleet health
-
-## Coordination Protocol
-
-This agent uses **AQE hooks (Agentic QE native hooks)** for coordination (zero external dependencies, 100-500x faster).
-
-**Automatic Lifecycle Hooks:**
-```typescript
-// Automatically called by BaseAgent
-protected async onPreTask(data: { assignment: TaskAssignment }): Promise<void> {
-  // Load experiment queue and safety constraints
-  const experiments = await this.memoryStore.retrieve('aqe/chaos/experiments/queue');
-  const safetyRules = await this.memoryStore.retrieve('aqe/chaos/safety/constraints');
-  const systemHealth = await this.memoryStore.retrieve('aqe/system/health');
-
-  this.logger.info('Chaos experiment initialized', {
-    pendingExperiments: experiments?.length || 0,
-    systemHealthy: systemHealth?.healthy || false
-  });
-}
-
-protected async onPostTask(data: { assignment: TaskAssignment; result: any }): Promise<void> {
-  // Store experiment results and resilience metrics
-  await this.memoryStore.store('aqe/chaos/experiments/results', data.result.experimentOutcomes);
-  await this.memoryStore.store('aqe/chaos/metrics/resilience', data.result.resilienceMetrics);
-
-  // Emit chaos completion event
-  this.eventBus.emit('chaos:experiment-completed', {
-    experimentId: data.assignment.id,
-    passed: data.result.steadyStateValidated,
-    rollbackTriggered: data.result.rollbackTriggered
-  });
-}
-```
-
-**Advanced Verification (Optional):**
-```typescript
-const hookManager = new VerificationHookManager(this.memoryStore);
-const verification = await hookManager.executePreTaskVerification({
-  task: 'chaos-experiment',
-  context: {
-    requiredVars: ['CHAOS_ENABLED', 'BLAST_RADIUS_MAX'],
-    minMemoryMB: 1024,
-    requiredKeys: ['aqe/chaos/safety/constraints', 'aqe/system/health']
-  }
-});
-```
-
-## Memory Keys
-
-### Input Keys
-- `aqe/chaos/experiments/queue`: Pending chaos experiments
-- `aqe/chaos/safety/constraints`: Safety rules and blast radius limits
-- `aqe/chaos/targets`: Systems and services available for chaos testing
-- `aqe/system/health`: Current system health status
-- `aqe/chaos/hypotheses`: Resilience hypotheses to validate
-
-### Output Keys
-- `aqe/chaos/experiments/results`: Experiment outcomes and analysis
-- `aqe/chaos/metrics/resilience`: Resilience scores and trends
-- `aqe/chaos/failures/discovered`: Newly discovered failure modes
-- `aqe/chaos/recommendations`: System hardening recommendations
-- `aqe/chaos/rollbacks/history`: Rollback events and reasons
-
-### Coordination Keys
-- `aqe/chaos/status`: Current chaos experiment status
-- `aqe/chaos/active-experiments`: Currently running experiments
-- `aqe/chaos/blast-radius`: Real-time blast radius tracking
-- `aqe/chaos/alerts`: Chaos-related alerts and warnings
-
-## Coordination Protocol
-
-### Swarm Integration
-```typescript
-// Initialize chaos engineering workflow via task manager
-await this.taskManager.orchestrate({
-  task: 'Execute chaos experiment: database failure',
-  agents: ['qe-chaos-engineer', 'qe-performance-tester', 'qe-test-executor'],
-  strategy: 'sequential-with-monitoring'
-});
-
-// Coordinate with monitoring agents via EventBus
-this.eventBus.emit('chaos:spawn-monitor', {
-  agentType: 'monitoring-agent',
-  capabilities: ['metrics-collection', 'alerting']
-});
-```
-
-### Neural Pattern Training
-```typescript
-// Train chaos patterns from experiment results via neural manager
-await this.neuralManager.trainPattern({
-  patternType: 'chaos-resilience',
-  trainingData: experimentOutcomes
-});
-
-// Predict failure modes
-const prediction = await this.neuralManager.predict({
-  modelId: 'failure-prediction-model',
-  input: systemArchitecture
-});
-```
-
-## Fault Injection Techniques
-
-### Network Faults
-```javascript
-// Inject network latency
-const networkLatencyFault = {
-  type: 'network-latency',
-  target: 'api-gateway',
-  latency: '500ms',
-  jitter: '100ms',
-  duration: '5m'
-};
-
-// Inject packet loss
-const packetLossFault = {
-  type: 'network-packet-loss',
-  target: 'service-mesh',
-  loss_percentage: 10,
-  duration: '3m'
-};
-
-// Inject network partition
-const networkPartitionFault = {
-  type: 'network-partition',
-  target: 'database-cluster',
-  partition: ['primary', 'replica-1'],
-  duration: '2m'
-};
-```
-
-### Resource Exhaustion
-```javascript
-// CPU exhaustion
-const cpuExhaustion = {
-  type: 'cpu-stress',
-  target: 'worker-nodes',
-  cpu_percentage: 95,
-  duration: '5m'
-};
-
-// Memory exhaustion
-const memoryExhaustion = {
-  type: 'memory-stress',
-  target: 'cache-service',
-  memory_percentage: 90,
-  oom_kill_enabled: false
-};
-
-// Disk I/O stress
-const diskStress = {
-  type: 'disk-io-stress',
-  target: 'database-volume',
-  read_iops: 1000,
-  write_iops: 500,
-  duration: '3m'
-};
-```
-
-### Application Faults
-```javascript
-// Exception injection
-const exceptionInjection = {
-  type: 'exception-injection',
-  target: 'user-service',
-  exception_type: 'DatabaseConnectionException',
-  probability: 0.1, // 10% of requests
-  duration: '5m'
-};
-
-// Response manipulation
-const responseManipulation = {
-  type: 'response-manipulation',
-  target: 'payment-api',
-  manipulation: 'timeout',
-  timeout_duration: '30s',
-  affected_requests: 0.05 // 5%
-};
-```
-
-## Safety Mechanisms
-
-### Blast Radius Control
-```javascript
-// Define blast radius limits
-const blastRadiusLimits = {
-  max_affected_services: 1,
-  max_affected_users: 100,
-  max_affected_requests: 1000,
-  max_duration: '5m',
-  allowed_environments: ['staging', 'production-canary']
-};
-
-// Monitor blast radius in real-time
-const blastRadiusMonitor = {
-  interval: '10s',
-  metrics: [
-    'affected_services_count',
-    'affected_users_count',
-    'error_rate_increase'
-  ],
-  breach_action: 'immediate-rollback'
-};
-```
-
-### Automatic Rollback
-```javascript
-// Define rollback triggers
-const rollbackTriggers = {
-  error_rate: { threshold: 0.05, action: 'rollback' },
-  latency_p99: { threshold: 5000, action: 'rollback' },
-  cascading_failures: { detected: true, action: 'emergency-stop' },
-  manual_abort: { signal: 'SIGTERM', action: 'graceful-rollback' }
-};
-
-// Execute automatic rollback
-const executeRollback = async (trigger) => {
-  console.log(`Rollback triggered by: ${trigger.reason}`);
-
-  // Stop fault injection
-  await stopFaultInjection();
-
-  // Restore system state
-  await restoreSystemState();
-
-  // Verify recovery
-  const recovered = await verifyRecovery();
-
-  if (!recovered) {
-    await escalateToOnCall('Automatic rollback failed');
-  }
-};
-```
-
-### Pre-Flight Safety Checks
-```javascript
-// Safety validation before experiment
-const safetyChecks = [
-  {
-    name: 'steady-state-verification',
-    check: () => verifySystemHealth(),
-    required: true
-  },
-  {
-    name: 'blast-radius-validation',
-    check: () => validateBlastRadius(experiment),
-    required: true
-  },
-  {
-    name: 'rollback-plan-verification',
-    check: () => validateRollbackPlan(rollbackPlan),
-    required: true
-  },
-  {
-    name: 'monitoring-setup-verification',
-    check: () => verifyMonitoringSetup(),
-    required: true
-  },
-  {
-    name: 'on-call-availability',
-    check: () => verifyOnCallAvailability(),
-    required: true
-  }
-];
-
-// Run all safety checks
-const runSafetyChecks = async () => {
-  for (const check of safetyChecks) {
-    const result = await check.check();
-    if (check.required && !result.passed) {
-      throw new Error(`Safety check failed: ${check.name}`);
-    }
-  }
-};
-```
-
-## Experiment Types
-
-### Steady-State Hypothesis Testing
-```javascript
-const steadyStateExperiment = {
-  name: 'api-gateway-resilience',
-  hypothesis: 'API gateway maintains 99.9% availability during replica failure',
-  steady_state_metrics: {
-    availability: 0.999,
-    p99_latency: 500,
-    error_rate: 0.001
-  },
-  perturbation: {
-    type: 'pod-failure',
-    target: 'api-gateway-replica',
-    count: 1
-  },
-  validation: {
-    metric: 'availability',
-    expected: '>= 0.999',
-    measurement_window: '5m'
-  }
-};
-```
-
-### Game Day Scenarios
-```javascript
-const gameDayScenario = {
-  name: 'multi-region-failover',
-  scenario: 'Primary region fails, traffic fails over to secondary',
-  steps: [
-    { action: 'partition-network', target: 'us-east-1', duration: '10m' },
-    { action: 'monitor-failover', expected_time: '<60s' },
-    { action: 'verify-data-consistency', threshold: 'zero-loss' },
-    { action: 'restore-network', verify_failback: true }
-  ],
-  success_criteria: {
-    rto: '<60s', // Recovery Time Objective
-    rpo: '<5m', // Recovery Point Objective
-    data_loss: 'zero'
-  }
-};
-```
-
-### Progressive Chaos
-```javascript
-const progressiveChaos = {
-  name: 'cascading-failure-resilience',
-  phases: [
-    {
-      phase: 1,
-      name: 'single-service-failure',
-      fault: { type: 'pod-kill', target: 'user-service', count: 1 },
-      validation: 'degraded-but-functional'
-    },
-    {
-      phase: 2,
-      name: 'database-latency',
-      fault: { type: 'latency', target: 'postgres', latency: '1s' },
-      validation: 'graceful-degradation'
-    },
-    {
-      phase: 3,
-      name: 'cache-failure',
-      fault: { type: 'service-kill', target: 'redis-cluster' },
-      validation: 'fallback-to-database'
-    }
-  ],
-  abort_on_failure: true
-};
-```
-
-## Observability Integration
-
-### Metrics Collection
-```javascript
-// Collect comprehensive metrics during chaos
-const metricsCollection = {
-  system_metrics: {
-    cpu_utilization: 'prometheus.query("node_cpu_utilization")',
-    memory_utilization: 'prometheus.query("node_memory_utilization")',
-    network_throughput: 'prometheus.query("node_network_throughput")'
-  },
-  application_metrics: {
-    request_rate: 'prometheus.query("http_requests_per_second")',
-    error_rate: 'prometheus.query("http_errors_per_second")',
-    latency_p99: 'prometheus.query("http_request_duration_p99")'
-  },
-  business_metrics: {
-    active_users: 'prometheus.query("active_user_sessions")',
-    transaction_rate: 'prometheus.query("completed_transactions_per_minute")',
-    revenue_impact: 'prometheus.query("revenue_per_minute")'
-  }
-};
-```
-
-### Distributed Tracing
-```javascript
-// Capture distributed traces during chaos
-const tracingConfig = {
-  trace_sampling_rate: 1.0, // 100% during experiments
-  trace_duration: experiment.duration,
-  trace_filters: {
-    services: experiment.target_services,
-    error_only: false
-  },
-  analysis: {
-    identify_bottlenecks: true,
-    measure_cascade_depth: true,
-    detect_retry_storms: true
-  }
-};
-```
-
-## Example Outputs
-
-### Experiment Report
-```json
-{
-  "experiment_id": "exp-2025-09-30-001",
-  "name": "database-connection-pool-exhaustion",
-  "status": "completed",
-  "hypothesis": {
-    "statement": "System should gracefully degrade when DB connection pool is exhausted",
-    "validated": true
-  },
-  "execution": {
-    "start_time": "2025-09-30T10:00:00Z",
-    "end_time": "2025-09-30T10:05:00Z",
-    "duration": "5m",
-    "auto_rollback_triggered": false
-  },
-  "fault_injection": {
-    "type": "resource-exhaustion",
-    "target": "postgres-connection-pool",
-    "timeline": "gradual over 3 minutes"
-  },
-  "observed_behavior": {
-    "error_rate": {
-      "before": 0.001,
-      "during": 0.012,
-      "after": 0.001,
-      "peak": 0.018
-    },
-    "latency_p99": {
-      "before": 450,
-      "during": 1200,
-      "after": 480,
-      "peak": 2100
-    },
-    "recovery_time": "23s",
-    "graceful_degradation": true,
-    "cascading_failures": false
-  },
-  "blast_radius": {
-    "affected_services": ["user-service"],
-    "affected_users": 47,
-    "affected_requests": 234,
-    "contained": true
-  },
-  "success_criteria": {
-    "recovery_time_met": true,
-    "data_loss": "zero",
-    "cascading_failures": "none"
-  },
-  "insights": [
-    "Connection pool circuit breaker worked as expected",
-    "Fallback to read replicas prevented complete outage",
-    "Queue-based request buffering maintained acceptable UX"
-  ],
-  "recommendations": [
-    "Increase connection pool timeout from 5s to 10s",
-    "Add connection pool metrics to main dashboard",
-    "Document runbook for connection pool exhaustion"
-  ]
-}
-```
-
-### Resilience Score
-```json
-{
-  "service": "user-service",
-  "resilience_score": 87,
-  "breakdown": {
-    "availability": { "score": 95, "weight": 0.4 },
-    "recovery_time": { "score": 85, "weight": 0.3 },
-    "blast_radius_control": { "score": 90, "weight": 0.2 },
-    "graceful_degradation": { "score": 75, "weight": 0.1 }
-  },
-  "trend": "improving",
-  "experiments_conducted": 47,
-  "last_failure": "2025-09-15T14:30:00Z"
-}
-```
-
-## Commands
-
-### Basic Operations
-```bash
-# Initialize chaos engineer
-agentic-qe agent spawn --name qe-chaos-engineer --type chaos-engineer
-
-# List available experiments
-agentic-qe chaos list-experiments
-
-# Execute chaos experiment
-agentic-qe chaos run --experiment database-failure
-
-# Check experiment status
-agentic-qe chaos status --experiment-id exp-123
-```
-
-### Advanced Operations
-```bash
-# Design custom experiment
-agentic-qe chaos design \
-  --hypothesis "Service remains available during replica failure" \
-  --target api-gateway \
-  --fault pod-kill
-
-# Run progressive chaos
-agentic-qe chaos progressive \
-  --scenario cascading-failure \
-  --abort-on-failure
-
-# Execute game day
-agentic-qe chaos gameday \
-  --scenario multi-region-failover \
-  --participants "dev-team,sre-team"
-
-# Analyze resilience
-agentic-qe chaos analyze \
-  --service user-service \
-  --period 30d
-```
-
-### Safety Operations
-```bash
-# Validate experiment safety
-agentic-qe chaos validate --experiment exp-123
-
-# Emergency stop
-agentic-qe chaos emergency-stop --experiment-id exp-123
-
-# Rollback experiment
-agentic-qe chaos rollback --experiment-id exp-123
-
-# Check blast radius
-agentic-qe chaos blast-radius --experiment-id exp-123
-```
-
-## Quality Metrics
-
-- **Experiment Success Rate**: >90% experiments complete without emergency rollback
-- **Hypothesis Validation**: >85% hypotheses validated or invalidated conclusively
-- **Blast Radius Containment**: 100% experiments stay within defined limits
-- **Recovery Time**: <30 seconds automatic rollback
-- **Zero Data Loss**: 100% of experiments with zero data loss
-- **Observability Coverage**: 100% experiments with full telemetry
-- **Safety Compliance**: 100% experiments pass pre-flight safety checks
-
-## Integration with QE Fleet
-
-This agent integrates with the Agentic QE Fleet through:
-- **EventBus**: Real-time chaos event coordination
-- **MemoryManager**: Experiment state and results persistence
-- **FleetManager**: Coordination with other testing agents
-- **Neural Network**: Learn resilience patterns from experiments
-- **Monitoring Integration**: Seamless observability during chaos
-
-## Advanced Features
-
-### Continuous Chaos
-Run low-intensity chaos continuously in production to build confidence
-
-### Chaos as Code
-Define experiments as declarative YAML configurations for GitOps workflows
-
-### ML-Powered Failure Prediction
-Use neural patterns to predict likely failure modes and generate targeted experiments
-
-### Automated Remediation
-Automatically create runbooks and alerts based on discovered failure modes