claude-flow-novice 2.15.0 → 2.15.1

package/claude-assets/commands/cfn-docker/CFN_DOCKER_NATIVE.md

@@ -0,0 +1,295 @@
+---
+description: "Execute CFN Loop with fully containerized coordinator using Docker-in-Docker (native container mode)"
+argument-hint: "[task-description] --mode=mvp|standard|enterprise"
+allowed-tools: ["Bash", "Read"]
+---
+
+# CFN Docker Loop - Native Container Mode
+
+Execute CFN Loop with coordinator running as a Docker container (Docker-in-Docker).
+
+**Task Description:** $ARGUMENTS
+
+## Overview
+
+This command runs the CFN Docker v3 coordinator in a container instead of via Task() tool.
+
+**Benefits:**
+- ✅ Consistent execution model (coordinator + workers all containerized)
+- ✅ Resource isolation for coordinator
+- ✅ Can use cheaper models via custom routing
+- ✅ Portable across environments (CI/CD friendly)
+- ✅ Planning phase fully integrated
+
+**Architecture:**
+```
+Main Chat (docker run)
+    ↓
+cfn-coordinator:v3 (Docker container)
+    ↓ orchestrate.sh
+    ↓ spawn-agent.sh
+Worker Agents (Docker containers)
+```
+
+## Execution Steps
+
+### Step 1: Parse Arguments and Set Defaults
+
+```bash
+# Extract task description
+TASK_DESCRIPTION="$ARGUMENTS"
+
+# Generate unique task ID
+TASK_ID="task-$(date +%s)-$$"
+
+# Parse mode from arguments (default: standard)
+if [[ "$ARGUMENTS" =~ --mode=([a-z]+) ]]; then
+    MODE="${BASH_REMATCH[1]}"
+else
+    MODE="standard"
+fi
+
+echo "🚀 CFN Docker Loop - Native Container Mode"
+echo "   Task ID: ${TASK_ID}"
+echo "   Mode: ${MODE}"
+echo "   Description: ${TASK_DESCRIPTION}"
+```
+
+### Step 2: Ensure Redis is Running
+
+```bash
+# Check if Redis container exists
+if ! docker ps | grep -q cfn-redis; then
+    echo "📦 Starting Redis service..."
+    docker-compose up -d redis
+    sleep 3
+
+    # Verify Redis is responding
+    if ! docker exec cfn-redis redis-cli ping > /dev/null 2>&1; then
+        echo "❌ Redis failed to start"
+        exit 1
+    fi
+
+    echo "✅ Redis started successfully"
+else
+    echo "✅ Redis already running"
+fi
+```
+
+### Step 3: Build Coordinator Image (if needed)
+
+```bash
+# Check if coordinator image exists
+if ! docker images | grep -q "cfn-coordinator.*v3"; then
+    echo "🔨 Building CFN coordinator image..."
+    docker build -f Dockerfile.cfn-coordinator -t cfn-coordinator:v3 .
+
+    if [[ $? -ne 0 ]]; then
+        echo "❌ Failed to build coordinator image"
+        exit 1
+    fi
+
+    echo "✅ Coordinator image built"
+else
+    echo "✅ Coordinator image exists"
+fi
+```
+
+### Step 4: Spawn Coordinator Container
+
+```bash
+echo "🐳 Spawning coordinator container..."
+
+docker run --rm \
+  --name "cfn-coordinator-${TASK_ID}" \
+  --network mcp-network \
+  --volume /var/run/docker.sock:/var/run/docker.sock \
+  --volume "$(pwd):/app/codebase:ro" \
+  --volume /tmp:/tmp \
+  --env ANTHROPIC_API_KEY="${ANTHROPIC_API_KEY}" \
+  --env CFN_REDIS_HOST=cfn-redis \
+  --env CFN_REDIS_PORT=6379 \
+  --env TASK_ID="${TASK_ID}" \
+  --env MODE="${MODE}" \
+  --env TASK_DESCRIPTION="${TASK_DESCRIPTION}" \
+  --env MEMORY_LIMIT="${MEMORY_LIMIT:-1g}" \
+  --env MAX_ITERATIONS="${MAX_ITERATIONS:-10}" \
+  --env GATE_THRESHOLD="${GATE_THRESHOLD:-0.75}" \
+  --env CONSENSUS_THRESHOLD="${CONSENSUS_THRESHOLD:-0.90}" \
+  --env NETWORK="mcp-network" \
+  --env CFN_CUSTOM_ROUTING="${CFN_CUSTOM_ROUTING:-false}" \
+  --env ZAI_API_KEY="${ZAI_API_KEY:-}" \
+  cfn-coordinator:v3
+
+COORDINATOR_EXIT_CODE=$?
+```
+
+### Step 5: Report Results
+
+```bash
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+if [[ $COORDINATOR_EXIT_CODE -eq 0 ]]; then
+    echo "✅ CFN Loop execution completed successfully"
+    echo "   Task ID: ${TASK_ID}"
+    echo "   Mode: ${MODE}"
+
+    # Check for planning artifacts
+    if [[ -f "/tmp/cfn-docker-plan-${TASK_ID}.json" ]]; then
+        ATOMIC_TASKS=$(jq -r '.atomic_tasks | length' "/tmp/cfn-docker-plan-${TASK_ID}.json" 2>/dev/null || echo "unknown")
+        echo "   Atomic Tasks: ${ATOMIC_TASKS}"
+    fi
+
+    # Check Redis for task state
+    echo ""
+    echo "📊 Task state stored in Redis:"
+    echo "   redis-cli HGETALL cfn_docker:task:${TASK_ID}"
+
+else
+    echo "❌ CFN Loop execution failed"
+    echo "   Exit code: ${COORDINATOR_EXIT_CODE}"
+    echo "   Task ID: ${TASK_ID}"
+    echo ""
+    echo "🔍 Debug steps:"
+    echo "   1. Check Redis: redis-cli HGETALL cfn_docker:task:${TASK_ID}"
+    echo "   2. Check planning file: cat /tmp/cfn-docker-plan-${TASK_ID}.json"
+    echo "   3. Check logs: docker logs cfn-coordinator-${TASK_ID} (if still running)"
+fi
+
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+```
+
+## Environment Variables
+
+### Required
+```bash
+ANTHROPIC_API_KEY     # API key for LLM calls (coordinator planning)
+```
+
+### Optional Configuration
+```bash
+MODE=standard         # mvp|standard|enterprise
+MEMORY_LIMIT=1g      # Worker agent memory limit
+MAX_ITERATIONS=10    # Maximum CFN Loop iterations
+GATE_THRESHOLD=0.75  # Loop 3 self-validation threshold
+CONSENSUS_THRESHOLD=0.90  # Loop 2 validator consensus threshold
+```
+
+### Optional Custom Routing
+```bash
+CFN_CUSTOM_ROUTING=true    # Enable Z.ai routing
+ZAI_API_KEY=xxx           # Z.ai API key
+ZAI_MODEL=glm-4.6         # Model for workers
+```
+
+## Examples
+
+### Basic Usage
+```bash
+/cfn-docker-native "Implement user authentication system"
+```
+
+### With Mode Selection
+```bash
+/cfn-docker-native "Build responsive dashboard UI" --mode=enterprise
+```
+
+### With Custom Routing (Cost Optimization)
+```bash
+export CFN_CUSTOM_ROUTING=true
+export ZAI_API_KEY="your-zai-key"
+/cfn-docker-native "Optimize database queries"
+```
+
+### For CI/CD
+```bash
+# In CI pipeline
+export ANTHROPIC_API_KEY="${SECRETS_ANTHROPIC_KEY}"
+/cfn-docker-native "Deploy to staging environment" --mode=standard
+```
+
+## Comparison: Native vs Task Mode
+
+| Aspect | Task Mode | Native Mode |
+|--------|-----------|-------------|
+| **Coordinator** | Task() tool (Main Chat context) | Docker container |
+| **Visibility** | Full (logs in Main Chat) | Reduced (docker logs) |
+| **Resource Isolation** | None | Full (memory limits) |
+| **Cost Optimization** | Standard | Can use cheaper models |
+| **CI/CD Friendly** | No | Yes |
+| **Debugging** | Easy | Moderate |
+| **Portability** | Requires Claude Code | Any Docker environment |
+| **Planning Phase** | ✅ Works | ✅ Works (via /tmp mount) |
+
+## Troubleshooting
+
+### Coordinator Container Won't Start
+```bash
+# Check if image exists
+docker images | grep cfn-coordinator
+
+# Rebuild if needed
+docker build -f Dockerfile.cfn-coordinator -t cfn-coordinator:v3 .
+
+# Check Docker socket permissions
+ls -la /var/run/docker.sock
+```
+
+### Planning File Not Generated
+```bash
+# Check planning file
+ls -la /tmp/cfn-docker-plan-*.json
+
+# Check coordinator logs
+docker logs cfn-coordinator-${TASK_ID}
+
+# Verify coordinator can write to /tmp
+docker run --rm -v /tmp:/tmp cfn-coordinator:v3 /bin/sh -c "touch /tmp/test && rm /tmp/test"
+```
+
+### Workers Not Spawning
+```bash
+# Check if coordinator can access Docker
+docker run --rm -v /var/run/docker.sock:/var/run/docker.sock cfn-coordinator:v3 /bin/sh -c "docker ps"
+
+# Check network exists
+docker network ls | grep mcp-network
+
+# Create network if needed
+docker network create mcp-network
+```
+
+### Redis Connection Issues
+```bash
+# Check Redis status
+docker ps | grep cfn-redis
+
+# Test connection from coordinator network
+docker run --rm --network mcp-network redis:7-alpine redis-cli -h cfn-redis ping
+```
+
+## Notes
+
+- **Docker-in-Docker:** Coordinator mounts `/var/run/docker.sock` to spawn workers
+- **Codebase Access:** Mounted read-only at `/app/codebase` for orchestrate.sh
+- **Planning Files:** Shared via `/tmp` volume mount
+- **Network:** All containers (coordinator + workers + Redis) use `mcp-network`
+- **Auto-cleanup:** Coordinator container removes itself on exit (--rm flag)
+
+## When to Use This Command
+
+**Use Native Mode When:**
+- Running in CI/CD pipelines
+- Want full resource isolation
+- Testing Docker-in-Docker setup
+- Cost optimization with custom routing
+- Need portable execution environment
+
+**Use Task Mode When:**
+- Developing/debugging coordinator logic
+- Want full visibility into execution
+- Need immediate log access
+- Rapid iteration on planning phase
+
+Both modes use the same planning phase implementation and produce identical results.

package/claude-assets/commands/cfn-docker-core-test-suite.md

@@ -0,0 +1,326 @@
+---
+name: cfn-docker-core-test-suite
+description: Run comprehensive Docker CFN Loop core test suite validating coordinator v3, infrastructure, and Redis coordination
+category: testing
+---
+
+# Docker CFN Loop Core Test Suite
+
+Run comprehensive regression tests for Docker-based CFN Loop v3 architecture, validating coordinator workflows, Docker infrastructure, and Redis coordination patterns.
+
+**Purpose:** Ensure code changes don't break the Docker CFN Loop process or underlying infrastructure.
+
+## Usage
+
+```bash
+# Run all core tests (full regression suite)
+/cfn-docker-core-test-suite
+
+# Run specific test category
+/cfn-docker-core-test-suite --category coordinator
+/cfn-docker-core-test-suite --category infrastructure
+/cfn-docker-core-test-suite --category redis
+/cfn-docker-core-test-suite --category cfn-loop
+/cfn-docker-core-test-suite --category integration
+
+# Run specific test file
+/cfn-docker-core-test-suite --test coordinator-planning-tests.sh
+/cfn-docker-core-test-suite --test redis-coordination-tests.sh
+
+# With verbose output
+/cfn-docker-core-test-suite --verbose
+
+# Quick validation (skip long-running tests)
+/cfn-docker-core-test-suite --quick
+```
+
+## Test Categories
+
+### Coordinator V3 Features (6 tests, ~45 min)
+1. **coordinator-planning-tests.sh** - Dynamic task planning via Anthropic API
+2. **coordinator-docker-in-docker-tests.sh** - Worker container spawning
+3. **coordinator-atomic-task-tests.sh** - One task per agent assignment
+4. **coordinator-validation-tests.sh** - Plan validation and error handling
+5. **coordinator-iteration-tests.sh** - Multi-iteration management
+6. **coordinator-fault-tolerance-tests.sh** - Coordinator resilience
+
+### Docker Infrastructure (2 tests, ~15 min)
+7. **docker-hello-world-parity-tests.sh** - Basic Docker agent execution
+8. **agent-lifecycle-tests.sh** - Agent spawn-to-exit cycle
+
+### Redis Coordination (1 test, ~10 min)
+9. **redis-coordination-tests.sh** - Node.js client connectivity, heartbeat, pub/sub
+
+### Resource Management (1 test, ~10 min)
+10. **memory-budget-tests.sh** - Wave spawning, memory limits, tier allocation
+
+### CFN Loop Patterns (1 test, ~10 min)
+11. **cfn-loop-compliance-tests.sh** - Gate/consensus/decision patterns
+
+### Environment Management (1 test, ~10 min)
+12. **env-propagation-tests.sh** - Environment variable handling
+
+### Integration (1 test, ~30 min)
+13. **intelligent-coordinator-test.sh** - End-to-end coordinator workflow
+
+## Prerequisites
+
+The slash command will validate and setup prerequisites automatically:
+
+**Docker Environment:**
+- Docker daemon running
+- mcp-network exists or will be created
+- Redis container running or will be started
+
+**Images:**
+- cfn-coordinator:v3 (will build if missing)
+- cfn-agent:latest (will build if missing)
+
+**Environment Variables:**
+- ANTHROPIC_API_KEY (required for planning tests)
+- Z_AI_API_KEY (optional for custom routing tests)
+
+## Execution
+
+Main Chat will execute the following steps:
+
+### Step 1: Prerequisites Validation
+```bash
+# Check Docker daemon
+docker info >/dev/null 2>&1 || { echo "❌ Docker daemon not running"; exit 1; }
+
+# Create network if needed
+docker network inspect mcp-network >/dev/null 2>&1 || \
+  docker network create mcp-network
+
+# Start Redis if not running
+docker ps --filter "name=cfn-redis" --format "{{.Names}}" | grep -q cfn-redis || \
+  docker run -d --name cfn-redis --network mcp-network redis:alpine
+
+# Build coordinator image if missing
+docker images cfn-coordinator:v3 --format "{{.Repository}}" | grep -q cfn-coordinator || \
+  docker build -f Dockerfile.cfn-coordinator -t cfn-coordinator:v3 .
+
+# Build agent image if missing
+docker images cfn-agent:latest --format "{{.Repository}}" | grep -q cfn-agent || \
+  docker build -f Dockerfile.agent -t cfn-agent:latest .
+```
+
+### Step 2: Run Test Suite
+```bash
+#!/bin/bash
+set -euo pipefail
+
+PROJECT_ROOT=$(git rev-parse --show-toplevel)
+cd "$PROJECT_ROOT"
+
+# Test execution based on parameters
+CATEGORY="${1:-all}"
+TEST_FILE="${2:-}"
+VERBOSE="${3:-false}"
+QUICK="${4:-false}"
+
+# Test tracking
+TESTS_TOTAL=0
+TESTS_PASSED=0
+TESTS_FAILED=0
+FAILED_TESTS=()
+
+echo "=========================================="
+echo "Docker CFN Loop Core Test Suite"
+echo "=========================================="
+echo "Category: $CATEGORY"
+echo "Git: $(git branch --show-current) @ $(git rev-parse --short HEAD)"
+echo ""
+
+# Function to run test
+run_test() {
+    local test_file="$1"
+    local test_name=$(basename "$test_file" .sh)
+
+    echo "Running: $test_name"
+    TESTS_TOTAL=$((TESTS_TOTAL + 1))
+
+    if [[ "$VERBOSE" == "true" ]]; then
+        bash "$test_file"
+    else
+        bash "$test_file" >/dev/null 2>&1
+    fi
+
+    if [[ $? -eq 0 ]]; then
+        TESTS_PASSED=$((TESTS_PASSED + 1))
+        echo "  ✅ PASS: $test_name"
+    else
+        TESTS_FAILED=$((TESTS_FAILED + 1))
+        FAILED_TESTS+=("$test_name")
+        echo "  ❌ FAIL: $test_name"
+    fi
+    echo ""
+}
+
+# Determine which tests to run
+case "$CATEGORY" in
+    coordinator)
+        for test in tests/docker/core/coordinator-*.sh; do
+            run_test "$test"
+        done
+        ;;
+    infrastructure)
+        run_test "tests/docker/core/docker-hello-world-parity-tests.sh"
+        run_test "tests/docker/core/agent-lifecycle-tests.sh"
+        ;;
+    redis)
+        run_test "tests/docker/core/redis-coordination-tests.sh"
+        ;;
+    cfn-loop)
+        run_test "tests/docker/core/cfn-loop-compliance-tests.sh"
+        run_test "tests/docker/core/memory-budget-tests.sh"
+        ;;
+    integration)
+        run_test "tests/docker/core/intelligent-coordinator-test.sh"
+        ;;
+    all)
+        if [[ "$QUICK" == "true" ]]; then
+            # Skip long-running tests
+            echo "⚡ Quick mode: Skipping intelligent-coordinator-test.sh"
+            for test in tests/docker/core/*.sh; do
+                if [[ $(basename "$test") != "intelligent-coordinator-test.sh" ]]; then
+                    run_test "$test"
+                fi
+            done
+        else
+            # Run all tests
+            for test in tests/docker/core/*.sh; do
+                run_test "$test"
+            done
+        fi
+        ;;
+    *)
+        if [[ -n "$TEST_FILE" ]] && [[ -f "tests/docker/core/$TEST_FILE" ]]; then
+            run_test "tests/docker/core/$TEST_FILE"
+        else
+            echo "❌ Unknown category or test file: $CATEGORY"
+            exit 1
+        fi
+        ;;
+esac
+
+# Summary
+echo "=========================================="
+echo "Test Summary"
+echo "=========================================="
+echo "Total: $TESTS_TOTAL"
+echo "Passed: $TESTS_PASSED"
+echo "Failed: $TESTS_FAILED"
+
+if [[ $TESTS_FAILED -gt 0 ]]; then
+    echo ""
+    echo "Failed tests:"
+    for test in "${FAILED_TESTS[@]}"; do
+        echo "  - $test"
+    done
+    exit 1
+else
+    echo ""
+    echo "✅ All tests passed!"
+    exit 0
+fi
+```
+
+## Test Coverage
+
+| Category | Test Files | Test Cases | Coverage | Duration |
+|----------|-----------|------------|----------|----------|
+| Coordinator v3 | 6 | 20+ | 100% | ~45 min |
+| Docker Infrastructure | 2 | 8+ | 100% | ~15 min |
+| Redis Coordination | 1 | 4 | 100% | ~10 min |
+| Resource Management | 1 | 4 | 100% | ~10 min |
+| CFN Loop Patterns | 1 | 4 | 100% | ~10 min |
+| Environment Management | 1 | 4 | 100% | ~10 min |
+| Integration | 1 | E2E | 100% | ~30 min |
+| **Total** | **13** | **44+** | **100%** | **~130 min** |
+
+## Bug Fix Validation
+
+These tests validate documented bug fixes:
+- **Bug #4:** Agent task assignment pattern (agent-lifecycle-tests.sh)
+- **Bug #6:** Redis environment variable propagation (redis-coordination-tests.sh, env-propagation-tests.sh)
+
+## Examples
+
+**Full regression suite:**
+```
+/cfn-docker-core-test-suite
+```
+
+**Quick validation:**
+```
+/cfn-docker-core-test-suite --quick
+```
+
+**Coordinator tests only:**
+```
+/cfn-docker-core-test-suite --category coordinator
+```
+
+**Single test with verbose output:**
+```
+/cfn-docker-core-test-suite --test redis-coordination-tests.sh --verbose
+```
+
+## Output
+
+```
+==========================================
+Docker CFN Loop Core Test Suite
+==========================================
+Category: all
+Git: main @ abc123
+
+Running: coordinator-planning-tests
+  ✅ PASS: coordinator-planning-tests
+
+Running: coordinator-docker-in-docker-tests
+  ✅ PASS: coordinator-docker-in-docker-tests
+
+Running: coordinator-atomic-task-tests
+  ✅ PASS: coordinator-atomic-task-tests
+
+... (10 more tests)
+
+==========================================
+Test Summary
+==========================================
+Total: 13
+Passed: 13
+Failed: 0
+
+✅ All tests passed!
+```
+
+## Related Documentation
+
+- **Suite Overview:** `tests/docker/README.md`
+- **Test Standards:** `tests/CLAUDE.md`
+- **Planning Docs:** `tests/docker/docs/planning/`
+- **Execution Guide:** `tests/docker/docs/guides/EXECUTION_GUIDE.md`
+
+## CI/CD Integration
+
+This command can be used in CI/CD pipelines:
+
+```yaml
+# .github/workflows/docker-core-tests.yml
+name: Docker Core Tests
+on: [push, pull_request]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - name: Run Docker Core Tests
+        run: |
+          # Use the slash command logic
+          bash tests/docker/core/*.sh
+```

package/claude-assets/commands/cfn-loop-cli.md

@@ -30,7 +30,7 @@ TASK_ID="cfn-cli-$(date +%s%N | tail -c 7)-${RANDOM}"
 ```bash
 npx claude-flow-novice agent cfn-v3-coordinator \
   --task-id "$TASK_ID" \
-  --context "TASK_DESCRIPTION='$TASK_DESCRIPTION' MODE='$MODE' MAX_ITERATIONS=$MAX_ITERATIONS" \
+  --context "TASK_DESCRIPTION='$TASK_DESCRIPTION' MODE='$MODE' MAX_ITERATIONS=$MAX_ITERATIONS CFN_DOCKER_MODE='true'" \
   --timeout 300 \
   --background=true
 ```

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

@@ -25,29 +25,31 @@ Switch Main Chat and Task() tool API provider between multiple AI providers.
 **What This Does:**
 
 `/switch-api zai`:
-- Adds Z.ai env vars to `.claude/settings.json`
+- Adds Z.ai env vars to `.claude/settings.local.json` (or 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`
+- Adds Kimi env vars to `.claude/settings.local.json` (or 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`
+- Adds OpenRouter env vars to `.claude/settings.local.json` (or 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`
+- Removes env vars from `.claude/settings.local.json` (or settings.json)
 - Main Chat + Task() agents use Anthropic
 - Cost: $15/1M tokens (or $0 with unlimited plan)
 - **Requires** running `claude login`
 
+**Note:** Script automatically detects and uses `.claude/settings.local.json` if it exists, otherwise uses `.claude/settings.json`.
+
 **Combined Architecture:**
 ```
 Main Chat (Anthropic/Z.ai/Kimi/OpenRouter - your choice)
@@ -59,10 +61,22 @@ CLI spawn → Workers (custom routing when enabled, see agent profiles)
 
 **Execute:**
 ```bash
-bash "$(git rev-parse --show-toplevel 2>/dev/null || pwd)/scripts/switch-api.sh" {{args}}
+# Find project root (traverse up looking for scripts/switch-api.sh)
+SCRIPT_DIR="$PWD"
+while [ "$SCRIPT_DIR" != "/" ]; do
+    if [ -f "$SCRIPT_DIR/scripts/switch-api.sh" ]; then
+        break
+    fi
+    SCRIPT_DIR="$(dirname "$SCRIPT_DIR")"
+done
+if [ ! -f "$SCRIPT_DIR/scripts/switch-api.sh" ]; then
+    echo "Error: switch-api.sh not found. Please ensure you're in a project with CFN installed."
+    exit 1
+fi
+bash "$SCRIPT_DIR/scripts/switch-api.sh" {{args}}
 ```
 
-**Note:** Script automatically resolves to project root directory.
+**Note:** Script automatically detects and uses `.claude/settings.local.json` if it exists, otherwise uses `.claude/settings.json`.
 
 **Examples:**
 ```bash