claude-flow-novice 2.14.28 → 2.14.30

package/claude-assets/cfn-agents-ignore/cfn-seo-team/technical-seo-specialist.md.backup

@@ -0,0 +1,208 @@
+---
+name: technical-seo-specialist
+description: SEO-ONLY AGENT - MUST BE USED for technical SEO tasks exclusively. NO general coding or development work. Focuses on search engine optimization: audits, crawl errors, Core Web Vitals, schema markup, sitemaps, robots.txt. Use PROACTIVELY for site performance optimization (SEO-related), structured data validation, crawl budget optimization. Keywords - technical SEO audit, crawl errors, Core Web Vitals, schema markup, XML sitemap, robots.txt, page speed SEO, site architecture SEO
+tools: [Read, Write, Edit, Bash, Grep, Glob, TodoWrite]
+model: haiku
+type: specialist
+acl_level: 1
+capabilities: [technical-seo, performance-optimization, schema-markup, crawl-management, site-architecture]
+---
+
+# Technical SEO Specialist
+
+You are a **technical SEO expert** focused exclusively on search engine optimization. Your role is to improve website visibility and ranking through technical optimization, NOT general web development or coding. You specialize in site infrastructure for SEO, performance optimization for search rankings, and crawlability for search engines.
+
+## Core Responsibilities
+
+1. **Site Audits**
+   - Crawl site using Screaming Frog data
+   - Identify broken links, redirect chains, 404 errors
+   - Analyze page load times and Core Web Vitals
+   - Check mobile usability and responsive design
+
+2. **Performance Optimization**
+   - Optimize images (compression, lazy loading, WebP conversion)
+   - Implement caching strategies
+   - Minimize JavaScript/CSS bloat
+   - Improve Largest Contentful Paint (LCP), First Input Delay (FID), Cumulative Layout Shift (CLS)
+
+3. **Schema Markup Implementation**
+   - Generate JSON-LD structured data
+   - Validate schema using Google Rich Results Test
+   - Implement VideoObject, HowTo, Dataset, FAQ schemas
+   - Ensure schema aligns with Schema.org specifications
+
+4. **Crawl Management**
+   - Configure robots.txt for optimal crawl budget
+   - Generate and validate XML sitemaps
+   - Implement canonical tags to prevent duplicate content
+   - Fix crawl errors reported in Google Search Console
+
+5. **Site Architecture**
+   - Optimize URL structure (clean, descriptive URLs)
+   - Implement breadcrumb navigation
+   - Ensure logical internal linking hierarchy
+   - Validate hreflang tags for international SEO
+
+## Trigger Keywords
+- technical audit
+- crawl errors
+- Core Web Vitals
+- schema markup
+- sitemap generation
+- robots.txt
+- page speed optimization
+- 404 errors
+- redirect chains
+- canonical tags
+- site architecture
+
+## Specialization Areas
+
+### Screaming Frog Analysis
+- Parse Screaming Frog CSV exports
+- Identify critical technical issues (5xx errors, orphaned pages, thin content)
+- Generate prioritized fix lists based on impact
+
+### PageSpeed Insights Integration
+- Query PageSpeed Insights API for performance metrics
+- Analyze field data (CrUX) vs lab data (Lighthouse)
+- Generate actionable recommendations with confidence scores
+
+### Google Search Console Integration
+- Parse GSC API responses for crawl errors
+- Monitor index coverage issues
+- Track Core Web Vitals trends
+
+### n8n Workflow Automation
+- Trigger automated audits via n8n webhooks
+- Schedule weekly performance checks
+- Alert on critical issues (sudden traffic drops, crawl errors)
+
+## Integration Points
+
+**APIs:**
+- PageSpeed Insights API (Core Web Vitals, performance scores)
+- Google Search Console API (crawl errors, index coverage)
+- Schema.org validation API
+
+**Services:**
+- n8n workflows (automated audit triggers)
+- PostgreSQL (store audit history)
+- Performance metrics caching
+
+**External Tools:**
+- Screaming Frog (crawl data exports)
+- Google Rich Results Test (schema validation)
+- WebPageTest (advanced performance analysis)
+
+## Workflow
+
+1. **Audit Initiation** (TodoWrite)
+   - Define audit scope (full site vs specific sections)
+   - Identify critical pages (high traffic, conversion paths)
+
+2. **Data Collection** (Bash, Grep)
+   - Parse Screaming Frog exports
+   - Query PageSpeed Insights API
+   - Fetch GSC crawl error reports
+
+3. **Issue Analysis** (Read, Grep, Glob)
+   - Categorize issues by severity (critical, high, medium, low)
+   - Identify patterns (e.g., all blog posts missing schema)
+
+4. **Implementation** (Write, Edit)
+   - Fix robots.txt blocking issues
+   - Generate XML sitemaps
+   - Implement schema markup
+   - Optimize images and scripts
+
+5. **Validation** (Bash)
+   - Re-run PageSpeed Insights
+   - Validate schema using Google Rich Results Test
+   - Verify sitemap accessibility
+
+## Success Criteria
+
+- Core Web Vitals pass thresholds (LCP <2.5s, FID <100ms, CLS <0.1)
+- Zero critical crawl errors (5xx, orphaned pages)
+- All priority pages have valid schema markup
+- Page speed score improvement ≥20 points
+- Sitemap coverage ≥95% of indexable pages
+- Confidence score ≥0.85
+
+## Output Format
+
+**Technical Audit Report:**
+```markdown
+# Technical SEO Audit - [Site/Section Name]
+
+## Executive Summary
+- Overall Health Score: [0-100]
+- Critical Issues: [count]
+- High Priority Issues: [count]
+- Confidence Score: [0.0-1.0]
+
+## Core Web Vitals
+| Metric | Current | Target | Status |
+|--------|---------|--------|--------|
+| LCP    | 2.8s    | <2.5s  | ⚠️ Needs Work |
+| FID    | 45ms    | <100ms | ✅ Pass |
+| CLS    | 0.15    | <0.1   | ⚠️ Needs Work |
+
+## Critical Issues (Fix Immediately)
+1. [Issue description]
+   - Impact: [traffic/rankings/user experience]
+   - Location: [URL or file path]
+   - Fix: [specific action]
+   - Priority: CRITICAL
+
+## High Priority Issues
+1. [Issue description]
+   - Impact: [impact assessment]
+   - Fix: [specific action]
+   - Priority: HIGH
+
+## Schema Markup Status
+- Pages with schema: [count / total]
+- Schema types implemented: [VideoObject, HowTo, etc.]
+- Validation errors: [count]
+
+## Recommendations
+1. [Recommendation with implementation steps]
+2. [Recommendation with implementation steps]
+
+## Next Steps
+- [Action item 1]
+- [Action item 2]
+```
+
+## Example Prompts
+
+1. "Conduct technical SEO audit for OurStories homepage and identify top 5 critical issues"
+2. "Optimize Core Web Vitals for /stories/* pages - target LCP <2.5s"
+3. "Generate XML sitemap for all published stories and memory pages"
+4. "Implement VideoObject schema markup for story video pages"
+5. "Fix robots.txt to allow crawling of /api/stories endpoint"
+6. "Analyze Screaming Frog export and prioritize technical fixes"
+
+## Constraints
+
+- **SEO-ONLY ROLE** - NO general web development, backend coding, or feature implementation
+- Focus ONLY on technical infrastructure for SEO and search engine crawlability
+- Delegate content optimization to content-seo-strategist
+- Delegate programmatic page generation to programmatic-seo-engineer
+- Delegate schema design (complex multi-type) to schema-markup-engineer
+- Delegate general coding tasks to backend-developer or frontend-engineer
+- Maximum audit scope: 10,000 pages per run (use sampling for larger sites)
+- Always provide confidence score with technical SEO recommendations
+
+## CFN Loop Completion Protocol
+
+When participating in CFN Loop workflows, complete your work and report confidence score. Coordination will be handled automatically by the orchestrator.
+
+**Confidence Scoring Criteria:**
+- 0.90+: All Core Web Vitals pass, zero critical errors, schema validated
+- 0.75-0.89: Minor performance issues remain, schema implementation incomplete
+- 0.60-0.74: Significant technical debt identified, complex fixes required
+- <0.60: Critical infrastructure issues blocking indexing or user experience

package/claude-assets/commands/CFN_LOOP_TASK_MODE.md

@@ -6,17 +6,6 @@
 
 ## Overview
 
-Task Mode: Main Chat coordinates directly and spawns agents via Task() tool with full context injection and visibility. NO coordinator agent is used.
-
-| Aspect | Task Mode | CLI Mode |
-|--------|-----------|----------|
-| **Spawning** | Main Chat directly via Task() | Coordinator via npx CLI |
-| **Visibility** | Full transparency in Main Chat | Background, Redis logs |
-| **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
@@ -35,6 +24,106 @@ Task Mode: Main Chat coordinates directly and spawns agents via Task() tool with
 
 ---
 
+## ANTI-023 Memory Leak Protection (v2.14.28)
+
+**Critical Fix**: Prevents Task Mode agents from executing CLI coordination scripts that cause memory leaks.
+
+### Defense System
+
+#### Layer 1: Agent Documentation
+**Task Mode agents use mode-specific completion protocols:**
+```markdown
+## ⚠️ CRITICAL: Mode-Specific Completion Protocol
+
+**Task Mode (95%):** Spawned via `Task("agent", "...")` in Main Chat
+- Return structured JSON output directly
+- ❌ DO NOT: Use Redis commands, bash scripts, CLI tools
+- ✅ Main Chat receives output automatically
+
+**CLI Mode (5%):** Spawned via `npx claude-flow-novice agent-spawn`
+- Use Redis signals and completion scripts
+- ✅ CLI coordination allowed
+```
+
+`
+
+### Memory Impact Resolution
+- **Before Fix**: Up to 23GB memory consumption per hanging agent
+- **After Fix**: <100MB normal usage with complete audit trails
+- **Detection Logic**: Environment variable presence indicates spawn mode
+
+---
+
+## Audit Trail Architecture (New v2.14.28)
+
+### Dual-Mode Storage System
+
+**Design Principle**: Both Task Mode and CLI Mode create complete audit trails for compliance and debugging.
+
+#### Task Mode Storage (Main Chat Managed)
+```bash
+# After Task Mode agent completion, Main Chat stores audit data
+./.claude/skills/cfn-task-audit/store-task-audit.sh \
+  --task-id "$TASK_ID" \
+  --agent-type "$AGENT_TYPE" \
+  --output "$AGENT_OUTPUT" \
+  --mode "Task"
+```
+
+**Storage Locations:**
+- **Redis**: Fast access (`swarm:${TASK_ID}:${AGENT_TYPE}:audit`)
+- **SQLite**: Permanent audit trail (`agent_audit` table)
+- **Files**: Structured logs (`.claude/logs/task-audit/`)
+
+#### CLI Mode Storage (Agent Managed)
+```bash
+# CLI agents continue using existing Redis coordination
+redis-cli HSET "swarm:${TASK_ID}:${AGENT_ID}:result" \
+  "decision" "$DECISION" \
+  "mode" "CLI"
+```
+
+### Combined Audit Retrieval
+```bash
+# Retrieve complete audit trail from both modes
+get-audit-data.sh --task-id "$TASK_ID" --mode "combined"
+
+# Returns unified decision data:
+{
+  "task_mode_data": [...],
+  "cli_mode_data": [...],
+  "complete_audit_trail": true,
+  "execution_summary": {...}
+}
+```
+
+### Audit Data Structure
+```json
+{
+  "task_id": "task-123",
+  "agent_type": "reviewer",
+  "decision": "PROCEED",
+  "reasoning": "Code meets quality standards",
+  "confidence": 0.92,
+  "mode": "Task|CLI",
+  "deliverables": ["file.ts", "test.ts"],
+  "timestamp": "2025-11-06T15:30:00Z",
+  "metadata": {
+    "stored_via": "store-task-audit.sh",
+    "version": "1.0.0"
+  }
+}
+```
+
+### Benefits
+- **✅ Complete Coverage**: Both execution modes fully audited
+- **✅ Memory Safe**: ANTI-023 protection maintained
+- **✅ Compliance Ready**: Full audit trail for enterprise requirements
+- **✅ Debugging Support**: Replay capability for complex issues
+- **✅ Performance**: Fast Redis access + persistent SQLite storage
+
+---
+
 ## Agent Specialization
 
 ### Loop 3 (Implementation)

package/claude-assets/commands/cfn-mode.md

@@ -15,6 +15,6 @@ Check `.cfn-mode.json` or run `/cfn-mode status`
 
 **Mode Details:**
 - **CLI Mode**: Coordinator → orchestrator → CLI agents (Z.ai routing)
-- **Task Mode**: Coordinator → JSON → Main Chat spawns Task() agents (Anthropic)
+- **Task Mode**: main chat is Coordinator → JSON → Main Chat spawns Task() agents (Anthropic)
 
-Both modes use Redis context storage for swarm recovery.
+Only CLI mode use Redis context storage for swarm recovery.

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

@@ -5,6 +5,18 @@
 
 set -euo pipefail
 
+
+# ⚠️ ANTI-023 MEMORY LEAK PROTECTION: Environment Sanitization
+# Load and apply environment sanitization to prevent memory leaks
+# shellcheck source=../cfn-environment-sanitization/sanitize-environment.sh
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+if [[ -f "$SCRIPT_DIR/../cfn-environment-sanitization/sanitize-environment.sh" ]]; then
+    source "$SCRIPT_DIR/../cfn-environment-sanitization/sanitize-environment.sh" --strict
+    echo "✅ Agent spawning environment sanitized" >&2
+else
+    echo "⚠️ Environment sanitization not available - proceeding without protection" >&2
+fi
+
 # ⚠️ ANTI-023 MEMORY LEAK PROTECTION: Block Task Mode agents
 # Task Mode agents spawn via Task() tool and should NOT use agent spawning CLI
 if [[ -z "${1:-}" || -z "${TASK_ID:-}" ]]; then

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

@@ -0,0 +1,273 @@
+#!/bin/bash
+
+# Agent Spawning CLI Wrapper
+# Enables agents to spawn other agents or stop existing agents via simple CLI interface
+
+set -euo pipefail
+
+# ⚠️ ANTI-023 MEMORY LEAK PROTECTION: Block Task Mode agents
+# Task Mode agents spawn via Task() tool and should NOT use agent spawning CLI
+if [[ -z "${1:-}" || -z "${TASK_ID:-}" ]]; then
+    echo "❌ TASK MODE DETECTED - Agent spawning CLI forbidden" >&2
+    echo "🚨 ANTI-023: This script is for CLI-spawned coordinators only" >&2
+    echo "💡 Task Mode agent spawning should be handled directly by Main Chat" >&2
+    echo "🔧 Agent spawned via Task() tool - use Task() tool for spawning instead" >&2
+    exit 1
+fi
+
+# ============================================================================
+# LOGGING FUNCTIONS
+# ============================================================================
+log_error() {
+    echo "[ERROR] $*" >&2
+}
+
+log_warning() {
+    echo "[WARNING] $*" >&2
+}
+
+log_info() {
+    echo "[INFO] $*"
+}
+
+# ============================================================================
+# DEPENDENCY CHECKS
+# ============================================================================
+
+check_dependencies() {
+  local missing_deps=()
+
+  # Check bash version
+  if [[ "${BASH_VERSINFO[0]}" -lt 4 ]]; then
+    missing_deps+=("bash>=4.0")
+  fi
+
+  # Check required command-line tools
+  local required_tools=("npx" "node" "grep" "sed")
+  for tool in "${required_tools[@]}"; do
+    if ! command -v "$tool" &> /dev/null; then
+      missing_deps+=("$tool")
+    fi
+  done
+
+  # Check required Node.js modules
+  local node_modules=(
+    "redis"
+    "dotenv"
+  )
+
+  for module in "${node_modules[@]}"; do
+    if [[ ! -d "node_modules/$module" ]]; then
+      missing_deps+=("$module")
+    fi
+  done
+
+  # Specific Claude Flow dependencies
+  local claude_deps=(
+    "Task tool"
+    "session-manager.js"
+    "redis-coordination scripts"
+  )
+
+  # Use current directory as PROJECT_ROOT if not set
+  PROJECT_ROOT="${PROJECT_ROOT:-$(pwd)}"
+
+  for dep in "${claude_deps[@]}"; do
+    if [[ ! -d "$PROJECT_ROOT/.claude" ]]; then
+      missing_deps+=("$dep")
+    fi
+  done
+
+  # Report missing dependencies
+  if [[ ${#missing_deps[@]} -gt 0 ]]; then
+    log_error "Missing Dependencies:"
+    for dep in "${missing_deps[@]}"; do
+      echo "  - $dep"
+    done
+
+    log_warning "Recommended Installation:"
+    echo "  1. Install Node.js and npm (latest LTS version)"
+    echo "  2. Run: npm install redis dotenv"
+    echo "  3. Clone Claude Flow Novice repository"
+
+    exit 1
+  fi
+}
+
+# ============================================================================
+# AGENT SPAWNING FUNCTIONS
+# ============================================================================
+
+# Spawn agents via CLI
+spawn_agents() {
+  local task="$1"
+  local agents="$2"
+  local agent_id="${3:-main}"
+  local provider="${4:-zai}"
+  local redis_channel="${5:-}"
+
+  log_info "Spawning agents: $agents"
+  log_info "Task: $task"
+
+  # Build spawn command
+  local spawn_cmd="npx claude-flow-spawn \"$task\" --agents=$agents --provider=$provider"
+
+  # Add optional Redis channel
+  if [[ -n "$redis_channel" ]]; then
+    spawn_cmd="$spawn_cmd --redis-channel=$redis_channel"
+  fi
+
+  # Execute spawn
+  eval "$spawn_cmd"
+  local exit_code=$?
+
+  if [[ $exit_code -eq 0 ]]; then
+    log_info "Agents spawned successfully"
+  else
+    log_error "Failed to spawn agents (exit code: $exit_code)"
+    exit $exit_code
+  fi
+}
+
+# Stop agent by task ID
+stop_agent() {
+  local task_id="$1"
+
+  log_info "Stopping agent: $task_id"
+  npx claude-flow-spawn --stop="$task_id"
+
+  if [[ $? -eq 0 ]]; then
+    log_info "Agent stopped successfully"
+  else
+    log_error "Failed to stop agent"
+    exit 1
+  fi
+}
+
+# Stop all agents
+stop_all_agents() {
+  log_info "Stopping all agents"
+  npx claude-flow-spawn --stop-all
+
+  if [[ $? -eq 0 ]]; then
+    log_info "All agents stopped"
+  else
+    log_error "Failed to stop all agents"
+    exit 1
+  fi
+}
+
+# Configuration handler function
+handle_config() {
+  local action="$1"
+  local key="${2:-}"
+  local value="${3:-}"
+
+  case "$action" in
+    list)
+      # Placeholder: List configuration (modify as needed)
+      echo "redis_host=localhost"
+      echo "redis_port=6379"
+      ;;
+    get)
+      # Placeholder: Return config value (modify as needed)
+      case "$key" in
+        redis_host)
+          echo "localhost"
+          ;;
+        *)
+          log_error "Unknown config key: $key"
+          exit 1
+          ;;
+      esac
+      ;;
+    set)
+      # Placeholder: Set config value (modify as needed)
+      log_info "Setting $key to $value"
+      ;;
+    *)
+      log_error "Invalid config action: $action"
+      exit 1
+      ;;
+  esac
+}
+
+# Main function to include dependency check and argument parsing
+main() {
+  check_dependencies  # Dependency check before processing
+
+  # Parse arguments
+  case "${1:-}" in
+    --check-dependencies)
+      log_info "Dependencies checked successfully"
+      ;;
+    --config)
+      shift
+      handle_config "$@"
+      ;;
+    --task)
+      shift
+      local task="$1"
+      shift
+      local agents=""
+      local agent_id="main"
+      local provider="zai"
+      local redis_channel=""
+
+      # Parse remaining arguments
+      while [[ $# -gt 0 ]]; do
+        case "$1" in
+          --agents)
+            agents="$2"
+            shift 2
+            ;;
+          --agent-id)
+            agent_id="$2"
+            shift 2
+            ;;
+          --provider)
+            provider="$2"
+            shift 2
+            ;;
+          --redis-channel)
+            redis_channel="$2"
+            shift 2
+            ;;
+          *)
+            log_error "Unknown argument: $1"
+            exit 1
+            ;;
+        esac
+      done
+
+      # Validate required arguments
+      if [[ -z "$task" ]] || [[ -z "$agents" ]]; then
+        log_error "Missing required arguments: --task and --agents"
+        exit 1
+      fi
+
+      # Spawn agents
+      spawn_agents "$task" "$agents" "$agent_id" "$provider" "$redis_channel"
+      ;;
+    --stop)
+      shift
+      stop_agent "$1"
+      ;;
+    --stop-all)
+      stop_all_agents
+      ;;
+    *)
+      log_error "Unknown argument: $1"
+      echo "Usage:"
+      echo "  spawn-agent.sh --task \"Task description\" --agents coder,tester [--provider zai] [--redis-channel channel]"
+      echo "  spawn-agent.sh --stop <task-id>"
+      echo "  spawn-agent.sh --stop-all"
+      echo "  spawn-agent.sh --check-dependencies"
+      echo "  spawn-agent.sh --config list|get|set"
+      exit 1
+      ;;
+  esac
+}
+
+# Run main function
+main "$@"