claude-flow-novice 2.14.36 → 2.15.0

package/claude-assets/commands/switch-api.md

@@ -1,30 +1,47 @@
 ---
-description: Switch Main Chat and Task tool between Z.ai and Anthropic providers
+description: Switch Main Chat and Task tool between Z.ai, Kimi, OpenRouter, and Anthropic providers
 tags: [config, api, cost-optimization]
 ---
 
-Switch Main Chat and Task() tool API provider between Z.ai (cost-optimized) and Anthropic (high-quality).
+Switch Main Chat and Task() tool API provider between multiple AI providers.
 
-**Important:** CLI agents always use Z.ai (from `.env`). This command only affects Main Chat and Task() spawned agents.
+**Important:** CLI agents support custom routing when enabled. This command affects Main Chat and Task() spawned agents.
 
 **Usage:**
 - `/switch-api` - Show current status
-- `/switch-api zai` - Main Chat/Task tool use Z.ai ($0.50/1M tokens)
-- `/switch-api max` - Main Chat/Task tool use Anthropic ($15/1M tokens, requires re-login)
+- `/switch-api [zai|kimi|openrouter|max]` - Switch provider
+  - `zai` - Z.ai ($0.50/1M tokens)
+  - `kimi` - Moonshot Kimi ($2/1M tokens)
+  - `openrouter` - OpenRouter (varies by model)
+  - `max` or `claude` - Anthropic ($15/1M tokens, requires re-login)
 
 **Arguments:**
 - `status` - Show current routing configuration (default)
 - `zai` - Route Main Chat + Task tool to Z.ai for cost savings
+- `kimi` - Route Main Chat + Task tool to Moonshot Kimi
+- `openrouter` - Route Main Chat + Task tool to OpenRouter
 - `max` or `claude` - Route Main Chat + Task tool to Anthropic for quality
 
 **What This Does:**
 
 `/switch-api zai`:
-- Adds env vars to `.claude/settings.json`
+- Adds Z.ai env vars to `.claude/settings.json`
 - Main Chat + Task() agents use Z.ai
 - Cost: $0.50/1M tokens (97% savings)
 - No login required
 
+`/switch-api kimi`:
+- Adds Kimi env vars to `.claude/settings.json`
+- Main Chat + Task() agents use Moonshot Kimi
+- Cost: ~$2/1M tokens
+- Requires `KIMI_API_KEY` in root `.env`
+
+`/switch-api openrouter`:
+- Adds OpenRouter env vars to `.claude/settings.json`
+- Main Chat + Task() agents use OpenRouter
+- Cost: Varies by model
+- Requires `OPENROUTER_API_KEY` in root `.env`
+
 `/switch-api max`:
 - Removes env vars from `.claude/settings.json`
 - Main Chat + Task() agents use Anthropic
@@ -33,21 +50,25 @@ Switch Main Chat and Task() tool API provider between Z.ai (cost-optimized) and
 
 **Combined Architecture:**
 ```
-Main Chat (Anthropic or Z.ai - your choice)
+Main Chat (Anthropic/Z.ai/Kimi/OpenRouter - your choice)
   ↓
 Task() → Coordinator (uses Main Chat provider)
   ↓
-CLI spawn → Workers (always Z.ai from .env)
+CLI spawn → Workers (custom routing when enabled, see agent profiles)
 ```
 
 **Execute:**
 ```bash
-bash scripts/switch-api.sh {{args}}
+bash "$(git rev-parse --show-toplevel 2>/dev/null || pwd)/scripts/switch-api.sh" {{args}}
 ```
 
+**Note:** Script automatically resolves to project root directory.
+
 **Examples:**
 ```bash
-/switch-api          # Show current routing
-/switch-api zai      # Cost-optimize Main Chat
-/switch-api max      # Quality-optimize Main Chat (requires re-login)
+/switch-api             # Show current routing
+/switch-api zai         # Cost-optimize with Z.ai
+/switch-api kimi        # Use Moonshot Kimi
+/switch-api openrouter  # Use OpenRouter (access 400+ models)
+/switch-api max         # Quality-optimize with Anthropic (requires re-login)
 ```

package/claude-assets/skills/cfn-agent-spawning/get-agent-provider-env.sh

@@ -0,0 +1,107 @@
+#!/bin/bash
+
+# Get Agent Provider Environment Variables
+# Determines which provider environment variables to use for CLI/Docker agent spawning
+#
+# Logic:
+# 1. If custom routing is disabled, use Main Chat settings (from .claude/settings.json)
+# 2. If custom routing is enabled:
+#    a. Check agent profile for PROVIDER_PARAMETERS
+#    b. If found, use agent-specific provider/model
+#    c. If not found, use Main Chat settings
+#
+# Usage: source get-agent-provider-env.sh AGENT_TYPE
+# Exports: ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN, ANTHROPIC_MODEL, ANTHROPIC_SMALL_FAST_MODEL
+
+set -euo pipefail
+
+AGENT_TYPE="${1:-}"
+CUSTOM_ROUTING_ENABLED="${CFN_CUSTOM_ROUTING:-false}"
+SETTINGS_FILE=".claude/settings.json"
+
+if [[ -z "$AGENT_TYPE" ]]; then
+    echo "Usage: source $0 AGENT_TYPE" >&2
+    return 1 2>/dev/null || exit 1
+fi
+
+# Function to get provider config (zai, kimi, openrouter, anthropic)
+get_provider_config() {
+    local provider="$1"
+    local model="${2:-}"
+
+    case "$provider" in
+        zai)
+            export ANTHROPIC_BASE_URL="https://api.z.ai/api/anthropic"
+            export ANTHROPIC_AUTH_TOKEN="${ZAI_API_KEY:-}"
+            export ANTHROPIC_MODEL="${model:-glm-4.6}"
+            export ANTHROPIC_SMALL_FAST_MODEL="${model:-glm-4.6}"
+            ;;
+        kimi)
+            export ANTHROPIC_BASE_URL="https://api.moonshot.ai/anthropic"
+            export ANTHROPIC_AUTH_TOKEN="${KIMI_API_KEY:-}"
+            export ANTHROPIC_MODEL="${model:-kimi-k2-turbo-preview}"
+            export ANTHROPIC_SMALL_FAST_MODEL="${model:-kimi-k2-turbo-preview}"
+            ;;
+        openrouter)
+            export ANTHROPIC_BASE_URL="https://openrouter.ai/api/v1"
+            export ANTHROPIC_AUTH_TOKEN="${OPENROUTER_API_KEY:-}"
+            export ANTHROPIC_MODEL="${model:-anthropic/claude-sonnet-4.5}"
+            export ANTHROPIC_SMALL_FAST_MODEL="${model:-anthropic/claude-sonnet-4.5}"
+            ;;
+        anthropic|*)
+            # Use default Anthropic settings (remove custom env vars)
+            unset ANTHROPIC_BASE_URL
+            unset ANTHROPIC_AUTH_TOKEN
+            unset ANTHROPIC_MODEL
+            unset ANTHROPIC_SMALL_FAST_MODEL
+            ;;
+    esac
+}
+
+# Function to detect provider from base URL
+detect_provider_from_url() {
+    local base_url="$1"
+
+    if [[ "$base_url" == *"z.ai"* ]]; then
+        echo "zai"
+    elif [[ "$base_url" == *"moonshot.ai"* ]]; then
+        echo "kimi"
+    elif [[ "$base_url" == *"openrouter.ai"* ]]; then
+        echo "openrouter"
+    else
+        echo "anthropic"
+    fi
+}
+
+# Step 1: Check if custom routing is enabled
+if [[ "$CUSTOM_ROUTING_ENABLED" != "true" ]]; then
+    # Custom routing disabled - use Main Chat settings from .claude/settings.json
+    if [[ -f "$SETTINGS_FILE" ]]; then
+        BASE_URL=$(jq -r '.env.ANTHROPIC_BASE_URL // empty' "$SETTINGS_FILE" 2>/dev/null || echo "")
+
+        if [[ -n "$BASE_URL" ]]; then
+            # Main Chat has custom provider configured
+            export ANTHROPIC_BASE_URL="$BASE_URL"
+            export ANTHROPIC_AUTH_TOKEN=$(jq -r '.env.ANTHROPIC_AUTH_TOKEN // empty' "$SETTINGS_FILE" 2>/dev/null || echo "")
+            export ANTHROPIC_MODEL=$(jq -r '.env.ANTHROPIC_MODEL // empty' "$SETTINGS_FILE" 2>/dev/null || echo "")
+            export ANTHROPIC_SMALL_FAST_MODEL=$(jq -r '.env.ANTHROPIC_SMALL_FAST_MODEL // empty' "$SETTINGS_FILE" 2>/dev/null || echo "")
+        fi
+        # else: No custom provider, use default Anthropic
+    fi
+    return 0 2>/dev/null || exit 0
+fi
+
+# Step 2: Custom routing enabled - check agent profile for PROVIDER_PARAMETERS
+AGENT_PROVIDER=$(bash .claude/skills/cfn-agent-spawning/parse-agent-provider.sh "$AGENT_TYPE" --field provider)
+AGENT_MODEL=$(bash .claude/skills/cfn-agent-spawning/parse-agent-provider.sh "$AGENT_TYPE" --field model)
+
+if [[ -n "$AGENT_PROVIDER" ]]; then
+    # Agent has provider parameters - use them
+    get_provider_config "$AGENT_PROVIDER" "$AGENT_MODEL"
+else
+    # No agent-specific provider - default to Z.ai with glm-4.6
+    export ANTHROPIC_BASE_URL="https://api.z.ai/api/anthropic"
+    export ANTHROPIC_AUTH_TOKEN="${ZAI_API_KEY:-}"
+    export ANTHROPIC_MODEL="glm-4.6"
+    export ANTHROPIC_SMALL_FAST_MODEL="glm-4.6"
+fi

package/claude-assets/skills/cfn-agent-spawning/parse-agent-provider.sh

@@ -0,0 +1,59 @@
+#!/bin/bash
+
+# Parse Agent Provider Parameters
+# Extracts provider and model from agent profile's PROVIDER_PARAMETERS section
+# Usage: parse-agent-provider.sh AGENT_TYPE [--field provider|model]
+
+set -euo pipefail
+
+AGENT_TYPE="${1:-}"
+FIELD="${2:---field}"
+FIELD_VALUE="${3:-provider}"
+
+if [[ -z "$AGENT_TYPE" ]]; then
+    echo "Usage: $0 AGENT_TYPE [--field provider|model]" >&2
+    exit 1
+fi
+
+# Find agent file in multiple locations
+AGENT_FILE=""
+SEARCH_PATHS=(
+    ".claude/agents/cfn-dev-team/**/${AGENT_TYPE}.md"
+    ".claude/agents/custom/${AGENT_TYPE}.md"
+    ".claude/agents/${AGENT_TYPE}.md"
+)
+
+for pattern in "${SEARCH_PATHS[@]}"; do
+    # Use find with glob pattern
+    while IFS= read -r -d '' file; do
+        if [[ -f "$file" ]]; then
+            AGENT_FILE="$file"
+            break 2
+        fi
+    done < <(find .claude/agents -type f -name "${AGENT_TYPE}.md" -print0 2>/dev/null)
+done
+
+if [[ -z "$AGENT_FILE" ]]; then
+    # Agent file not found, return empty (will fallback to main chat settings)
+    echo ""
+    exit 0
+fi
+
+# Extract PROVIDER_PARAMETERS section
+# Format:
+# <!-- PROVIDER_PARAMETERS
+# provider: kimi
+# model: kimi-k2-turbo-preview
+# -->
+
+PARAM_VALUE=$(awk '
+    /<!-- PROVIDER_PARAMETERS/,/-->/ {
+        if ($0 ~ /^'"${FIELD_VALUE}"':/) {
+            sub(/^'"${FIELD_VALUE}"':[ \t]*/, "")
+            print $0
+            exit
+        }
+    }
+' "$AGENT_FILE" | tr -d '\r' | xargs)
+
+echo "$PARAM_VALUE"

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

@@ -208,8 +208,12 @@ if ! docker image inspect "$IMAGE" &> /dev/null; then
     exit 1
 fi
 
-# Get project root directory
-PROJECT_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../../../.." && pwd)"
+# Get project root directory (use git root for reliability)
+PROJECT_ROOT="$(git rev-parse --show-toplevel 2>/dev/null)"
+if [[ -z "$PROJECT_ROOT" ]]; then
+    # Fallback to script-relative path
+    PROJECT_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../../../.." && pwd -P)"
+fi
 cd "$PROJECT_ROOT"
 
 # Create workspace directory with proper permissions
@@ -328,16 +332,30 @@ DOCKER_CMD="$DOCKER_CMD --env AGENT_TYPE=${AGENT_TYPE}"
 DOCKER_CMD="$DOCKER_CMD --env TASK_ID=${TASK_ID}"
 DOCKER_CMD="$DOCKER_CMD --env PROJECT_ROOT=/app"
 
-# Add Redis URL if Redis is available
-if command -v redis-cli &> /dev/null && redis-cli ping &> /dev/null; then
-    DOCKER_CMD="$DOCKER_CMD --env REDIS_URL=redis://redis:6379"
-fi
+# Add Redis URL for container-to-container networking
+# Always set Redis URL regardless of host Redis status
+DOCKER_CMD="$DOCKER_CMD --env REDIS_URL=redis://redis:6379"
 
 # Add MCP tokens file path if tokens generated
 if [[ -n "$TOKENS_FILE" ]]; then
     DOCKER_CMD="$DOCKER_CMD --env MCP_TOKENS_FILE=/app/workspace/mcp-tokens.json"
 fi
 
+# Add provider routing environment variables (custom routing support)
+source .claude/skills/cfn-agent-spawning/get-agent-provider-env.sh "$AGENT_TYPE"
+if [[ -n "${ANTHROPIC_BASE_URL:-}" ]]; then
+    DOCKER_CMD="$DOCKER_CMD --env ANTHROPIC_BASE_URL=${ANTHROPIC_BASE_URL}"
+fi
+if [[ -n "${ANTHROPIC_AUTH_TOKEN:-}" ]]; then
+    DOCKER_CMD="$DOCKER_CMD --env ANTHROPIC_AUTH_TOKEN=${ANTHROPIC_AUTH_TOKEN}"
+fi
+if [[ -n "${ANTHROPIC_MODEL:-}" ]]; then
+    DOCKER_CMD="$DOCKER_CMD --env ANTHROPIC_MODEL=${ANTHROPIC_MODEL}"
+fi
+if [[ -n "${ANTHROPIC_SMALL_FAST_MODEL:-}" ]]; then
+    DOCKER_CMD="$DOCKER_CMD --env ANTHROPIC_SMALL_FAST_MODEL=${ANTHROPIC_SMALL_FAST_MODEL}"
+fi
+
 # Add custom environment variables
 if [[ -n "$ENVIRONMENT" ]]; then
     IFS=',' read -ra ENV_ARRAY <<< "$ENVIRONMENT"

package/claude-assets/skills/cfn-error-logging/SKILL.md

@@ -0,0 +1,339 @@
+# CFN Error Logging Skill
+
+## Metadata
+- **Skill ID:** cfn-error-logging
+- **Version:** 1.0.0
+- **Category:** Error Management & Debugging
+- **Dependencies:** redis-coordination, system-diagnostics
+- **Maturity:** Production
+- **Last Updated:** 2025-11-10
+
+## Purpose
+Comprehensive error logging and diagnostic capture for CFN Loop failures. Creates detailed error reports that users can send for debugging when CFN loops fail in CLI or Docker modes.
+
+## Responsibilities
+1. **Error Detection**: Monitor CFN Loop execution for failures and exceptions
+2. **Diagnostic Capture**: Collect system state, logs, and configuration data
+3. **Report Generation**: Create user-friendly error reports with actionable information
+4. **Log Management**: Store, organize, and clean up error logs
+5. **Integration**: Hook into CLI and Docker CFN Loop failure points
+
+## Interface
+
+### Main Entry Point
+```bash
+./.claude/skills/cfn-error-logging/invoke-error-logging.sh \
+  --action <capture|report|cleanup|list> \
+  --task-id <unique-id> \
+  [--error-type <orchestrator|agent-spawn|timeout|consensus|resource>] \
+  [--error-message <description>] \
+  [--exit-code <number>] \
+  [--context <json>]
+```
+
+### Parameters
+- `action`: Operation to perform (capture, report, cleanup, list)
+- `task-id`: Unique CFN Loop task identifier
+- `error-type`: Type of error that occurred
+- `error-message`: Human-readable error description
+- `exit-code`: Process exit code (if available)
+- `context`: Additional context data (JSON format)
+
+### Available Actions
+
+#### **capture** - Capture Error Data
+```bash
+# Automatic capture on CFN Loop failure
+./.claude/skills/cfn-error-logging/invoke-error-logging.sh \
+  --action capture \
+  --task-id "cfn-cli-1731234567" \
+  --error-type "orchestrator" \
+  --error-message "Agent spawning failed" \
+  --exit-code 1
+```
+
+#### **report** - Generate User Report
+```bash
+# Generate user-friendly error report
+./.claude/skills/cfn-error-logging/invoke-error-logging.sh \
+  --action report \
+  --task-id "cfn-cli-1731234567" \
+  --format "markdown"
+```
+
+#### **cleanup** - Manage Error Logs
+```bash
+# Clean old error logs (older than 7 days)
+./.claude/skills/cfn-error-logging/invoke-error-logging.sh \
+  --action cleanup \
+  --retention-days 7
+```
+
+#### **list** - List Error Logs
+```bash
+# List all error logs
+./.claude/skills/cfn-error-logging/invoke-error-logging.sh \
+  --action list \
+  --format "table"
+```
+
+## Data Captured
+
+### System Diagnostics
+- **Hardware**: CPU, memory, disk space usage
+- **Software**: OS version, Node.js version, npx version
+- **Dependencies**: Redis connectivity, Docker status
+- **Network**: Connection status, latency
+
+### CFN Loop State
+- **Configuration**: Task ID, mode, agent lists, thresholds
+- **Execution**: Current iteration, agent PIDs, timeouts
+- **Redis Data**: Task context, agent states, confidence scores
+- **Checkpoints**: Last successful iteration, saved state
+
+### Error Context
+- **Error Details**: Type, message, exit code, timestamp
+- **Stack Traces**: Process logs, error messages, debug output
+- **Environment**: Working directory, environment variables
+- **Process Tree**: Parent/child process relationships
+
+## Integration Points
+
+### CLI Loop Integration
+```bash
+# Add to orchestrate.sh error handling
+if [ $EXIT_CODE -ne 0 ]; then
+  ./.claude/skills/cfn-error-logging/invoke-error-logging.sh \
+    --action capture \
+    --task-id "$TASK_ID" \
+    --error-type "orchestrator" \
+    --error-message "CFN Loop failed at iteration $ITERATION" \
+    --exit-code $EXIT_CODE
+fi
+```
+
+### Docker Loop Integration
+```bash
+# Add to cfn-docker-loop-orchestration error handling
+if [ $CONTAINER_EXIT_CODE -ne 0 ]; then
+  ./.claude/skills/cfn-error-logging/invoke-error-logging.sh \
+    --action capture \
+    --task-id "$TASK_ID" \
+    --error-type "docker" \
+    --error-message "Container failed: $CONTAINER_NAME" \
+    --exit-code $CONTAINER_EXIT_CODE
+fi
+```
+
+### Agent Spawning Integration
+```bash
+# Add to agent spawning error handling
+if ! $SPAWN_COMMAND; then
+  ./.claude/skills/cfn-error-logging/invoke-error-logging.sh \
+    --action capture \
+    --task-id "$TASK_ID" \
+    --error-type "agent-spawn" \
+    --error-message "Failed to spawn agent: $AGENT_TYPE" \
+    --exit-code $?
+fi
+```
+
+## Error Report Format
+
+### Markdown Report (User-Friendly)
+```markdown
+# CFN Loop Error Report
+
+## 🚨 Error Summary
+- **Task ID**: cfn-cli-1731234567
+- **Error Type**: orchestrator
+- **Message**: Agent spawning failed
+- **Timestamp**: 2025-11-10 04:30:15 UTC
+- **Exit Code**: 1
+
+## 📋 Quick Diagnosis
+**Most Likely Cause**: npx not found or Redis connection failed
+**Recommended Action**: Check dependencies with pre-flight validation
+
+## 🔧 Troubleshooting Steps
+1. ✅ Check Node.js installation: `node --version`
+2. ✅ Check npx availability: `npx --version`
+3. ❌ Check Redis connection: `redis-cli ping`
+4. ✅ Check available memory: `free -h`
+
+## 📊 System State
+- **Memory Usage**: 65% (2.6GB/4GB)
+- **Disk Space**: 45GB available
+- **CPU Load**: 0.8
+- **Concurrent CFN Loops**: 3
+
+## 📝 Send This Report
+**To**: Your Claude assistant
+**Include**:
+- Complete error details above
+- Any recent changes to your setup
+- Steps you were trying to perform
+```
+
+## JSON Report (Machine-Readable)
+```json
+{
+  "task_id": "cfn-cli-1731234567",
+  "error_type": "orchestrator",
+  "error_message": "Agent spawning failed",
+  "timestamp": "2025-11-10T04:30:15Z",
+  "exit_code": 1,
+  "system_diagnostics": {...},
+  "cfn_state": {...},
+  "troubleshooting_steps": [...]
+}
+```
+
+## Storage and Management
+
+### Log Location
+- **Base Directory**: `/tmp/cfn_error_logs/`
+- **Individual Logs**: `/tmp/cfn_error_logs/cfn-error-<task-id>-<timestamp>.json`
+- **Reports**: `/tmp/cfn_error_logs/reports/cfn-report-<task-id>-<timestamp>.md`
+
+### Log Rotation
+- **Retention**: 7 days by default
+- **Cleanup**: Automatic cleanup on skill invocation
+- **Compression**: Compress logs older than 1 day
+- **Size Limit**: Maximum 100MB of error logs total
+
+### Privacy Considerations
+- **No Code**: Never captures source code content
+- **No Credentials**: Strips sensitive environment variables
+- **Local Storage**: All logs stored locally, user-controlled
+- **User Consent**: Error capture only on explicit failures
+
+## Usage Examples
+
+### Capture Error on CLI Loop Failure
+```bash
+# In cfn-loop-cli command
+if ! npx claude-flow-novice agent cfn-v3-coordinator ...; then
+  ./.claude/skills/cfn-error-logging/invoke-error-logging.sh \
+    --action capture \
+    --task-id "$TASK_ID" \
+    --error-type "cli-coordinator" \
+    --error-message "CLI coordinator failed to start"
+fi
+```
+
+### Generate Debug Report
+```bash
+# After CFN Loop failure
+./.claude/skills/cfn-error-logging/invoke-error-logging.sh \
+  --action report \
+  --task-id "cfn-cli-1731234567" \
+  --format markdown > /tmp/cfn_error_report.md
+
+echo "📋 Error report saved to: /tmp/cfn_error_report.md"
+echo "📤 Send this file to your Claude assistant for debugging help"
+```
+
+### List Recent Errors
+```bash
+# List all recent errors
+./.claude/skills/cfn-error-logging/invoke-error-logging.sh \
+  --action list \
+  --format table
+
+# List errors from last 24 hours
+./.claude/skills/cfn-error-logging/invoke-error-logging.sh \
+  --action list \
+  --since "24h" \
+  --format json
+```
+
+## Error Categories
+
+### Orchestrator Errors
+- Configuration validation failures
+- Parameter parsing errors
+- Mode threshold mismatches
+- Resource allocation failures
+
+### Agent Spawning Errors
+- npx command failures
+- Node.js environment issues
+- Agent binary not found
+- Container runtime errors
+
+### Coordination Errors
+- Redis connection failures
+- Key conflicts and race conditions
+- Timeout errors
+- Consensus calculation failures
+
+### Resource Errors
+- Memory exhaustion
+- Disk space shortage
+- Process limit exceeded
+- Network connectivity issues
+
+### System Errors
+- Permission denied
+- File system errors
+- Signal termination
+- Unexpected crashes
+
+## Troubleshooting Guide
+
+### Common Error Patterns
+1. **"npx not found"**: Install Node.js and npx globally
+2. **"Redis connection failed"**: Start Redis server or check configuration
+3. **"Memory exhaustion"**: Close other applications or increase system memory
+4. **"Permission denied"**: Check file permissions and user access
+
+### Diagnostic Commands
+```bash
+# System health check
+./.claude/skills/cfn-error-logging/invoke-error-logging.sh \
+  --action diagnostics
+
+# Dependency validation
+./.claude/skills/cfn-error-logging/invoke-error-logging.sh \
+  --action validate-dependencies
+
+# Resource monitoring
+./.claude/skills/cfn-error-logging/invoke-error-logging.sh \
+  --action monitor-resources
+```
+
+## Best Practices
+
+### For Users
+1. **Send Complete Reports**: Include the full error report when asking for help
+2. **Provide Context**: Describe what you were trying to accomplish
+3. **Check Dependencies**: Run pre-flight validation before complex tasks
+4. **Monitor Resources**: Watch memory and disk usage during long-running tasks
+
+### For Developers
+1. **Integration Points**: Add error logging to all CFN Loop failure points
+2. **Error Categories**: Use appropriate error types for better classification
+3. **Context Capture**: Include relevant state information for debugging
+4. **Privacy**: Never capture sensitive data or code content
+
+### For System Administrators
+1. **Log Management**: Regular cleanup of old error logs
+2. **Monitoring**: Track error frequency and patterns
+3. **Resource Planning**: Ensure adequate memory and disk space
+4. **Dependency Management**: Keep Node.js, Redis, and Docker updated
+
+## Troubleshooting
+
+### Skill Failures
+If the error logging skill itself fails:
+1. **Check Permissions**: Ensure write access to `/tmp/`
+2. **Disk Space**: Verify available space for log files
+3. **Dependencies**: Check for required system tools (jq, bc, etc.)
+4. **Fallback**: Use manual error reporting with basic system diagnostics
+
+### Common Issues
+- **Permission Denied**: Fix directory permissions
+- **Disk Full**: Clean up old error logs
+- **Missing Tools**: Install required dependencies
+- **Timezone Issues**: Use UTC timestamps consistently