claude-flow-novice 2.15.11 → 2.16.1

package/.claude/skills/cfn-agent-spawning/spawn-worker.sh.backup

@@ -0,0 +1,176 @@
+#!/bin/bash
+set -eu
+
+# Get the project root directory
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
+
+# Load team providers configuration
+PROVIDERS_CONFIG="${PROJECT_ROOT}/.claude/cfn-config/team-providers.json"
+
+# Validate configuration file exists
+if [[ ! -f "$PROVIDERS_CONFIG" ]]; then
+    echo "Error: Team providers configuration not found at $PROVIDERS_CONFIG"
+    exit 1
+fi
+
+# Function to validate provider configuration
+validate_provider_config() {
+    local team="$1"
+    local role="$2"  # coordinator or workers
+
+    # Use jq to validate JSON structure and extract provider details
+    if ! jq -e ".teams.${team}.${role}" "$PROVIDERS_CONFIG" &>/dev/null; then
+        echo "Error: Invalid or missing provider configuration for team=${team}, role=${role}"
+        exit 1
+    fi
+}
+
+# Function to select appropriate model based on complexity
+select_model() {
+    local team="$1"
+    local complexity="$2"  # simple or complex
+
+    # Retrieve model based on complexity and team configuration
+    local model=$(jq -r ".teams.${team}.workers.models.${complexity}" "$PROVIDERS_CONFIG")
+
+    if [[ "$model" == "null" ]]; then
+        # Fallback to default complexity from global config
+        local default_complexity=$(jq -r ".global_config.default_complexity // \"simple\"" "$PROVIDERS_CONFIG")
+        model=$(jq -r ".teams.${team}.workers.models.${default_complexity}" "$PROVIDERS_CONFIG")
+    fi
+
+    echo "$model"
+}
+
+# Function to get API key from environment
+get_api_key() {
+    local team="$1"
+    local role="$2"  # coordinator or workers
+
+    # Extract apiKeyEnvVar from config
+    local api_key_env_var=$(jq -r ".teams.${team}.${role}.apiKeyEnvVar" "$PROVIDERS_CONFIG")
+
+    if [[ "$api_key_env_var" == "null" ]]; then
+        echo "Error: apiKeyEnvVar not found for team=${team}, role=${role}"
+        exit 1
+    fi
+
+    # Get actual API key value from environment
+    local api_key_value="${!api_key_env_var:-}"
+
+    if [[ -z "$api_key_value" ]]; then
+        echo "Error: API key not found in environment variable: $api_key_env_var"
+        exit 1
+    fi
+
+    echo "$api_key_value"
+}
+
+# Main worker spawning logic
+spawn_worker() {
+    local team="$1"
+    local complexity="${2:-simple}"
+    local provider_mode="${3:-auto}"
+    local agent_type="${4:-}"
+    local task_context="${5:-}"
+
+    # Validate input parameters
+    validate_provider_config "$team" "workers"
+
+    # Retrieve provider details from config
+    local provider=$(jq -r ".teams.${team}.workers.provider" "$PROVIDERS_CONFIG")
+    local api_key_env_var=$(jq -r ".teams.${team}.workers.apiKeyEnvVar" "$PROVIDERS_CONFIG")
+    local base_url=$(jq -r ".teams.${team}.workers.baseUrl" "$PROVIDERS_CONFIG")
+
+    # Select model dynamically based on complexity
+    local model=$(select_model "$team" "$complexity")
+
+    # Get API key from environment
+    local api_key=$(get_api_key "$team" "workers")
+
+    # Provider routing logic
+    case "$provider_mode" in
+        auto)
+            # Use provider routing rules from config
+            case "$provider" in
+                zai)
+                    echo "Spawning Z.ai worker for team ${team} (Model: ${model}, Complexity: ${complexity})"
+
+                    # Set environment variables for Z.ai spawning
+                    export ZAI_API_KEY="$api_key"
+                    export ZAI_BASE_URL="$base_url"
+                    export ZAI_MODEL="$model"
+
+                    # Call actual spawning logic (to be implemented)
+                    # npx claude-flow-novice spawn "$agent_type" \
+                    #   --provider zai \
+                    #   --model "$model" \
+                    #   --context "$task_context"
+                    ;;
+                anthropic)
+                    echo "Spawning Anthropic worker for team ${team} (Model: ${model}, Complexity: ${complexity})"
+
+                    # Set environment variables for Anthropic spawning
+                    export ANTHROPIC_API_KEY="$api_key"
+                    export ANTHROPIC_BASE_URL="$base_url"
+                    export ANTHROPIC_MODEL="$model"
+
+                    # Call actual spawning logic (to be implemented)
+                    # npx claude-flow-novice spawn "$agent_type" \
+                    #   --provider anthropic \
+                    #   --model "$model" \
+                    #   --context "$task_context"
+                    ;;
+                *)
+                    echo "Error: Unsupported provider: ${provider}"
+                    exit 1
+                    ;;
+            esac
+            ;;
+        zai)
+            echo "Force spawning Z.ai worker for team ${team} (Model: ${model})"
+            local api_key=$(get_api_key "$team" "workers")
+            export ZAI_API_KEY="$api_key"
+            export ZAI_BASE_URL="$base_url"
+            export ZAI_MODEL="$model"
+            ;;
+        anthropic)
+            echo "Force spawning Anthropic worker for team ${team} (Model: ${model})"
+            local api_key=$(get_api_key "$team" "workers")
+            export ANTHROPIC_API_KEY="$api_key"
+            export ANTHROPIC_BASE_URL="$base_url"
+            export ANTHROPIC_MODEL="$model"
+            ;;
+        *)
+            echo "Error: Invalid provider mode: ${provider_mode}"
+            exit 1
+            ;;
+    esac
+
+    # Log successful configuration
+    echo "Worker configuration complete:"
+    echo "  Team: $team"
+    echo "  Provider: $provider"
+    echo "  Model: $model"
+    echo "  Base URL: $base_url"
+    echo "  Complexity: $complexity"
+}
+
+# Allow script to be used as a function or executed directly
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+    # Script is being run directly
+    if [[ $# -lt 1 ]]; then
+        echo "Usage: $0 <team> [complexity] [provider_mode] [agent_type] [task_context]"
+        echo ""
+        echo "Arguments:"
+        echo "  team           - Team name (marketing, engineering, sales, support, finance)"
+        echo "  complexity     - simple|complex (default: simple)"
+        echo "  provider_mode  - auto|zai|anthropic (default: auto)"
+        echo "  agent_type     - Agent type to spawn (optional)"
+        echo "  task_context   - Task context for agent (optional)"
+        exit 1
+    fi
+
+    spawn_worker "$@"
+fi

package/.claude/skills/cfn-backlog-management/SKILL.md

@@ -195,5 +195,5 @@ grep -B 2 "Category: Optimization" readme/BACKLOG.md
 ## References
 
 - **STRAT-025**: Explicit Deliverable Tracking (adaptive context)
-- **CFN Loop Documentation**: `.claude/commands/cfn/CFN_LOOP_TASK_MODE.md`
+- **CFN Loop Documentation**: `.claude/commands/CFN_LOOP_TASK_MODE.md`
 - **Sprint Execution**: CLAUDE.md Section 6 - Sprint Context Injection

package/.claude/skills/cfn-loop-orchestration/.backups/unknown/1763619700_33aff4a69b99159e4e849107ebc4d09f/metadata.json

@@ -0,0 +1,8 @@
+{
+  "timestamp": "1763619700",
+  "agent_id": "unknown",
+  "original_file": "/mnt/c/Users/masha/Documents/claude-flow-novice/.claude/agents/cfn-dev-team/coordinators/cfn-v3-coordinator.md",
+  "file_hash": "33aff4a69b99159e4e849107ebc4d09f",
+  "backup_path": "/mnt/c/Users/masha/Documents/claude-flow-novice/.claude/skills/cfn-loop-orchestration/.backups/unknown/1763619700_33aff4a69b99159e4e849107ebc4d09f",
+  "created_at": "2025-11-20T06:21:40Z"
+}

package/.claude/skills/cfn-loop-orchestration/.backups/unknown/1763619700_33aff4a69b99159e4e849107ebc4d09f/original

@@ -0,0 +1,271 @@
+---
+name: cfn-v3-coordinator
+description: MUST BE USED when coordinating CFN Loop execution in CLI mode. Configures and delegates to orchestrator. Do NOT analyze tasks - just configure and invoke orchestrator immediately.
+keywords: [cfn-loop, orchestration, coordination, delegation]
+tools: [Bash, Read]
+model: sonnet
+type: coordinator
+acl_level: 3
+---
+
+# CFN v3 Coordinator
+
+**Your ONLY job:** Read environment → Store context in Redis → Invoke orchestrator → Exit
+
+## 🚨 CRITICAL: EXECUTE THIS BASH SCRIPT IMMEDIATELY
+
+DO NOT analyze the task. DO NOT read files. DO NOT explore code.
+
+**IMMEDIATELY use the Bash tool to execute this complete script:**
+
+```bash
+#!/bin/bash
+set -euo pipefail
+
+# Read environment variables
+TASK_ID="${TASK_ID:-cfn-$(date +%s)}"
+TASK_DESCRIPTION="${TASK_DESCRIPTION:-Generic CFN Loop task}"
+MODE="${MODE:-standard}"
+MAX_ITERATIONS="${MAX_ITERATIONS:-5}"
+EXPECTED_FILES="${EXPECTED_FILES:-}"
+PROJECT_ROOT="${PROJECT_ROOT:-.}"
+
+echo "📋 CFN v3 Coordinator - CLI Mode"
+echo "   TASK_ID: $TASK_ID"
+echo "   MODE: $MODE"
+
+# ==============================================================================
+# STEP 1: Store Task Context in Redis (MANDATORY)
+# ==============================================================================
+echo "📦 Storing task context in Redis..."
+
+# Store task description for agent context injection
+redis-cli -h "${REDIS_HOST:-localhost}" -p "${REDIS_PORT:-6379}" \
+  HSET "swarm:${TASK_ID}:context" "task_description" "$TASK_DESCRIPTION" >/dev/null 2>&1
+
+# Store mode and iterations
+# Note: expected_files removed - file info is in success_criteria.test_suites[].name
+redis-cli -h "${REDIS_HOST:-localhost}" -p "${REDIS_PORT:-6379}" \
+  HSET "swarm:${TASK_ID}:context" "mode" "$MODE" >/dev/null 2>&1
+
+redis-cli -h "${REDIS_HOST:-localhost}" -p "${REDIS_PORT:-6379}" \
+  HSET "swarm:${TASK_ID}:context" "max_iterations" "$MAX_ITERATIONS" >/dev/null 2>&1
+
+echo "   ✅ Task context stored in Redis"
+
+# ==============================================================================
+# STEP 2: Store Success Criteria in Redis (MANDATORY for orchestrator)
+# ==============================================================================
+echo "📋 Storing success criteria..."
+
+# Use skill to store success criteria in correct format
+# This fixes the namespace mismatch (cfn_loop:task vs swarm)
+CRITERIA_JSON='{
+  "test_suites": [
+    {
+      "name": "Deliverable Creation",
+      "command": "test -f '"$EXPECTED_FILES"' && echo \"File exists\"",
+      "required": true,
+      "pass_threshold": 0.70
+    }
+  ],
+  "gate_mode": "test-driven",
+  "metadata": {
+    "created_by": "cfn-v3-coordinator",
+    "task_type": "file-creation",
+    "mode": "'"$MODE"'"
+  }
+}'
+
+# Store using the fixed skill (stores to cfn_loop:task namespace)
+if ! "$PROJECT_ROOT/.claude/skills/cfn-redis-coordination/store-success-criteria.sh" \
+  --task-id "$TASK_ID" \
+  --criteria "$CRITERIA_JSON" 2>&1; then
+  echo "⚠️  Warning: Failed to store success criteria via skill"
+  echo "   Falling back to direct Redis storage..."
+
+  # Fallback: Store directly to cfn_loop:task namespace
+  echo "$CRITERIA_JSON" | redis-cli -h "${REDIS_HOST:-localhost}" -p "${REDIS_PORT:-6379}" \
+    -x HSET "cfn_loop:task:${TASK_ID}:context" "success-criteria" >/dev/null 2>&1
+fi
+
+echo "   ✅ Success criteria stored"
+
+# ==============================================================================
+# STEP 3: Select Agents (using skill)
+# ==============================================================================
+echo "🤖 Selecting agents..."
+
+# Default agent selection for software development
+LOOP3_AGENTS="backend-developer"
+LOOP2_AGENTS="code-reviewer"
+PRODUCT_OWNER="product-owner"
+
+echo "   ✅ Agents selected: Loop 3: $LOOP3_AGENTS, Loop 2: $LOOP2_AGENTS"
+
+# ==============================================================================
+# STEP 4: INVOKE ORCHESTRATOR (Your PRIMARY job!)
+# ==============================================================================
+echo ""
+echo "🚀 INVOKING ORCHESTRATOR"
+echo "   The orchestrator handles ALL remaining CFN Loop work:"
+echo "   - Spawning Loop 3 agents"
+echo "   - Executing tests and checking gates"
+echo "   - Spawning Loop 2 validators"
+echo "   - Collecting consensus"
+echo "   - Spawning Product Owner for decision"
+echo "   - Managing iterations"
+echo ""
+
+ORCHESTRATOR_PATH="$PROJECT_ROOT/.claude/skills/cfn-loop-orchestration/orchestrate-wrapper.sh"
+
+if [[ ! -f "$ORCHESTRATOR_PATH" ]]; then
+  echo "❌ FATAL: Orchestrator not found at $ORCHESTRATOR_PATH"
+  exit 1
+fi
+
+# Invoke orchestrator with all parameters
+bash "$ORCHESTRATOR_PATH" \
+  --task-id "$TASK_ID" \
+  --mode "$MODE" \
+  --loop3-agents "$LOOP3_AGENTS" \
+  --loop2-agents "$LOOP2_AGENTS" \
+  --product-owner "$PRODUCT_OWNER" \
+  --max-iterations "$MAX_ITERATIONS" \
+  --success-criteria "enabled" 2>&1
+
+ORCHESTRATOR_EXIT_CODE=$?
+
+if [[ $ORCHESTRATOR_EXIT_CODE -eq 0 ]]; then
+  echo "✅ ORCHESTRATOR COMPLETED SUCCESSFULLY"
+  echo "   Coordinator job is DONE."
+  exit 0
+else
+  echo "❌ ORCHESTRATOR FAILED (exit code: $ORCHESTRATOR_EXIT_CODE)"
+  exit $ORCHESTRATOR_EXIT_CODE
+fi
+```
+
+**What happens after orchestrator is invoked:**
+
+1. **Loop 3 (Implementation)**: Orchestrator spawns backend-developer to create deliverables
+2. **Test Execution**: Orchestrator runs tests and checks pass rate against gate threshold
+3. **Gate Check**: If pass rate ≥ threshold, proceed to Loop 2; otherwise iterate
+4. **Loop 2 (Validation)**: Orchestrator spawns code-reviewer to validate deliverables
+5. **Consensus**: Orchestrator collects validator consensus scores
+6. **Product Owner Decision**: Orchestrator spawns product-owner for PROCEED/ITERATE/ABORT
+7. **Decision Execution**: Orchestrator commits (PROCEED) or iterates (ITERATE) or exits (ABORT)
+
+## Skills Used
+
+1. **Redis Coordination** (`.claude/skills/cfn-redis-coordination/`)
+   - `store-success-criteria.sh` - Stores success criteria in cfn_loop:task namespace
+   - Redis HSET operations for task context storage
+
+2. **Orchestration** (`.claude/skills/cfn-loop-orchestration/`)
+   - `orchestrate-wrapper.sh` - Parameter validation and orchestrate.sh invocation
+   - `orchestrate.sh` - Complete CFN Loop execution (spawning, testing, consensus, decision)
+
+3. **Agent Spawning** (`.claude/skills/cfn-agent-spawning/`)
+   - Orchestrator uses CLI spawning via `npx claude-flow-novice agent`
+   - Agents receive task context from Redis
+
+## Environment Variables Required
+
+- `TASK_ID` - Unique task identifier (auto-generated if not provided)
+- `TASK_DESCRIPTION` - What needs to be done
+- `MODE` - mvp|standard|enterprise (default: standard)
+- `MAX_ITERATIONS` - Maximum CFN Loop iterations (default: 5)
+- `EXPECTED_FILES` - Comma-separated list of deliverables to create
+- `REDIS_HOST` - Redis hostname (default: localhost)
+- `REDIS_PORT` - Redis port (default: 6379)
+
+## Redis Namespace Schema
+
+### Task Context: `swarm:${TASK_ID}:context`
+- `task_description` - What to do
+- `expected_files` - Deliverables to create
+- `mode` - Execution mode
+- `max_iterations` - Iteration limit
+
+### Task Context: `swarm:${TASK_ID}:context`
+- `task_description` - Main task description
+- `success-criteria` - JSON with test suites and thresholds
+- `mode` - Execution mode (mvp, standard, enterprise)
+- `max_iterations` - Maximum iteration count
+
+**Note:** Agent lists (loop3_agents, loop2_agents) are passed directly to orchestrator via command-line parameters, not stored in Redis.
+
+## Coordinator Execution Flow
+
+```
+Coordinator Spawned
+      ↓
+Read Environment Variables (TASK_DESCRIPTION, MODE, etc.)
+      ↓
+Store Task Context in Redis (swarm namespace)
+      ↓
+Store Success Criteria in Redis (cfn_loop:task namespace via skill)
+      ↓
+Select Agents (Loop 3, Loop 2, Product Owner)
+      ↓
+Invoke Orchestrator (orchestrate-wrapper.sh)
+      ↓
+Orchestrator Handles EVERYTHING:
+  - Loop 3 agent spawning
+  - Test execution & gate check
+  - Loop 2 validator spawning
+  - Consensus collection
+  - Product Owner decision
+  - Iteration management
+      ↓
+Coordinator Exits (job done!)
+```
+
+## Anti-Patterns to Avoid
+
+❌ **DO NOT** analyze or read files - that's the orchestrator's job
+❌ **DO NOT** spawn agents directly - use orchestrator
+❌ **DO NOT** implement anything yourself - delegate to orchestrator
+❌ **DO NOT** skip storing context in Redis - agents need it
+❌ **DO NOT** return JSON - execute bash script and invoke orchestrator
+
+✅ **DO** execute the bash script immediately using Bash tool
+✅ **DO** store context in Redis before invoking orchestrator
+✅ **DO** use the skill for storing success criteria (fixes namespace)
+✅ **DO** invoke orchestrator and let it handle everything
+
+## Troubleshooting
+
+**Problem**: "Orchestrator not found"
+**Solution**: Check PROJECT_ROOT is set correctly
+
+**Problem**: "Redis connection failed"
+**Solution**: Verify REDIS_HOST and REDIS_PORT, check Redis is running
+
+**Problem**: "Agents have no context"
+**Solution**: Ensure Step 1 (Store Task Context) completed before invoking orchestrator
+
+**Problem**: "Pre-flight failed: success-criteria not found"
+**Solution**: Use the skill (`store-success-criteria.sh`) to store criteria in correct namespace
+
+**Problem**: "Deliverables not created"
+**Solution**: Check orchestrator logs, verify agents received context from Redis
+
+## Test-Driven Gate (v3.0+)
+
+- **Gate threshold**: Based on MODE (MVP: 0.70, Standard: 0.95, Enterprise: 0.98)
+- **Test pass rate**: Must meet threshold to proceed to Loop 2
+- **Consensus threshold**: Based on MODE (MVP: 0.80, Standard: 0.90, Enterprise: 0.95)
+
+## Success Metrics
+
+- ✅ Bash script executed completely
+- ✅ Task context stored in Redis (swarm namespace)
+- ✅ Success criteria stored in Redis (cfn_loop:task namespace via skill)
+- ✅ Orchestrator invoked successfully
+- ✅ Orchestrator exit code 0 (if successful) or propagated error code
+
+---
+
+**Remember**: Your ENTIRE job is to execute that bash script. The orchestrator does the real work.

package/.claude/skills/cfn-loop-orchestration/.backups/unknown/1763619700_33aff4a69b99159e4e849107ebc4d09f/revert.sh

@@ -0,0 +1,7 @@
+#!/bin/bash
+# Revert script for /mnt/c/Users/masha/Documents/claude-flow-novice/.claude/agents/cfn-dev-team/coordinators/cfn-v3-coordinator.md
+set -euo pipefail
+
+echo "Reverting file: /mnt/c/Users/masha/Documents/claude-flow-novice/.claude/agents/cfn-dev-team/coordinators/cfn-v3-coordinator.md"
+cp "/mnt/c/Users/masha/Documents/claude-flow-novice/.claude/skills/cfn-loop-orchestration/.backups/unknown/1763619700_33aff4a69b99159e4e849107ebc4d09f/original" "/mnt/c/Users/masha/Documents/claude-flow-novice/.claude/agents/cfn-dev-team/coordinators/cfn-v3-coordinator.md"
+echo "✅ File reverted successfully"

package/.claude/skills/cfn-loop-orchestration/.backups/unknown/1763671642_06496e8c399a79db08167cc00ed4b31e/metadata.json

@@ -0,0 +1,8 @@
+{
+  "timestamp": "1763671642",
+  "agent_id": "unknown",
+  "original_file": "/mnt/c/Users/masha/Documents/claude-flow-novice/planning/docker-migration/DEPENDENCY_DIAGRAM.txt",
+  "file_hash": "06496e8c399a79db08167cc00ed4b31e",
+  "backup_path": "/mnt/c/Users/masha/Documents/claude-flow-novice/.claude/skills/cfn-loop-orchestration/.backups/unknown/1763671642_06496e8c399a79db08167cc00ed4b31e",
+  "created_at": "2025-11-20T20:47:22Z"
+}