claude-flow-novice 2.5.2 → 2.8.1

package/.claude/skills/playbook/SKILL.md

@@ -0,0 +1,113 @@
+# Playbook Learning System
+
+**Version:** 1.0.0
+**Purpose:** Store and query successful CFN Loop patterns for continuous improvement
+
+## Overview
+
+The playbook system stores execution patterns from successful CFN Loops:
+- Task patterns (type, description, keywords)
+- Optimal agent configurations
+- Iteration counts and convergence patterns
+- Common feedback themes
+- Success strategies
+
+## Database Schema
+
+**File:** `.claude/skills/playbook/playbook.db` (SQLite)
+
+**Tables:**
+
+### playbook_entries
+```sql
+CREATE TABLE playbook_entries (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  task_pattern TEXT NOT NULL,        -- Task description or embedding
+  task_type TEXT NOT NULL,            -- software-development, content-creation, etc.
+  task_keywords TEXT,                 -- Comma-separated keywords
+  loop3_agents TEXT NOT NULL,         -- JSON array
+  loop2_agents TEXT NOT NULL,         -- JSON array
+  loop4_agent TEXT DEFAULT 'product-owner',
+  iterations_required INTEGER,
+  final_confidence REAL,
+  final_consensus REAL,
+  gate_threshold REAL DEFAULT 0.75,
+  consensus_threshold REAL DEFAULT 0.90,
+  complexity TEXT,                    -- low, medium, high
+  estimated_iterations INTEGER,
+  actual_iterations INTEGER,
+  common_feedback TEXT,               -- JSON array of recurring themes
+  success_strategy TEXT,              -- JSON object
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  use_count INTEGER DEFAULT 1         -- How many times this pattern was reused
+);
+
+CREATE INDEX idx_task_type ON playbook_entries(task_type);
+CREATE INDEX idx_task_pattern ON playbook_entries(task_pattern);
+CREATE INDEX idx_final_confidence ON playbook_entries(final_confidence DESC);
+CREATE INDEX idx_use_count ON playbook_entries(use_count DESC);
+```
+
+### agent_performance
+```sql
+CREATE TABLE agent_performance (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  agent_type TEXT NOT NULL,
+  task_type TEXT NOT NULL,
+  avg_confidence REAL,
+  execution_count INTEGER DEFAULT 1,
+  success_rate REAL,
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  UNIQUE(agent_type, task_type)
+);
+
+CREATE INDEX idx_agent_performance ON agent_performance(agent_type, task_type);
+```
+
+## Usage
+
+### Query Playbook
+```bash
+SIMILAR_PATTERN=$(./.claude/skills/playbook/query-playbook.sh \
+  --task-type "software-development" \
+  --description "Implement OAuth2 authentication")
+
+echo "$SIMILAR_PATTERN" | jq '.loop3_agents'
+# ["backend-dev", "security-specialist"]
+```
+
+### Update Playbook
+```bash
+./.claude/skills/playbook/update-playbook.sh \
+  --task-id "$TASK_ID" \
+  --task-type "software-development" \
+  --description "Implement JWT authentication" \
+  --loop3-agents "backend-dev,security-specialist" \
+  --loop2-agents "reviewer,tester,security-auditor" \
+  --iterations 3 \
+  --final-confidence 0.92 \
+  --final-consensus 0.93
+```
+
+## Similarity Matching
+
+**Algorithm:** Keyword overlap (Jaccard similarity)
+
+```
+Similarity = Intersection(keywords1, keywords2) / Union(keywords1, keywords2)
+```
+
+**Thresholds:**
+- ≥ 0.6: Potentially similar
+- ≥ 0.75: Similar (use this pattern)
+- ≥ 0.90: Very similar (high confidence match)
+
+## Integration
+
+Used by:
+- `.claude/agents/cfn-v3-coordinator.md` - Query for similar tasks
+- Main Chat post-execution - Update playbook after PROCEED
+- Loop 5 retrospective - Extract patterns and update playbook
+```

package/.claude/skills/playbook/init-playbook.sh

@@ -0,0 +1,54 @@
+#!/bin/bash
+set -eu
+
+# Initialize Playbook Database
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+DB_PATH="$SCRIPT_DIR/playbook.db"
+
+# Create database if not exists
+sqlite3 "$DB_PATH" <<'EOF'
+CREATE TABLE IF NOT EXISTS playbook_entries (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  task_pattern TEXT NOT NULL,
+  task_type TEXT NOT NULL,
+  task_keywords TEXT,
+  loop3_agents TEXT NOT NULL,
+  loop2_agents TEXT NOT NULL,
+  loop4_agent TEXT DEFAULT 'product-owner',
+  iterations_required INTEGER,
+  final_confidence REAL,
+  final_consensus REAL,
+  gate_threshold REAL DEFAULT 0.75,
+  consensus_threshold REAL DEFAULT 0.90,
+  complexity TEXT,
+  estimated_iterations INTEGER,
+  actual_iterations INTEGER,
+  common_feedback TEXT,
+  success_strategy TEXT,
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  use_count INTEGER DEFAULT 1
+);
+
+CREATE INDEX IF NOT EXISTS idx_task_type ON playbook_entries(task_type);
+CREATE INDEX IF NOT EXISTS idx_task_pattern ON playbook_entries(task_pattern);
+CREATE INDEX IF NOT EXISTS idx_final_confidence ON playbook_entries(final_confidence DESC);
+CREATE INDEX IF NOT EXISTS idx_use_count ON playbook_entries(use_count DESC);
+
+CREATE TABLE IF NOT EXISTS agent_performance (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  agent_type TEXT NOT NULL,
+  task_type TEXT NOT NULL,
+  avg_confidence REAL,
+  execution_count INTEGER DEFAULT 1,
+  success_rate REAL,
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  UNIQUE(agent_type, task_type)
+);
+
+CREATE INDEX IF NOT EXISTS idx_agent_performance ON agent_performance(agent_type, task_type);
+EOF
+
+echo "✅ Playbook database initialized at $DB_PATH"

package/.claude/skills/playbook/query-playbook.sh

@@ -0,0 +1,79 @@
+#!/bin/bash
+set -euo pipefail
+
+# Query Playbook for Similar Tasks
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+DB_PATH="$SCRIPT_DIR/playbook.db"
+
+TASK_TYPE=""
+DESCRIPTION=""
+
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --task-type) TASK_TYPE="$2"; shift 2 ;;
+    --description) DESCRIPTION="$2"; shift 2 ;;
+    *) echo "Unknown: $1"; exit 1 ;;
+  esac
+done
+
+if [ -z "$TASK_TYPE" ] || [ -z "$DESCRIPTION" ]; then
+  echo "Usage: query-playbook.sh --task-type TYPE --description 'text'" >&2
+  exit 1
+fi
+
+# Initialize DB if not exists
+if [ ! -f "$DB_PATH" ]; then
+  bash "$SCRIPT_DIR/init-playbook.sh"
+fi
+
+# Extract keywords from description (simple tokenization)
+KEYWORDS=$(echo "$DESCRIPTION" | tr '[:upper:]' '[:lower:]' | grep -oE '\w+' | sort -u | tr '\n' ',' | sed 's/,$//')
+
+# Query for similar tasks (same task type)
+SIMILAR=$(sqlite3 "$DB_PATH" <<EOF
+SELECT
+  task_pattern,
+  loop3_agents,
+  loop2_agents,
+  iterations_required,
+  final_confidence,
+  common_feedback,
+  use_count
+FROM playbook_entries
+WHERE task_type = '$TASK_TYPE'
+ORDER BY final_confidence DESC, use_count DESC
+LIMIT 3;
+EOF
+)
+
+# If no results, return empty
+if [ -z "$SIMILAR" ]; then
+  echo "{}"
+  exit 0
+fi
+
+# Return first (best) match
+FIRST_MATCH=$(echo "$SIMILAR" | head -1)
+
+TASK_PATTERN=$(echo "$FIRST_MATCH" | cut -d'|' -f1)
+LOOP3_AGENTS=$(echo "$FIRST_MATCH" | cut -d'|' -f2)
+LOOP2_AGENTS=$(echo "$FIRST_MATCH" | cut -d'|' -f3)
+ITERATIONS=$(echo "$FIRST_MATCH" | cut -d'|' -f4)
+CONFIDENCE=$(echo "$FIRST_MATCH" | cut -d'|' -f5)
+FEEDBACK=$(echo "$FIRST_MATCH" | cut -d'|' -f6)
+USE_COUNT=$(echo "$FIRST_MATCH" | cut -d'|' -f7)
+
+# Build JSON output
+cat <<EOF
+{
+  "found": true,
+  "task_pattern": "$TASK_PATTERN",
+  "loop3_agents": $LOOP3_AGENTS,
+  "loop2_agents": $LOOP2_AGENTS,
+  "expected_iterations": $ITERATIONS,
+  "historical_confidence": $CONFIDENCE,
+  "common_feedback": $FEEDBACK,
+  "use_count": $USE_COUNT
+}
+EOF

package/.claude/skills/playbook/update-playbook.sh

@@ -0,0 +1,69 @@
+#!/bin/bash
+set -euo pipefail
+
+# Update Playbook after Successful CFN Loop
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+DB_PATH="$SCRIPT_DIR/playbook.db"
+
+TASK_ID=""
+TASK_TYPE=""
+DESCRIPTION=""
+LOOP3_AGENTS=""
+LOOP2_AGENTS=""
+ITERATIONS=""
+FINAL_CONFIDENCE=""
+FINAL_CONSENSUS=""
+
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --task-id) TASK_ID="$2"; shift 2 ;;
+    --task-type) TASK_TYPE="$2"; shift 2 ;;
+    --description) DESCRIPTION="$2"; shift 2 ;;
+    --loop3-agents) LOOP3_AGENTS="$2"; shift 2 ;;
+    --loop2-agents) LOOP2_AGENTS="$2"; shift 2 ;;
+    --iterations) ITERATIONS="$2"; shift 2 ;;
+    --final-confidence) FINAL_CONFIDENCE="$2"; shift 2 ;;
+    --final-consensus) FINAL_CONSENSUS="$2"; shift 2 ;;
+    *) echo "Unknown: $1"; exit 1 ;;
+  esac
+done
+
+# Initialize DB if not exists
+if [ ! -f "$DB_PATH" ]; then
+  bash "$SCRIPT_DIR/init-playbook.sh"
+fi
+
+# Convert agent lists to JSON arrays
+LOOP3_JSON=$(echo "$LOOP3_AGENTS" | jq -Rc 'split(",") | map(gsub("^\\s+|\\s+$"; ""))')
+LOOP2_JSON=$(echo "$LOOP2_AGENTS" | jq -Rc 'split(",") | map(gsub("^\\s+|\\s+$"; ""))')
+
+# Extract keywords
+KEYWORDS=$(echo "$DESCRIPTION" | tr '[:upper:]' '[:lower:]' | grep -oE '\w+' | sort -u | tr '\n' ',' | sed 's/,$//')
+
+# Insert into playbook
+sqlite3 "$DB_PATH" <<EOF
+INSERT INTO playbook_entries (
+  task_pattern,
+  task_type,
+  task_keywords,
+  loop3_agents,
+  loop2_agents,
+  iterations_required,
+  final_confidence,
+  final_consensus,
+  actual_iterations
+) VALUES (
+  '$DESCRIPTION',
+  '$TASK_TYPE',
+  '$KEYWORDS',
+  '$LOOP3_JSON',
+  '$LOOP2_JSON',
+  $ITERATIONS,
+  $FINAL_CONFIDENCE,
+  $FINAL_CONSENSUS,
+  $ITERATIONS
+);
+EOF
+
+echo "✅ Playbook updated with task execution pattern"

package/.claude/skills/playbook-auto-update/SKILL.md

@@ -0,0 +1,29 @@
+# Playbook Auto-Update Skill
+
+## Purpose
+Automatically update playbook with insights from sprint retrospectives.
+
+## Core Responsibilities
+- Parse retrospective JSON
+- Update agent performance metrics
+- Store successful strategies
+- Increment pattern counters
+- Maintain historical performance data
+
+## Update Strategy
+- Incremental updates
+- Preserve historical context
+- Allow rollback/review of changes
+- Ensure data integrity
+
+## Performance Tracking
+- Per-agent performance by task type
+- Confidence score trending
+- Execution frequency
+- Improvement over time
+
+## Safety Mechanisms
+- Validation of input data
+- Backup of previous playbook version
+- Logging of all modifications
+- Ability to revert changes

package/.claude/skills/playbook-auto-update/auto-update-playbook.sh

@@ -0,0 +1,86 @@
+#!/bin/bash
+
+# Playbook Auto-Update Script
+
+set -euo pipefail
+
+# Validate input
+[[ $# -ne 2 ]] && { echo "Usage: $0 --retrospective-json JSON --task-id TASK_ID"; exit 1; }
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+    key="$1"
+    case $key in
+        --retrospective-json)
+            RETROSPECTIVE_JSON="$2"
+            shift 2
+            ;;
+        --task-id)
+            TASK_ID="$2"
+            shift 2
+            ;;
+        *)
+            echo "Unknown parameter: $1"
+            exit 1
+            ;;
+    esac
+done
+
+# Validate required parameters
+[[ -z "${RETROSPECTIVE_JSON:-}" ]] && { echo "Error: retrospective-json is required"; exit 1; }
+[[ -z "${TASK_ID:-}" ]] && { echo "Error: task-id is required"; exit 1; }
+
+# Playbook path
+PLAYBOOK_PATH="/mnt/c/Users/masha/Documents/claude-flow-novice/docs/PLAYBOOK.json"
+BACKUP_PATH="/mnt/c/Users/masha/Documents/claude-flow-novice/docs/playbook-backups/PLAYBOOK_${TASK_ID}_$(date +%Y%m%d_%H%M%S).json"
+
+# Ensure backup directory exists
+mkdir -p "$(dirname "$BACKUP_PATH")"
+
+# Backup current playbook
+cp "$PLAYBOOK_PATH" "$BACKUP_PATH"
+
+# Update playbook with jq
+updated_playbook=$(echo "$RETROSPECTIVE_JSON" | jq '
+    # Update or create tasks record
+    .tasks //= [] |
+    .tasks += [{
+        "task_id": env.TASK_ID,
+        "sprint_metrics": {
+            "total_iterations": .velocity.total_iterations,
+            "confidence_trajectory": .confidence_trajectory,
+            "final_confidence": .confidence_trajectory["iteration_3"] // 0
+        },
+        "agent_performance": .agent_performance,
+        "patterns_identified": .patterns_identified
+    }] |
+
+    # Update agent performance tracking
+    .agent_performance_history //= {} |
+    reduce .agent_performance.top_performers[] as $agent (
+        .;
+        .agent_performance_history[$agent.agent] //= {
+            "total_tasks": 0,
+            "avg_confidence": 0
+        } |
+        .agent_performance_history[$agent.agent].total_tasks += 1 |
+        .agent_performance_history[$agent.agent].avg_confidence =
+            ((.agent_performance_history[$agent.agent].avg_confidence *
+              (.agent_performance_history[$agent.agent].total_tasks - 1) +
+              $agent.avg_confidence) /
+             .agent_performance_history[$agent.agent].total_tasks)
+    ) |
+
+    # Track successful strategies
+    .successful_strategies //= [] |
+    .successful_strategies += .lessons_learned |
+
+    # Remove redundant data to keep playbook lean
+    del(.feedback_themes, .bottlenecks)
+')
+
+# Write updated playbook
+echo "$updated_playbook" | jq . > "$PLAYBOOK_PATH"
+
+# Log update
+echo "Playbook updated for task $TASK_ID: $BACKUP_PATH → $PLAYBOOK_PATH"