claude-flow-novice 2.9.0 → 2.10.0

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

@@ -0,0 +1,453 @@
+# 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

@@ -0,0 +1,234 @@
+#!/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}/.claude/skills/cfn-cfn-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