claude-flow-novice 2.10.4 → 2.10.6

package/claude-assets/skills/cfn-agent-spawning/spawn-templates.sh

@@ -0,0 +1,613 @@
+#!/bin/bash
+
+# Agent Spawning Templates
+# Reusable CLI invocation patterns for common multi-agent scenarios
+#
+# Usage:
+#   source .claude/skills/cfn-agent-spawning/spawn-templates.sh
+#   spawn_feature_development "Implement user authentication"
+#   spawn_security_audit "Audit payment processing system"
+#
+# All templates use:
+# - Explicit --agents flag with typed agents
+# - z.ai provider for cost optimization
+# - Redis coordination channels
+# - Appropriate topology for task complexity
+
+set -euo pipefail
+
+# Base directory for spawn-workers.js
+SPAWN_CLI="node src/cli/hybrid-routing/spawn-workers.js"
+
+# Default provider (cost-optimized)
+DEFAULT_PROVIDER="zai"
+
+# ============================================================================
+# CORE DEVELOPMENT PATTERNS
+# ============================================================================
+
+# Feature Development (4 agents)
+# Use for: Standard feature implementation with design, code, and validation
+spawn_feature_development() {
+  local task="$1"
+  local channel="${2:-swarm:feature}"
+
+  $SPAWN_CLI "$task" \
+    --agents=architect,coder,tester,reviewer \
+    --provider $DEFAULT_PROVIDER \
+    --redis-channel "$channel" \
+    --topology sequential
+}
+
+# Complex Feature Development (5 agents with analysis)
+# Use for: Complex features requiring upfront analysis
+spawn_complex_feature() {
+  local task="$1"
+  local channel="${2:-swarm:complex-feature}"
+
+  $SPAWN_CLI "$task" \
+    --agents=analyst,architect,coder,tester,reviewer \
+    --provider $DEFAULT_PROVIDER \
+    --redis-channel "$channel" \
+    --topology sequential
+}
+
+# Rapid Prototyping (3 agents)
+# Use for: Quick MVPs and proof-of-concepts
+spawn_rapid_prototype() {
+  local task="$1"
+  local channel="${2:-swarm:prototype}"
+
+  $SPAWN_CLI "$task" \
+    --agents=architect,coder,tester \
+    --provider $DEFAULT_PROVIDER \
+    --redis-channel "$channel" \
+    --topology sequential
+}
+
+# ============================================================================
+# SECURITY PATTERNS
+# ============================================================================
+
+# Security Audit (4 agents)
+# Use for: Comprehensive security assessment
+spawn_security_audit() {
+  local task="$1"
+  local channel="${2:-swarm:security-audit}"
+
+  $SPAWN_CLI "$task" \
+    --agents=security-specialist,code-analyzer,tester,production-validator \
+    --provider $DEFAULT_PROVIDER \
+    --redis-channel "$channel" \
+    --topology sequential
+}
+
+# Security-Critical Feature (5 agents)
+# Use for: Features handling sensitive data or authentication
+spawn_security_feature() {
+  local task="$1"
+  local channel="${2:-swarm:security-feature}"
+
+  $SPAWN_CLI "$task" \
+    --agents=architect,backend-dev,security-specialist,tester,production-validator \
+    --provider $DEFAULT_PROVIDER \
+    --redis-channel "$channel" \
+    --topology sequential
+}
+
+# ============================================================================
+# PERFORMANCE PATTERNS
+# ============================================================================
+
+# Performance Optimization (4 agents)
+# Use for: Identifying and fixing performance bottlenecks
+spawn_performance_optimization() {
+  local task="$1"
+  local channel="${2:-swarm:perf-optimization}"
+
+  $SPAWN_CLI "$task" \
+    --agents=perf-analyzer,code-booster,backend-dev,tester \
+    --provider $DEFAULT_PROVIDER \
+    --redis-channel "$channel" \
+    --topology sequential
+}
+
+# High-Performance Feature (5 agents)
+# Use for: Performance-critical feature development
+spawn_high_performance_feature() {
+  local task="$1"
+  local channel="${2:-swarm:high-perf-feature}"
+
+  $SPAWN_CLI "$task" \
+    --agents=architect,coder,perf-analyzer,code-booster,tester \
+    --provider $DEFAULT_PROVIDER \
+    --redis-channel "$channel" \
+    --topology sequential
+}
+
+# ============================================================================
+# ARCHITECTURE PATTERNS
+# ============================================================================
+
+# System Architecture Design (4 agents)
+# Use for: Large-scale system design and planning
+spawn_system_architecture() {
+  local task="$1"
+  local channel="${2:-swarm:architecture}"
+
+  $SPAWN_CLI "$task" \
+    --agents=system-architect,architect,devops-engineer,security-architect-persona \
+    --provider $DEFAULT_PROVIDER \
+    --redis-channel "$channel" \
+    --topology collaborative \
+    --timeout 360000
+}
+
+# Architecture Review (3 agents)
+# Use for: Reviewing existing architecture
+spawn_architecture_review() {
+  local task="$1"
+  local channel="${2:-swarm:arch-review}"
+
+  $SPAWN_CLI "$task" \
+    --agents=system-architect,code-analyzer,perf-analyzer \
+    --provider $DEFAULT_PROVIDER \
+    --redis-channel "$channel" \
+    --topology bidirectional \
+    --timeout 300000
+}
+
+# ============================================================================
+# API DEVELOPMENT PATTERNS
+# ============================================================================
+
+# API Development (5 agents)
+# Use for: Comprehensive API design, implementation, and documentation
+spawn_api_development() {
+  local task="$1"
+  local channel="${2:-swarm:api-dev}"
+
+  $SPAWN_CLI "$task" \
+    --agents=api-designer-persona,backend-dev,api-docs,security-specialist,tester \
+    --provider $DEFAULT_PROVIDER \
+    --redis-channel "$channel" \
+    --topology sequential
+}
+
+# API Enhancement (4 agents)
+# Use for: Improving existing APIs
+spawn_api_enhancement() {
+  local task="$1"
+  local channel="${2:-swarm:api-enhancement}"
+
+  $SPAWN_CLI "$task" \
+    --agents=backend-dev,api-docs,security-specialist,tester \
+    --provider $DEFAULT_PROVIDER \
+    --redis-channel "$channel" \
+    --topology sequential
+}
+
+# ============================================================================
+# MOBILE DEVELOPMENT PATTERNS
+# ============================================================================
+
+# Mobile Development (4 agents)
+# Use for: React Native or cross-platform mobile apps
+spawn_mobile_development() {
+  local task="$1"
+  local channel="${2:-swarm:mobile-dev}"
+
+  $SPAWN_CLI "$task" \
+    --agents=mobile-dev,react-frontend-engineer,ui-designer,tester \
+    --provider $DEFAULT_PROVIDER \
+    --redis-channel "$channel" \
+    --topology sequential
+}
+
+# Mobile Feature (3 agents)
+# Use for: Quick mobile feature implementation
+spawn_mobile_feature() {
+  local task="$1"
+  local channel="${2:-swarm:mobile-feature}"
+
+  $SPAWN_CLI "$task" \
+    --agents=mobile-dev,react-frontend-engineer,tester \
+    --provider $DEFAULT_PROVIDER \
+    --redis-channel "$channel" \
+    --topology sequential
+}
+
+# ============================================================================
+# INFRASTRUCTURE PATTERNS
+# ============================================================================
+
+# Infrastructure Setup (4 agents)
+# Use for: Setting up cloud infrastructure, containers, CI/CD
+spawn_infrastructure_setup() {
+  local task="$1"
+  local channel="${2:-swarm:infrastructure}"
+
+  $SPAWN_CLI "$task" \
+    --agents=devops-engineer,system-architect,security-specialist,tester \
+    --provider $DEFAULT_PROVIDER \
+    --redis-channel "$channel" \
+    --topology sequential
+}
+
+# Production Deployment (4 agents)
+# Use for: Deploying to production with validation gates
+spawn_production_deployment() {
+  local task="$1"
+  local channel="${2:-swarm:production-deploy}"
+
+  $SPAWN_CLI "$task" \
+    --agents=devops-engineer,security-specialist,production-validator,tester \
+    --provider $DEFAULT_PROVIDER \
+    --redis-channel "$channel" \
+    --topology release-gate \
+    --timeout 360000
+}
+
+# ============================================================================
+# QUALITY ASSURANCE PATTERNS
+# ============================================================================
+
+# Code Quality Review (3 agents)
+# Use for: Comprehensive code quality assessment
+spawn_code_quality_review() {
+  local task="$1"
+  local channel="${2:-swarm:quality-review}"
+
+  $SPAWN_CLI "$task" \
+    --agents=code-analyzer,code-quality-validator,perf-analyzer \
+    --provider $DEFAULT_PROVIDER \
+    --redis-channel "$channel" \
+    --topology sequential
+}
+
+# Test Suite Development (3 agents)
+# Use for: Creating comprehensive test coverage
+spawn_test_suite_development() {
+  local task="$1"
+  local channel="${2:-swarm:test-suite}"
+
+  $SPAWN_CLI "$task" \
+    --agents=tester,playwright-tester,interaction-tester \
+    --provider $DEFAULT_PROVIDER \
+    --redis-channel "$channel" \
+    --topology sequential
+}
+
+# ============================================================================
+# FRONTEND DEVELOPMENT PATTERNS
+# ============================================================================
+
+# Frontend Feature (4 agents)
+# Use for: React/frontend feature with UI design
+spawn_frontend_feature() {
+  local task="$1"
+  local channel="${2:-swarm:frontend-feature}"
+
+  $SPAWN_CLI "$task" \
+    --agents=react-frontend-engineer,ui-designer,state-architect,tester \
+    --provider $DEFAULT_PROVIDER \
+    --redis-channel "$channel" \
+    --topology sequential
+}
+
+# UI Component Library (4 agents)
+# Use for: Building reusable UI component systems
+spawn_ui_component_library() {
+  local task="$1"
+  local channel="${2:-swarm:ui-components}"
+
+  $SPAWN_CLI "$task" \
+    --agents=ui-designer,react-frontend-engineer,accessibility-advocate-persona,tester \
+    --provider $DEFAULT_PROVIDER \
+    --redis-channel "$channel" \
+    --topology sequential
+}
+
+# ============================================================================
+# BACKEND DEVELOPMENT PATTERNS
+# ============================================================================
+
+# Backend Service (4 agents)
+# Use for: Standalone backend service development
+spawn_backend_service() {
+  local task="$1"
+  local channel="${2:-swarm:backend-service}"
+
+  $SPAWN_CLI "$task" \
+    --agents=architect,backend-dev,security-specialist,tester \
+    --provider $DEFAULT_PROVIDER \
+    --redis-channel "$channel" \
+    --topology sequential
+}
+
+# Database Schema Design (4 agents)
+# Use for: Database schema and migration planning
+spawn_database_schema() {
+  local task="$1"
+  local channel="${2:-swarm:database-schema}"
+
+  $SPAWN_CLI "$task" \
+    --agents=architect,backend-dev,perf-analyzer,tester \
+    --provider $DEFAULT_PROVIDER \
+    --redis-channel "$channel" \
+    --topology collaborative \
+    --timeout 360000
+}
+
+# ============================================================================
+# SPECIALIZED PATTERNS
+# ============================================================================
+
+# Rust Development (3 agents)
+# Use for: Rust projects with performance requirements
+spawn_rust_development() {
+  local task="$1"
+  local channel="${2:-swarm:rust-dev}"
+
+  $SPAWN_CLI "$task" \
+    --agents=rust-developer,perf-analyzer,tester \
+    --provider $DEFAULT_PROVIDER \
+    --redis-channel "$channel" \
+    --topology sequential
+}
+
+# Blockchain Feature (4 agents)
+# Use for: Blockchain/distributed consensus features
+spawn_blockchain_feature() {
+  local task="$1"
+  local channel="${2:-swarm:blockchain}"
+
+  $SPAWN_CLI "$task" \
+    --agents=security-manager,consensus-builder,backend-dev,tester \
+    --provider $DEFAULT_PROVIDER \
+    --redis-channel "$channel" \
+    --topology collaborative \
+    --timeout 360000
+}
+
+# Documentation Generation (3 agents)
+# Use for: Comprehensive documentation creation
+spawn_documentation_generation() {
+  local task="$1"
+  local channel="${2:-swarm:documentation}"
+
+  $SPAWN_CLI "$task" \
+    --agents=api-docs,researcher,reviewer \
+    --provider $DEFAULT_PROVIDER \
+    --redis-channel "$channel" \
+    --topology sequential
+}
+
+# ============================================================================
+# CFN LOOP PATTERNS
+# ============================================================================
+
+# CFN Loop MVP (3 agents)
+# Use for: Rapid prototyping with MVP quality gates
+spawn_cfn_mvp() {
+  local task="$1"
+  local channel="${2:-swarm:cfn-mvp}"
+
+  $SPAWN_CLI "$task" \
+    --agents=cfn-coordinator-mvp,coder,tester \
+    --provider $DEFAULT_PROVIDER \
+    --redis-channel "$channel" \
+    --topology sequential
+}
+
+# CFN Loop Standard (5 agents)
+# Use for: Standard development with balanced quality gates
+spawn_cfn_standard() {
+  local task="$1"
+  local channel="${2:-swarm:cfn-standard}"
+
+  $SPAWN_CLI "$task" \
+    --agents=cfn-coordinator-standard,architect,coder,security-specialist,tester \
+    --provider $DEFAULT_PROVIDER \
+    --redis-channel "$channel" \
+    --topology sequential
+}
+
+# CFN Loop Enterprise (6 agents)
+# Use for: Enterprise-grade development with full compliance
+spawn_cfn_enterprise() {
+  local task="$1"
+  local channel="${2:-swarm:cfn-enterprise}"
+
+  $SPAWN_CLI "$task" \
+    --agents=cfn-coordinator-enterprise,system-architect,backend-dev,security-specialist,devops-engineer,production-validator \
+    --provider $DEFAULT_PROVIDER \
+    --redis-channel "$channel" \
+    --topology collaborative \
+    --timeout 360000
+}
+
+# ============================================================================
+# MULTI-AGENT COORDINATION PATTERNS
+# ============================================================================
+
+# Enterprise System (6 agents)
+# Use for: Large-scale enterprise system development
+spawn_enterprise_system() {
+  local task="$1"
+  local channel="${2:-swarm:enterprise}"
+
+  $SPAWN_CLI "$task" \
+    --agents=system-architect,architect,backend-dev,security-specialist,devops-engineer,production-validator \
+    --provider $DEFAULT_PROVIDER \
+    --redis-channel "$channel" \
+    --topology collaborative \
+    --timeout 360000
+}
+
+# Research and Implementation (4 agents)
+# Use for: Tasks requiring research before implementation
+spawn_research_and_implementation() {
+  local task="$1"
+  local channel="${2:-swarm:research-impl}"
+
+  $SPAWN_CLI "$task" \
+    --agents=researcher,analyst,coder,tester \
+    --provider $DEFAULT_PROVIDER \
+    --redis-channel "$channel" \
+    --topology bidirectional \
+    --timeout 300000
+}
+
+# Legacy System Refactoring (5 agents)
+# Use for: Refactoring legacy codebases
+spawn_legacy_refactoring() {
+  local task="$1"
+  local channel="${2:-swarm:refactoring}"
+
+  $SPAWN_CLI "$task" \
+    --agents=code-analyzer,architect,code-booster,tester,reviewer \
+    --provider $DEFAULT_PROVIDER \
+    --redis-channel "$channel" \
+    --topology bidirectional \
+    --timeout 300000
+}
+
+# ============================================================================
+# UTILITY FUNCTIONS
+# ============================================================================
+
+# Custom Agent Spawning
+# Use for: Non-standard agent combinations
+spawn_custom() {
+  local task="$1"
+  local agents="$2"
+  local channel="${3:-swarm:custom}"
+  local topology="${4:-sequential}"
+
+  $SPAWN_CLI "$task" \
+    --agents="$agents" \
+    --provider $DEFAULT_PROVIDER \
+    --redis-channel "$channel" \
+    --topology "$topology"
+}
+
+# List Available Templates
+list_spawn_templates() {
+  echo "Available Spawn Templates:"
+  echo ""
+  echo "Core Development:"
+  echo "  spawn_feature_development"
+  echo "  spawn_complex_feature"
+  echo "  spawn_rapid_prototype"
+  echo ""
+  echo "Security:"
+  echo "  spawn_security_audit"
+  echo "  spawn_security_feature"
+  echo ""
+  echo "Performance:"
+  echo "  spawn_performance_optimization"
+  echo "  spawn_high_performance_feature"
+  echo ""
+  echo "Architecture:"
+  echo "  spawn_system_architecture"
+  echo "  spawn_architecture_review"
+  echo ""
+  echo "API Development:"
+  echo "  spawn_api_development"
+  echo "  spawn_api_enhancement"
+  echo ""
+  echo "Mobile Development:"
+  echo "  spawn_mobile_development"
+  echo "  spawn_mobile_feature"
+  echo ""
+  echo "Infrastructure:"
+  echo "  spawn_infrastructure_setup"
+  echo "  spawn_production_deployment"
+  echo ""
+  echo "Quality Assurance:"
+  echo "  spawn_code_quality_review"
+  echo "  spawn_test_suite_development"
+  echo ""
+  echo "Frontend Development:"
+  echo "  spawn_frontend_feature"
+  echo "  spawn_ui_component_library"
+  echo ""
+  echo "Backend Development:"
+  echo "  spawn_backend_service"
+  echo "  spawn_database_schema"
+  echo ""
+  echo "Specialized:"
+  echo "  spawn_rust_development"
+  echo "  spawn_blockchain_feature"
+  echo "  spawn_documentation_generation"
+  echo ""
+  echo "CFN Loop:"
+  echo "  spawn_cfn_mvp"
+  echo "  spawn_cfn_standard"
+  echo "  spawn_cfn_enterprise"
+  echo ""
+  echo "Multi-Agent Coordination:"
+  echo "  spawn_enterprise_system"
+  echo "  spawn_research_and_implementation"
+  echo "  spawn_legacy_refactoring"
+  echo ""
+  echo "Utility:"
+  echo "  spawn_custom <task> <agents> [channel] [topology]"
+  echo "  list_spawn_templates"
+}
+
+# Print template usage information
+print_template_info() {
+  local template="$1"
+
+  case "$template" in
+    spawn_feature_development)
+      echo "Feature Development (4 agents)"
+      echo "Agents: architect, coder, tester, reviewer"
+      echo "Topology: sequential"
+      echo "Use for: Standard feature implementation with design, code, and validation"
+      echo "Example: spawn_feature_development 'Implement user authentication' swarm:auth"
+      ;;
+    spawn_security_audit)
+      echo "Security Audit (4 agents)"
+      echo "Agents: security-specialist, code-analyzer, tester, production-validator"
+      echo "Topology: sequential"
+      echo "Use for: Comprehensive security assessment"
+      echo "Example: spawn_security_audit 'Audit payment processing system' swarm:security"
+      ;;
+    spawn_system_architecture)
+      echo "System Architecture Design (4 agents)"
+      echo "Agents: system-architect, architect, devops-engineer, security-architect-persona"
+      echo "Topology: collaborative (6 minutes timeout)"
+      echo "Use for: Large-scale system design and planning"
+      echo "Example: spawn_system_architecture 'Design microservices architecture' swarm:architecture"
+      ;;
+    *)
+      echo "Unknown template: $template"
+      echo "Run list_spawn_templates to see all available templates"
+      ;;
+  esac
+}
+
+# ============================================================================
+# EXECUTION
+# ============================================================================
+
+# If script is executed directly, show help
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+  echo "Agent Spawning Templates"
+  echo "========================"
+  echo ""
+  echo "This script provides reusable templates for common multi-agent spawning patterns."
+  echo ""
+  echo "Usage:"
+  echo "  source .claude/skills/cfn-agent-spawning/spawn-templates.sh"
+  echo "  spawn_feature_development 'Implement user authentication'"
+  echo ""
+  echo "For a complete list of templates:"
+  echo "  list_spawn_templates"
+  echo ""
+  echo "For template information:"
+  echo "  print_template_info spawn_feature_development"
+fi

package/claude-assets/skills/cfn-agent-swap/SKILL.md

@@ -0,0 +1,36 @@
+# Agent Swap Mechanism Skill
+
+## Purpose
+Recommend agent replacement strategies when performance issues are detected in CFN Loops.
+
+## Replacement Rules
+1. Identify lowest-performing agent
+2. Match replacement based on feedback themes
+   - Security feedback → security-specialist
+   - Performance feedback → performance-engineer
+   - Testing feedback → tester
+   - Architecture feedback → architect
+
+## Replacement Strategies
+- Complete agent replacement
+- Adding specialist alongside existing agents
+- Prioritize maintaining existing team composition
+
+## Usage
+```bash
+./recommend-swap.sh \
+  --loop3-agents "backend-dev,coder" \
+  --loop3-confidences "0.82,0.70" \
+  --feedback-themes "security,error-handling"
+```
+
+## Output Details
+- Agent to remove
+- Reasoning for removal
+- Recommended replacement agent
+- Updated agent configuration
+
+## Implementation Considerations
+- Stateless design
+- Minimal side effects
+- Clear, reproducible recommendations

package/claude-assets/skills/cfn-agent-swap/recommend-swap.sh

@@ -0,0 +1,60 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+    case "$1" in
+        --loop3-agents) IFS=',' read -ra AGENTS <<< "$2"; shift 2 ;;
+        --loop3-confidences) IFS=',' read -ra CONFIDENCES <<< "$2"; shift 2 ;;
+        --feedback-themes) IFS=',' read -ra THEMES <<< "$2"; shift 2 ;;
+        *) echo "Unknown parameter: $1"; exit 1 ;;
+    esac
+done
+
+# Agent Swap Rules
+get_specialist_for_theme() {
+    local theme="$1"
+    case "$theme" in
+        *security*) echo "security-specialist" ;;
+        *performance*) echo "performance-engineer" ;;
+        *test*|*coverage*) echo "testing-expert" ;;
+        *architecture*) echo "architecture-consultant" ;;
+        *) echo "generic-specialist" ;;
+    esac
+}
+
+# Find lowest confidence agent
+lowest_confidence_index=0
+lowest_confidence="${CONFIDENCES[0]}"
+
+for i in "${!CONFIDENCES[@]}"; do
+    if (( $(echo "${CONFIDENCES[i]} < $lowest_confidence" | bc -l) )); then
+        lowest_confidence="${CONFIDENCES[i]}"
+        lowest_confidence_index=$i
+    fi
+done
+
+# Recommend replacement specialist
+recommended_specialist=""
+for theme in "${THEMES[@]}"; do
+    specialist=$(get_specialist_for_theme "$theme")
+    if [[ -n "$specialist" ]]; then
+        recommended_specialist="$specialist"
+        break
+    fi
+done
+
+# Generate output
+jq -n \
+    --arg remove_agent "${AGENTS[lowest_confidence_index]}" \
+    --arg add_agent "$recommended_specialist" \
+    --argjson agents "$(printf '%s\n' "${AGENTS[@]}" | jq -R . | jq -s '.')" \
+    --arg lowest_confidence "$lowest_confidence" \
+    --argjson themes "$(printf '%s\n' "${THEMES[@]}" | jq -R . | jq -s '.')" \
+    '{
+        "remove_agent": $remove_agent,
+        "remove_reason": "Lowest confidence (\($lowest_confidence)), contributing to plateau",
+        "add_agent": $add_agent,
+        "add_reason": "Match to feedback themes: \(join(", ", $themes))",
+        "new_loop3_agents": [$agents | map(select(. != $remove_agent)), $add_agent]
+    }'