claude-flow-novice 2.10.7 → 2.10.9

package/.claude/commands/cfn/CFN_LOOP_TASK_MODE.md

@@ -15,6 +15,23 @@ Task Mode: Main Chat spawns coordinator and agents via Task() tool with full con
 | **Provider** | All Anthropic | CLI uses Z.ai routing |
 | **Cost** | ~$0.150/iteration | ~$0.054/iteration (64% savings) |
 | **Use Case** | Debugging, prototyping, learning | Production, cost optimization |
+| **ACE Reflection** | Optional via `--ace-reflect` flag | Always enabled |
+
+### ACE Reflection Flag
+
+```bash
+# Enable ACE reflection after each sprint (captures lessons learned)
+/cfn-loop "Task description" --spawn-mode=task --ace-reflect
+
+# Without ACE reflection (default for backwards compatibility)
+/cfn-loop "Task description" --spawn-mode=task
+```
+
+**When to use `--ace-reflect`:**
+- Long-running epics (3+ sprints) where learning accumulates
+- Complex tasks with multiple iterations
+- Teams building organizational knowledge
+- Post-mortem analysis and continuous improvement
 
 ---
 
@@ -144,9 +161,30 @@ Iterations: Loop 3: ${L3}, Loop 2: ${L2} | Decision: PROCEED
 EOF
 ```
 
+### 5. ACE Reflection (Optional - If `--ace-reflect` flag enabled)
+```bash
+# Only run if --ace-reflect flag was passed to /cfn-loop command
+if [[ "$ACE_REFLECT_ENABLED" == "true" ]]; then
+  echo "📊 Capturing ACE reflection..."
+  ./.claude/skills/cfn-ace-system/invoke-context-reflect.sh \
+    --task-id "${TASK_ID}" \
+    --sprint-id "${SPRINT_NUM}" \
+    --consensus "${CONSENSUS}" \
+    --iterations-loop3 "${L3}" \
+    --iterations-loop2 "${L2}" \
+    --deliverables "$(git diff HEAD~1 --name-only | tr '\n' ',')"
+
+  # Output: Stores reflection in SQLite with tags, confidence, priority
+  # Categories: PATTERN, STRAT, ANTI, EDGE
+  # Automatic tag extraction and deduplication
+  echo "✅ ACE reflection captured: $(sqlite3 .claude/cfn-data/cfn-loop.db 'SELECT COUNT(*) FROM context_reflections WHERE task_id = \"'${TASK_ID}'\"') bullets"
+fi
+```
+
 **Checklist:**
 - [ ] Consensus ≥ threshold | [ ] Product Owner approved | [ ] Deliverables verified
 - [ ] Tests passing | [ ] Git committed | [ ] Git pushed | [ ] Summary generated
+- [ ] ACE reflection captured (if `--ace-reflect` enabled)
 
 ---
 
@@ -341,12 +379,68 @@ Complex/Enterprise (>5 files, >500 LOC): +code-analyzer
 
 ---
 
+## ACE System Integration
+
+### Reflection After Sprint
+After each sprint completion, Task Mode should capture lessons learned:
+
+```bash
+# Automatic reflection capture (called after git push)
+./.claude/skills/cfn-ace-system/invoke-context-reflect.sh \
+  --task-id "${TASK_ID}" \
+  --sprint-id "${SPRINT_NUM}" \
+  --consensus "${CONSENSUS}" \
+  --iterations-loop3 "${L3}" \
+  --iterations-loop2 "${L2}" \
+  --deliverables "$(git diff HEAD~1 --name-only | tr '\n' ',')"
+```
+
+**What Gets Captured:**
+- Patterns that worked well (consensus ≥0.90, low iterations)
+- Anti-patterns that caused issues (high iterations, deliverable failures)
+- Strategy patterns (agent selection, validator scaling effectiveness)
+- Edge cases (timeout scenarios, race conditions, blocking issues)
+
+**Storage:**
+- SQLite database: `.claude/cfn-data/cfn-loop.db`
+- Table: `context_reflections`
+- Automatic tagging, deduplication, confidence scoring
+
+**Benefits:**
+- Future sprints learn from past mistakes
+- Adaptive validator scaling improves over time
+- Pattern recognition across projects
+- Knowledge accumulation (not lost between sessions)
+
+### Optional: Context Injection (Future Enhancement)
+Before spawning agents, inject relevant lessons:
+```bash
+# Not yet implemented in Task Mode, but available:
+./.claude/skills/cfn-ace-system/invoke-context-inject.sh \
+  --task "${TASK_DESCRIPTION}" \
+  --phase "${PHASE_NAME}" \
+  --tags "validation,consensus,deliverables"
+# Returns: Top N relevant bullets from past reflections
+```
+
+### Optional: Context Curation (Periodic Maintenance)
+Merge and deduplicate reflection data:
+```bash
+# Run monthly or after major epics:
+./.claude/skills/cfn-ace-system/invoke-context-curate.sh \
+  --confidence-threshold 0.85 \
+  --merge-similar-patterns
+```
+
+---
+
 ## Related Documentation
 
 - **CFN Coordinator Parameters**: `.claude/commands/cfn/CFN_COORDINATOR_PARAMETERS.md`
 - **Redis Coordination**: `.claude/skills/cfn-redis-coordination/SKILL.md`
 - **Product Owner Decision**: `.claude/skills/cfn-product-owner-decision/SKILL.md`
 - **Agent Output Standards**: `docs/AGENT_OUTPUT_STANDARDS.md`
+- **ACE System**: `.claude/skills/cfn-ace-system/SKILL.md`
 
 ---
 

package/.claude/commands/cfn/cfn-loop.md

@@ -1,6 +1,6 @@
 ---
 description: "Execute autonomous 3-loop self-correcting CFN workflow with automatic retry and consensus validation"
-argument-hint: "<task description> [--phase=name] [--mode=mvp|standard|enterprise] [--spawn-mode=cli|task] [--max-loop2=10] [--max-loop3=10]"
+argument-hint: "<task description> [--phase=name] [--mode=mvp|standard|enterprise] [--spawn-mode=cli|task] [--max-loop2=10] [--max-loop3=10] [--ace-reflect]"
 allowed-tools: ["Task", "TodoWrite", "Read", "Write", "Edit", "Bash", "Glob", "Grep"]
 ---
 
@@ -38,10 +38,11 @@ LOOP 3: Primary Swarm Execution with subtask iterations
 - `--phase=<name>`: Optional phase name for tracking
 - `--mode=<mvp|standard|enterprise>`: Coordinator mode (default: standard)
 - `--spawn-mode=<cli|task>`: Agent spawning method (default: cli)
-  - **cli**: Cost-optimized (95-98% savings), background execution, Redis monitoring
-  - **task**: Full visibility in Main Chat, direct spawning, debugging
+  - **cli**: Cost-optimized (95-98% savings), background execution, Redis monitoring, ACE always enabled
+  - **task**: Full visibility in Main Chat, direct spawning, debugging, ACE optional via flag
 - `--max-loop2=<n>`: Max consensus iterations (default: 10)
 - `--max-loop3=<n>`: Max primary swarm iterations (default: 10)
+- `--ace-reflect`: Enable ACE reflection after each sprint (Task mode only, captures lessons learned)
 
 ## Coordinator Modes
 

package/.claude/hooks/cfn-invoke-pre-edit.sh

@@ -0,0 +1,88 @@
+#!/bin/bash
+
+# Pre-Edit Backup Hook Wrapper
+# Creates backup before file modifications in agent workflows
+#
+# Usage: .claude/hooks/cfn-invoke-pre-edit.sh FILE_PATH --agent-id AGENT_ID
+#
+# Arguments:
+#   FILE_PATH   - Absolute path to file about to be edited
+#   --agent-id  - Unique identifier for the agent performing the edit
+#
+# Returns:
+#   Backup directory path on success
+#   Exit code 1 on failure
+#
+# Example:
+#   BACKUP_PATH=$(./.claude/hooks/cfn-invoke-pre-edit.sh "/path/to/file.txt" --agent-id "backend-dev-1")
+
+set -euo pipefail
+
+# === Parse Arguments ===
+
+FILE_PATH=""
+AGENT_ID=""
+
+# First positional argument is file path
+if [[ -n "${1:-}" ]] && [[ "$1" != --* ]]; then
+    FILE_PATH="$1"
+    shift
+fi
+
+# Parse remaining named arguments
+while [[ "$#" -gt 0 ]]; do
+    case $1 in
+        --agent-id)
+            if [[ -z "${2:-}" ]]; then
+                echo "Error: --agent-id requires a value" >&2
+                exit 1
+            fi
+            AGENT_ID="$2"
+            shift 2
+            ;;
+        *)
+            echo "Error: Unknown argument: $1" >&2
+            echo "Usage: cfn-invoke-pre-edit.sh FILE_PATH --agent-id AGENT_ID" >&2
+            exit 1
+            ;;
+    esac
+done
+
+# === Validate Inputs ===
+
+if [[ -z "$FILE_PATH" ]]; then
+    echo "Error: No file path provided" >&2
+    echo "Usage: cfn-invoke-pre-edit.sh FILE_PATH --agent-id AGENT_ID" >&2
+    exit 1
+fi
+
+if [[ -z "$AGENT_ID" ]]; then
+    echo "Error: No agent ID provided" >&2
+    echo "Usage: cfn-invoke-pre-edit.sh FILE_PATH --agent-id AGENT_ID" >&2
+    exit 1
+fi
+
+if [[ ! -f "$FILE_PATH" ]]; then
+    echo "Error: File does not exist: $FILE_PATH" >&2
+    exit 1
+fi
+
+# === Execute Pre-Edit Backup ===
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+BACKUP_SCRIPT="${SCRIPT_DIR}/../skills/pre-edit-backup/backup.sh"
+
+if [[ ! -f "$BACKUP_SCRIPT" ]]; then
+    echo "Error: Backup script not found: $BACKUP_SCRIPT" >&2
+    exit 1
+fi
+
+# Execute backup and capture output
+if ! BACKUP_DIR=$("$BACKUP_SCRIPT" "$FILE_PATH" "$AGENT_ID" 2>&1); then
+    echo "Error: Backup failed: $BACKUP_DIR" >&2
+    exit 1
+fi
+
+# Return backup directory path
+echo "$BACKUP_DIR"
+exit 0

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

@@ -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