claude-flow-novice 2.15.11 → 2.16.1

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

@@ -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/skills/cfn-agent-spawning/spawn-worker.sh

@@ -1,4 +1,26 @@
 #!/bin/bash
+
+##############################################################################
+# ⚠️  DEPRECATED - This bash script is deprecated
+#
+# Deprecation Date: 2025-11-20
+# Removal Date: 2026-02-20 (90 days)
+# Replacement: dist/cli/spawn-agent-cli.js
+#
+# This script will be removed in 90 days. Please migrate to TypeScript.
+#
+# Migration Guide: See docs/BASH_DEPRECATION_NOTICE.md
+# TypeScript Benefits:
+#   - Type safety (zero runtime type errors)
+#   - 90%+ test coverage
+#   - Better performance
+#   - Comprehensive documentation
+#
+# Automatic Migration:
+#   Set USE_TYPESCRIPT=true to use TypeScript implementation automatically
+#
+##############################################################################
+
 set -eu
 
 # Get the project root directory