claude-flow-novice 2.8.1 → 2.9.0

package/.claude/skills/cfn-loop-validation/examples/README.md

@@ -1,453 +0,0 @@
-# CFN Loop Validation - Coordinator Integration Examples
-
-This directory contains practical examples demonstrating how coordinators can integrate the CFN Loop Validation skill into their workflows.
-
-## Overview
-
-Each example script demonstrates a different integration pattern:
-
-1. **Loop 3 Confidence Gate** - Validate agent confidence before spawning validators
-2. **Loop 2 Consensus** - Validate Byzantine consensus from validator swarm
-3. **Full CFN Loop** - Complete workflow with all validation gates
-4. **Redis Integration** - Async validation with Redis pub/sub
-
-## Examples
-
-### 1. coordinator-loop3-gate.sh
-
-**Purpose:** Validate Loop 3 confidence gate before proceeding to consensus validation
-
-**Scenario:**
-- Primary swarm (coder + tester) completes work
-- Coordinator validates agent's self-assessed confidence
-- Decision: Proceed to validators OR retry with feedback
-
-**Usage:**
-```bash
-./coordinator-loop3-gate.sh
-```
-
-**Expected Output:**
-```
-=== Loop 3: Primary Swarm Execution ===
-Task: feature-user-authentication
-Mode: standard
-
-Executing primary swarm (coder + tester)...
-Agent reported confidence: 0.85
-
-=== Validating Loop 3 Confidence Gate ===
-
-Validation Result:
-  Status: PASS
-  Passed: true
-  Confidence: 0.85
-  Threshold: 0.80
-  Exit Code: 0
-
-✓ Confidence gate PASSED
-  → Proceeding to Loop 2 (spawning validators)
-```
-
-**Key Concepts:**
-- Confidence gate threshold validation
-- Automatic retry logic for low confidence
-- Escalation path for max iterations
-
----
-
-### 2. coordinator-loop2-consensus.sh
-
-**Purpose:** Validate Byzantine consensus from validator swarm
-
-**Scenario:**
-- Validator swarm completes review (reviewer, security, tester, analyst, architect)
-- Coordinator calculates consensus score
-- Decision: Proceed to product owner OR retry validators
-
-**Usage:**
-```bash
-./coordinator-loop2-consensus.sh
-```
-
-**Expected Output:**
-```
-=== Loop 2: Consensus Validation ===
-Task: compliance-gdpr-implementation
-Mode: enterprise
-
-Spawning validator swarm...
-  - Validator 1: reviewer (confidence: 0.92)
-  - Validator 2: security-specialist (confidence: 0.95)
-  - Validator 3: tester (confidence: 0.88)
-  - Validator 4: analyst (confidence: 0.91)
-  - Validator 5: architect (confidence: 0.93)
-
-Consensus Results:
-  Average Confidence: 0.918
-  Consensus Score: 0.952
-
-=== Validating Loop 2 Consensus Threshold ===
-
-Validation Result:
-  Type: consensus
-  Status: PASS
-  Passed: true
-  Consensus: 0.952
-  Threshold: 0.95
-  Exit Code: 0
-
-✓ Consensus ACHIEVED
-  → Proceeding to Loop 4 (Product Owner Decision Gate)
-```
-
-**Key Concepts:**
-- Byzantine consensus validation
-- Multiple validator coordination
-- Enterprise mode threshold requirements
-
----
-
-### 3. coordinator-full-cfn-loop.sh
-
-**Purpose:** Complete CFN loop workflow with validation at each gate
-
-**Scenario:**
-- Full orchestration: Loop 3 → Loop 2 → Loop 4
-- Iterative retry logic with feedback injection
-- Product owner decision gate (GOAP)
-
-**Usage:**
-```bash
-./coordinator-full-cfn-loop.sh
-```
-
-**Expected Output:**
-```
-╔════════════════════════════════════════════════════════════╗
-║           CFN LOOP ORCHESTRATION - Full Example            ║
-╚════════════════════════════════════════════════════════════╝
-
-Task: feature-payment-processing
-Mode: standard
-Max Loop 3 Retries: 3
-Max Loop 2 Retries: 2
-
-┌────────────────────────────────────────────────────────────┐
-│ LOOP 3: Primary Swarm Execution (Confidence Gate)         │
-└────────────────────────────────────────────────────────────┘
-
---- Loop 3 Iteration 1 ---
-Executing primary swarm (coder + tester)...
-Agent self-assessed confidence: 0.75
-Validation: FAIL (threshold: 0.80)
-✗ Loop 3 gate FAILED
-  → Injecting feedback and retrying...
-
---- Loop 3 Iteration 2 ---
-Executing primary swarm (coder + tester)...
-Agent self-assessed confidence: 0.82
-Validation: PASS (threshold: 0.80)
-✓ Loop 3 gate PASSED
-
-┌────────────────────────────────────────────────────────────┐
-│ LOOP 2: Validator Consensus (Byzantine Agreement)         │
-└────────────────────────────────────────────────────────────┘
-
---- Loop 2 Iteration 1 ---
-Spawning validator swarm...
-  - reviewer
-  - security-specialist
-  - tester
-  - analyst
-
-Byzantine consensus result: 0.88
-Validation: FAIL (threshold: 0.90)
-✗ Loop 2 consensus FAILED
-  → Analyzing validator feedback and retrying...
-
---- Loop 2 Iteration 2 ---
-Spawning validator swarm...
-Byzantine consensus result: 0.92
-Validation: PASS (threshold: 0.90)
-✓ Loop 2 consensus ACHIEVED
-
-┌────────────────────────────────────────────────────────────┐
-│ LOOP 4: Product Owner Decision Gate (GOAP)                │
-└────────────────────────────────────────────────────────────┘
-
-Invoking product owner decision...
-Product Owner Decision:
-  Decision: PROCEED
-  Confidence: 0.92
-  Reasoning: Payment processing implementation meets security and compliance standards. Ready for deployment.
-
-✓ Product Owner APPROVED
-  → Phase complete, proceeding to next phase
-
-╔════════════════════════════════════════════════════════════╗
-║                  PHASE COMPLETE - SUCCESS                  ║
-╚════════════════════════════════════════════════════════════╝
-
-Summary:
-  Task: feature-payment-processing
-  Mode: standard
-  Loop 3 Iterations: 2
-  Loop 2 Iterations: 2
-  Final Confidence: 0.82
-  Final Consensus: 0.92
-  Product Owner: PROCEED (0.92 confidence)
-
-Next Action: Proceed to next phase or deployment
-```
-
-**Key Concepts:**
-- Complete CFN loop orchestration
-- Iterative retry with feedback injection
-- Loop 3 → Loop 2 → Loop 4 flow
-- Product owner decision types (PROCEED, LOOP, DEFER, ESCALATE)
-
----
-
-### 4. coordinator-redis-integration.sh
-
-**Purpose:** Async validation with Redis pub/sub for distributed coordination
-
-**Scenario:**
-- Coordinator runs validation
-- Results published to Redis for other agents
-- Event-driven workflow coordination
-
-**Usage:**
-```bash
-# Ensure Redis is running
-docker run -d -p 6379:6379 redis:latest
-
-# Run example
-./coordinator-redis-integration.sh
-```
-
-**Expected Output:**
-```
-═══════════════════════════════════════════════════════════
-  CFN Loop Validation with Redis Integration
-═══════════════════════════════════════════════════════════
-
-Task: distributed-task-microservices
-Mode: enterprise
-Iteration: 2
-Redis: localhost:6379
-
-Checking Redis connectivity...
-✓ Redis connection successful
-
-Running CFN Loop validation...
-Validation Result:
-  Status: PASS
-  Passed: true
-  Code: 0
-
-Publishing validation result to Redis...
-✓ Stored in list: cfn:validation:distributed-task-microservices
-✓ Set status key (TTL: 1 hour)
-✓ Published event: validation_passed
-✓ Updated task metadata
-
-Redis Integration Summary:
-  List: cfn:validation:distributed-task-microservices (validation history)
-  Key: cfn:validation:distributed-task-microservices:status (current status)
-  Channel: cfn:events (event stream)
-  Hash: cfn:task:distributed-task-microservices:metadata (task metadata)
-
-Other agents can subscribe to events:
-  redis-cli -h localhost -p 6379 subscribe cfn:events
-
-Query validation history:
-  redis-cli -h localhost -p 6379 lrange cfn:validation:distributed-task-microservices 0 -1
-
-✓ VALIDATION PASSED
-  → Proceeding to next phase
-```
-
-**Key Concepts:**
-- Redis list storage for validation history
-- Redis key-value with TTL for current status
-- Redis pub/sub for event distribution
-- Redis hash for task metadata
-- Event-driven agent coordination
-
-**Redis Event Format:**
-```json
-{
-  "type": "validation_passed",
-  "taskId": "distributed-task-microservices",
-  "mode": "enterprise",
-  "iteration": 2,
-  "confidence": 0.88,
-  "consensus": 0.94,
-  "timestamp": 1760818560
-}
-```
-
----
-
-## Testing the Examples
-
-### Quick Test
-
-Run all examples in sequence:
-```bash
-# Test Loop 3 gate
-./coordinator-loop3-gate.sh
-
-# Test Loop 2 consensus
-./coordinator-loop2-consensus.sh
-
-# Test full CFN loop
-./coordinator-full-cfn-loop.sh
-
-# Test Redis integration (requires Redis)
-./coordinator-redis-integration.sh
-```
-
-### Customizing Examples
-
-Each script can be modified to test different scenarios:
-
-**Adjust confidence scores:**
-```bash
-# In any script, modify:
-AGENT_CONFIDENCE=0.75  # Change to test different thresholds
-```
-
-**Change validation mode:**
-```bash
-MODE="mvp"        # Fast iteration
-MODE="standard"   # Balanced validation
-MODE="enterprise" # Maximum security
-```
-
-**Test failure scenarios:**
-```bash
-# Set confidence below threshold
-AGENT_CONFIDENCE=0.60
-
-# Set iteration above max
-ITERATION=11
-```
-
----
-
-## Integration Patterns
-
-### Pattern 1: Coordinator with Spawned Agents
-
-```bash
-# Coordinator spawns agents and validates results
-npx claude-flow-novice swarm "implement feature" --agents coder,tester
-
-# Get agent confidence from results
-AGENT_CONFIDENCE=$(parse_agent_response)
-
-# Validate
-./validate-iteration.sh --mode standard --iteration 1 --confidence $AGENT_CONFIDENCE
-```
-
-### Pattern 2: Event-Driven Coordination
-
-```bash
-# Agent 1: Publish validation result to Redis
-./coordinator-redis-integration.sh
-
-# Agent 2: Subscribe to events
-redis-cli subscribe cfn:events
-
-# Agent 2 receives event and acts accordingly
-```
-
-### Pattern 3: Multi-Phase Orchestration
-
-```bash
-# Phase 1: Authentication
-./coordinator-full-cfn-loop.sh  # Task: auth-system
-
-# Phase 2: Authorization (depends on Phase 1)
-if validation_passed("auth-system"); then
-  ./coordinator-full-cfn-loop.sh  # Task: authz-system
-fi
-```
-
----
-
-## Exit Codes
-
-All examples follow the standard CFN Loop validation exit codes:
-
-| Code | Meaning | Action |
-|------|---------|--------|
-| 0 | Validation passed | Continue to next phase |
-| 1 | Validation failed | Inject feedback, retry |
-| 2 | Max iterations exceeded | Escalate to human |
-| 3 | Invalid arguments | Fix script parameters |
-| 4 | Configuration error | Check config.json |
-
----
-
-## Dependencies
-
-**Required:**
-- `bash` (version 4.0+)
-- `jq` (JSON processor)
-
-**Optional:**
-- `redis-cli` (for Redis integration example)
-- `bc` (basic calculator, usually pre-installed)
-
-**Installation:**
-```bash
-# Ubuntu/Debian
-sudo apt-get install jq redis-tools bc
-
-# macOS
-brew install jq redis bc
-```
-
----
-
-## Troubleshooting
-
-### Issue: "Permission denied"
-```bash
-chmod +x *.sh
-```
-
-### Issue: "jq: command not found"
-```bash
-sudo apt-get install jq
-```
-
-### Issue: "Redis connection failed"
-```bash
-# Start Redis
-docker run -d -p 6379:6379 redis:latest
-
-# Or install locally
-sudo apt-get install redis-server
-sudo systemctl start redis
-```
-
-### Issue: Line ending errors (Windows/WSL)
-```bash
-sed -i 's/\r$//' *.sh
-```
-
----
-
-## Next Steps
-
-1. **Customize:** Modify examples for your specific use case
-2. **Integrate:** Use patterns in your coordinator implementations
-3. **Extend:** Add custom validation logic or Redis event handlers
-4. **Monitor:** Track validation metrics in Redis or SQLite
-
-For more information, see `/mnt/c/Users/masha/Documents/claude-flow-novice/.claude/skills/cfn-loop-validation/SKILL.md`

package/.claude/skills/cfn-loop-validation/examples/coordinator-full-cfn-loop.sh

@@ -1,234 +0,0 @@
-#!/usr/bin/env bash
-
-##############################################################################
-# Example: Full CFN Loop Integration
-#
-# Scenario: Complete CFN loop workflow with validation at each gate
-# Flow: Loop 3 (confidence) → Loop 2 (consensus) → Loop 4 (product owner)
-##############################################################################
-
-set -euo pipefail
-
-# Get script directory
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-VALIDATOR="${SCRIPT_DIR}/../validate-iteration.sh"
-
-# Configuration
-CFN_MODE="standard"
-TASK_ID="feature-payment-processing"
-MAX_LOOP3_RETRIES=3
-MAX_LOOP2_RETRIES=2
-
-echo "╔════════════════════════════════════════════════════════════╗"
-echo "║           CFN LOOP ORCHESTRATION - Full Example            ║"
-echo "╚════════════════════════════════════════════════════════════╝"
-echo ""
-echo "Task: $TASK_ID"
-echo "Mode: $CFN_MODE"
-echo "Max Loop 3 Retries: $MAX_LOOP3_RETRIES"
-echo "Max Loop 2 Retries: $MAX_LOOP2_RETRIES"
-echo ""
-
-# ============================================================================
-# LOOP 3: Primary Swarm Execution with Confidence Gate
-# ============================================================================
-
-echo "┌────────────────────────────────────────────────────────────┐"
-echo "│ LOOP 3: Primary Swarm Execution (Confidence Gate)         │"
-echo "└────────────────────────────────────────────────────────────┘"
-echo ""
-
-LOOP3_ITERATION=0
-LOOP3_PASSED=false
-
-while [[ $LOOP3_ITERATION -lt $MAX_LOOP3_RETRIES ]]; do
-  LOOP3_ITERATION=$((LOOP3_ITERATION + 1))
-
-  echo "--- Loop 3 Iteration $LOOP3_ITERATION ---"
-  echo "Executing primary swarm (coder + tester)..."
-
-  # Simulate agent work
-  sleep 1
-
-  # Simulated confidence score (improves with each iteration)
-  case $LOOP3_ITERATION in
-    1) AGENT_CONFIDENCE=0.75 ;;  # Below threshold
-    2) AGENT_CONFIDENCE=0.82 ;;  # Above threshold
-    3) AGENT_CONFIDENCE=0.88 ;;  # Well above threshold
-  esac
-
-  echo "Agent self-assessed confidence: $AGENT_CONFIDENCE"
-
-  # Validate confidence gate
-  GATE_RESULT=$("$VALIDATOR" \
-    --mode "$CFN_MODE" \
-    --iteration "$LOOP3_ITERATION" \
-    --confidence "$AGENT_CONFIDENCE" \
-    --task-id "$TASK_ID" \
-    --agent-id "coordinator-loop3" \
-    --json)
-
-  GATE_PASSED=$(echo "$GATE_RESULT" | jq -r '.passed')
-  GATE_STATUS=$(echo "$GATE_RESULT" | jq -r '.status')
-  GATE_THRESHOLD=$(echo "$GATE_RESULT" | jq -r '.threshold')
-
-  echo "Validation: $GATE_STATUS (threshold: $GATE_THRESHOLD)"
-
-  if [[ "$GATE_PASSED" == "true" ]]; then
-    echo "✓ Loop 3 gate PASSED"
-    echo ""
-    LOOP3_PASSED=true
-    break
-  else
-    echo "✗ Loop 3 gate FAILED"
-    echo "  → Injecting feedback and retrying..."
-    echo ""
-    sleep 1
-  fi
-done
-
-if [[ "$LOOP3_PASSED" != "true" ]]; then
-  echo "CRITICAL: Loop 3 failed after $MAX_LOOP3_RETRIES attempts"
-  echo "Action: Escalating to human review"
-  exit 2
-fi
-
-# ============================================================================
-# LOOP 2: Validator Consensus
-# ============================================================================
-
-echo "┌────────────────────────────────────────────────────────────┐"
-echo "│ LOOP 2: Validator Consensus (Byzantine Agreement)         │"
-echo "└────────────────────────────────────────────────────────────┘"
-echo ""
-
-LOOP2_ITERATION=0
-LOOP2_PASSED=false
-
-while [[ $LOOP2_ITERATION -lt $MAX_LOOP2_RETRIES ]]; do
-  LOOP2_ITERATION=$((LOOP2_ITERATION + 1))
-
-  echo "--- Loop 2 Iteration $LOOP2_ITERATION ---"
-  echo "Spawning validator swarm..."
-  echo "  - reviewer"
-  echo "  - security-specialist"
-  echo "  - tester"
-  echo "  - analyst"
-  echo ""
-
-  sleep 1
-
-  # Simulated consensus (improves with each iteration)
-  case $LOOP2_ITERATION in
-    1) CONSENSUS_SCORE=0.88 ;;  # Below threshold
-    2) CONSENSUS_SCORE=0.92 ;;  # Above threshold
-  esac
-
-  echo "Byzantine consensus result: $CONSENSUS_SCORE"
-
-  # Validate consensus
-  CONSENSUS_RESULT=$("$VALIDATOR" \
-    --mode "$CFN_MODE" \
-    --iteration "$LOOP2_ITERATION" \
-    --confidence "$AGENT_CONFIDENCE" \
-    --consensus "$CONSENSUS_SCORE" \
-    --task-id "$TASK_ID" \
-    --agent-id "coordinator-loop2" \
-    --json)
-
-  CONSENSUS_PASSED=$(echo "$CONSENSUS_RESULT" | jq -r '.passed')
-  CONSENSUS_STATUS=$(echo "$CONSENSUS_RESULT" | jq -r '.status')
-  CONSENSUS_THRESHOLD=$(echo "$CONSENSUS_RESULT" | jq -r '.threshold')
-
-  echo "Validation: $CONSENSUS_STATUS (threshold: $CONSENSUS_THRESHOLD)"
-
-  if [[ "$CONSENSUS_PASSED" == "true" ]]; then
-    echo "✓ Loop 2 consensus ACHIEVED"
-    echo ""
-    LOOP2_PASSED=true
-    break
-  else
-    echo "✗ Loop 2 consensus FAILED"
-    echo "  → Analyzing validator feedback and retrying..."
-    echo ""
-    sleep 1
-  fi
-done
-
-if [[ "$LOOP2_PASSED" != "true" ]]; then
-  echo "CRITICAL: Loop 2 consensus failed after $LOOP2_RETRIES attempts"
-  echo "Action: Escalating to human review"
-  exit 2
-fi
-
-# ============================================================================
-# LOOP 4: Product Owner Decision Gate (GOAP)
-# ============================================================================
-
-echo "┌────────────────────────────────────────────────────────────┐"
-echo "│ LOOP 4: Product Owner Decision Gate (GOAP)                │"
-echo "└────────────────────────────────────────────────────────────┘"
-echo ""
-
-echo "Invoking product owner decision..."
-sleep 1
-
-# Simulated product owner decision
-PO_DECISION="PROCEED"
-PO_CONFIDENCE=0.92
-PO_REASONING="Payment processing implementation meets security and compliance standards. Ready for deployment."
-
-echo "Product Owner Decision:"
-echo "  Decision: $PO_DECISION"
-echo "  Confidence: $PO_CONFIDENCE"
-echo "  Reasoning: $PO_REASONING"
-echo ""
-
-case "$PO_DECISION" in
-  PROCEED)
-    echo "✓ Product Owner APPROVED"
-    echo "  → Phase complete, proceeding to next phase"
-    echo ""
-    ;;
-
-  LOOP)
-    echo "↻ Product Owner requested LOOP"
-    echo "  → Returning to Loop 3 with updated requirements"
-    echo ""
-    exit 1
-    ;;
-
-  DEFER)
-    echo "⊗ Product Owner DEFERRED items to backlog"
-    echo "  → Proceeding with reduced scope"
-    echo ""
-    ;;
-
-  ESCALATE)
-    echo "⚠ Product Owner ESCALATED to human"
-    echo "  → Critical blockers require manual review"
-    echo ""
-    exit 2
-    ;;
-esac
-
-# ============================================================================
-# SUCCESS: Phase Complete
-# ============================================================================
-
-echo "╔════════════════════════════════════════════════════════════╗"
-echo "║                  PHASE COMPLETE - SUCCESS                  ║"
-echo "╚════════════════════════════════════════════════════════════╝"
-echo ""
-echo "Summary:"
-echo "  Task: $TASK_ID"
-echo "  Mode: $CFN_MODE"
-echo "  Loop 3 Iterations: $LOOP3_ITERATION"
-echo "  Loop 2 Iterations: $LOOP2_ITERATION"
-echo "  Final Confidence: $AGENT_CONFIDENCE"
-echo "  Final Consensus: $CONSENSUS_SCORE"
-echo "  Product Owner: $PO_DECISION ($PO_CONFIDENCE confidence)"
-echo ""
-echo "Next Action: Proceed to next phase or deployment"
-
-exit 0