claude-flow-novice 2.5.2 → 2.6.0

package/.claude/commands/custom-routing-activate.md

@@ -1,141 +1,55 @@
-# /custom-routing-activate - Enable Cost-Optimized Routing
+---
+description: DEPRECATED - Use /switch-api zai instead
+tags: [deprecated, routing]
+---
 
-Activate tiered provider routing to reduce LLM costs by routing most agents to Z.ai while keeping high-value agents on Anthropic.
+# ⚠️ DEPRECATED Command
 
-## Usage
+**This command is deprecated and no longer needed.**
 
-```bash
-/custom-routing-activate
-```
-
-Simple! No arguments needed. Just run the command to enable cost optimization.
-
-## What It Does
-
-Activates intelligent routing with three priority levels:
-
-### Priority 1: Agent Profile Override
-Agents can specify their preferred provider in their profile:
-```yaml
-provider: zai        # Force Z.ai for this agent
-provider: anthropic  # Force Anthropic for this agent
-```
-
-### Priority 2: Tier Configuration
-**ALL Task Tool agents route to Z.ai** for maximum cost savings:
-- `coder`, `tester`, `reviewer` → Z.ai
-- `architect`, `coordinator`, `system-architect` → Z.ai
-- `devops-engineer`, `security-specialist` → Z.ai
-- All 70+ agent types → Z.ai
-
-Only the main chat uses Anthropic Claude Max:
-- `main-chat` → Anthropic (your direct conversations)
-
-## Cost Savings
-
-**Example calculation:**
-```
-Without routing: 100 agent calls × $0.015 = $1.50
-With routing:    99 calls × $0.003 (Z.ai) + 1 call × $0.015 (main-chat) = $0.31
-
-💰 Savings: 79% cost reduction (all agents on Z.ai)
-```
-
-## Output
-
-When you run `/custom-routing-activate`:
-
-```
-═══════════════════════════════════════════════════════
-   Activating Tiered Provider Routing
-═══════════════════════════════════════════════════════
-
-✅ Tiered Provider Routing ACTIVATED
+## Use Instead
 
-📊 Active Routing:
-  • ALL Task Tool agents (70+ types) → Z.ai
-  • Main chat only → Anthropic Claude Max
-  • Maximum cost optimization enabled
-
-💰 Cost Optimization:
-  • ~79% cost reduction on agent usage
-  • All spawned agents use affordable Z.ai provider
-  • Only main chat uses Anthropic Claude Max
-
-🎯 Agent Profile Overrides:
-  • Add provider: zai to agent profile → force Z.ai
-  • Add provider: anthropic to agent profile → force Anthropic
-
-💾 Configuration saved to:
-   /path/to/project/.claude/settings.json
-
-📖 To disable routing:
-   /custom-routing-deactivate
-═══════════════════════════════════════════════════════
-```
-
-## When to Use
-
-**Enable for:**
-- ✅ Production development (cost savings)
-- ✅ High-volume agent usage
-- ✅ Projects with budget constraints
-- ✅ Default recommendation for most projects
-
-**Disable for:**
-- Testing quality differences between providers
-- Debugging provider-specific issues
-- Ensuring consistent provider behavior
-- Short-term projects where consistency matters more than cost
-
-## Configuration
-
-Settings are saved to `.claude/settings.json`:
-
-```json
-{
-  "tieredRouting": {
-    "enabled": true
-  }
-}
+```bash
+/switch-api zai
 ```
 
-## Related Commands
+## What Changed
 
-- `/custom-routing-deactivate` - Disable tiered routing
-- `/cfn-loop` - Self-correcting development loop (respects routing)
-- `/swarm` - Multi-agent coordination (respects routing)
+**Old system (custom-routing):**
+- Designed for per-agent profile routing
+- Required `tieredRouting` flag in settings.json
+- Never fully implemented
 
-## Best Practices
+**New system (switch-api):**
+- ✅ Simple env var configuration
+- ✅ Works with Main Chat + Task tool
+- ✅ CLI agents use separate routing (.env)
+- ✅ Fully operational
 
-1. **Enable by default** - Activate routing for immediate cost savings
-2. **Monitor quality** - Ensure Z.ai quality meets your standards
-3. **Profile strategic agents** - Mark critical agents with `provider: anthropic`
-4. **Test both modes** - Compare results with routing on and off
+## Migration
 
-## Examples
-
-### First-time activation
+**If you were using `/custom-routing-activate`:**
 ```bash
-$ /custom-routing-activate
-
-✅ Tiered Provider Routing ACTIVATED
-
-💰 Cost Optimization:
-  • ~64% cost reduction on agent usage
+# Just run this instead:
+/switch-api zai
 ```
 
-### Already activated
-```bash
-$ /custom-routing-activate
+**Effect:**
+- Main Chat + Task() agents use Z.ai ($0.50/1M)
+- CLI agents use Z.ai (from .env)
+- Combined 97% cost savings
 
-✅ Tiered routing is already ENABLED
+## Why Deprecated
 
-💡 To disable, run: /custom-routing-deactivate
-```
+The custom-routing system was designed but never fully implemented. The new switch-api provides:
+
+1. **Simpler configuration** - Just env vars
+2. **Actually works** - Complete implementation
+3. **Clear separation** - Main Chat vs CLI routing
+4. **Better documentation** - See `/switch-api` help
 
 ## See Also
 
-- **Deactivation**: `/custom-routing-deactivate`
-- **Status Check**: `/activate-custom-routing` (shows current status)
-- **Agent Profiles**: `.claude/agents/*.md` (add `provider` field)
+- `/switch-api` - Current routing system
+- `/switch-api zai` - Enable Z.ai for Main Chat
+- `/switch-api max` - Use Anthropic for Main Chat

package/.claude/commands/custom-routing-deactivate.md

@@ -1,143 +1,46 @@
-# /custom-routing-deactivate - Disable Tiered Routing
+---
+description: DEPRECATED - Use /switch-api max instead
+tags: [deprecated, routing]
+---
 
-Deactivate tiered provider routing so all agents use the default provider configuration (sonnet model).
+# ⚠️ DEPRECATED Command
 
-## Usage
+**This command is deprecated and no longer needed.**
 
-```bash
-/custom-routing-deactivate
-```
-
-Simple! No arguments needed. Just run the command to disable tiered routing.
-
-## What It Does
-
-Disables profile-based provider routing. After deactivation:
-
-- ✅ All agents use **sonnet model** (from agent profiles)
-- ✅ Single provider for all agents
-- ✅ No provider-based routing
-- ✅ Consistent behavior across all agents
-
-## Use Cases
-
-**Disable for:**
-- Testing quality differences between providers
-- Debugging provider-specific issues
-- Ensuring consistent provider behavior
-- A/B testing routing vs non-routing
-- Projects where consistency matters more than cost
-
-**Enable for:**
-- Production development (cost savings)
-- High-volume agent usage
-- Projects with budget constraints
-
-## Output
-
-When you run `/custom-routing-deactivate`:
-
-```
-═══════════════════════════════════════════════════════
-   Deactivating Tiered Provider Routing
-═══════════════════════════════════════════════════════
-
-✅ Tiered Provider Routing DEACTIVATED
-
-📊 Current Routing:
-  • All agents use sonnet model (from agent profiles)
-  • Single provider for all agents
-  • No provider-based routing
-
-⚠️  Cost Impact:
-  • All agents use default provider (typically Anthropic)
-  • No cost optimization active
-  • Useful for testing or consistency requirements
-
-💾 Configuration saved to:
-   /path/to/project/.claude/settings.json
-
-📖 To enable routing:
-   /custom-routing-activate
-═══════════════════════════════════════════════════════
-```
+## Use Instead
 
-## Configuration
-
-Settings are saved to `.claude/settings.json`:
-
-```json
-{
-  "tieredRouting": {
-    "enabled": false
-  }
-}
-```
-
-## Cost Impact
-
-**Without routing (after deactivation):**
-```
-100 agent calls × $0.015 (Anthropic) = $1.50
-```
-
-**With routing (before deactivation):**
-```
-80 calls × $0.003 (Z.ai) + 20 calls × $0.015 (Anthropic) = $0.54
+```bash
+/switch-api max
 ```
 
-**Impact of deactivation:** +$0.96 per 100 agent calls (178% increase)
-
-## Related Commands
-
-- `/custom-routing-activate` - Enable tiered routing
-- `/activate-custom-routing` - Show routing status
-- `/cfn-loop` - Self-correcting development loop
+## What This Does
 
-## When to Deactivate
+Switches Main Chat + Task tool back to Anthropic (default provider).
 
-### Good Reasons:
-✅ Testing quality differences
-✅ Debugging provider issues
-✅ Short-term consistency needs
-✅ Comparing routing vs non-routing
+**Note:** Requires running `claude login` after switching.
 
-### Bad Reasons:
-❌ "I don't understand routing" - Learn it first, saves money
-❌ "Too complicated" - It's automatic once enabled
-❌ "Not sure if it works" - Test it with small tasks first
+## Migration
 
-## Examples
-
-### Deactivate routing
+**If you were using `/custom-routing-deactivate`:**
 ```bash
-$ /custom-routing-deactivate
-
-✅ Tiered Provider Routing DEACTIVATED
+# Just run this instead:
+/switch-api max
 
-📊 Current Routing:
-  • All agents use sonnet model (from agent profiles)
-  • Single provider for all agents
+# Then re-authenticate:
+claude login
 ```
 
-### Already deactivated
-```bash
-$ /custom-routing-deactivate
-
-✅ Tiered routing is already DISABLED
-
-💡 To enable cost optimization, run: /custom-routing-activate
-```
+## Why Deprecated
 
-## Best Practices
+The custom-routing system was designed but never fully implemented. The new switch-api provides the same functionality with:
 
-1. **Deactivate temporarily** - Only disable for testing, then re-enable
-2. **Document why** - Note the reason for deactivation in project docs
-3. **Set reminder** - Remember to re-enable after testing
-4. **Compare results** - Use deactivation to validate routing quality
+1. **Simpler commands** - `/switch-api zai` or `/switch-api max`
+2. **Actually works** - Complete implementation
+3. **Clear behavior** - Explicit env var management
+4. **Better docs** - See `/switch-api` help
 
 ## See Also
 
-- **Activation**: `/custom-routing-activate`
-- **Status Check**: `/activate-custom-routing`
-- **Cost Analysis**: Check `.claude/settings.json` for current state
+- `/switch-api` - Current routing system
+- `/switch-api max` - Use Anthropic for Main Chat
+- `/switch-api zai` - Use Z.ai for cost savings

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

@@ -1,28 +1,53 @@
 ---
-description: Switch between z.ai and Anthropic Claude Max API providers
-tags: [config, api, utility]
+description: Switch Main Chat and Task tool between Z.ai and Anthropic providers
+tags: [config, api, cost-optimization]
 ---
 
-Switch Claude API provider between z.ai (GLM models) and official Anthropic Claude Max.
+Switch Main Chat and Task() tool API provider between Z.ai (cost-optimized) and Anthropic (high-quality).
+
+**Important:** CLI agents always use Z.ai (from `.env`). This command only affects Main Chat and Task() spawned agents.
 
 **Usage:**
-- `/switch-api` - Show current API
-- `/switch-api zai` - Switch to z.ai (GLM-4.6)
-- `/switch-api max` - Switch to Claude Max
-- `/switch-api list` - List saved configurations
-- `/switch-api save <name>` - Save current config
-- `/switch-api restore <name>` - Restore saved config
+- `/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)
 
 **Arguments:**
-- `zai` - Use z.ai API with GLM models
-- `max` or `claude` - Use official Anthropic API
-- `status` - Show current API configuration
-- `list` - List all saved configurations
-- `save <name>` - Save current settings
-- `restore <name>` - Restore previously saved settings
+- `status` - Show current routing configuration (default)
+- `zai` - Route Main Chat + Task tool to Z.ai for cost savings
+- `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`
+- Main Chat + Task() agents use Z.ai
+- Cost: $0.50/1M tokens (97% savings)
+- No login required
 
-Execute API switch using bash script:
+`/switch-api max`:
+- Removes env vars from `.claude/settings.json`
+- Main Chat + Task() agents use Anthropic
+- Cost: $15/1M tokens (or $0 with unlimited plan)
+- **Requires** running `claude login`
 
+**Combined Architecture:**
+```
+Main Chat (Anthropic or Z.ai - your choice)
+  ↓
+Task() → Coordinator (uses Main Chat provider)
+  ↓
+CLI spawn → Workers (always Z.ai from .env)
+```
+
+**Execute:**
 ```bash
 bash scripts/switch-api.sh {{args}}
 ```
+
+**Examples:**
+```bash
+/switch-api          # Show current routing
+/switch-api zai      # Cost-optimize Main Chat
+/switch-api max      # Quality-optimize Main Chat (requires re-login)
+```

package/.claude/skills/agent-execution/execute-agent.sh

@@ -0,0 +1,126 @@
+#!/usr/bin/env bash
+##############################################################################
+# Agent Execution Script
+#
+# Executes CLI-spawned agents by invoking Claude API with agent prompt.
+# Supports both Anthropic and z.ai provider routing.
+#
+# Environment Variables:
+#   AGENT_TYPE      - Agent type/name (e.g., "rust-enterprise-developer")
+#   AGENT_ID        - Unique agent identifier (e.g., "rust-enterprise-1")
+#   AGENT_MODEL     - Model to use (haiku, sonnet, opus)
+#   AGENT_TOOLS     - Comma-separated list of tools
+#   TASK_ID         - Task identifier for CFN Loop coordination
+#   ITERATION       - Current iteration number
+#   MODE            - Execution mode (cli, api, hybrid)
+#   PROMPT_FILE     - Path to file containing agent prompt
+#
+# Usage:
+#   ./execute-agent.sh
+##############################################################################
+
+set -euo pipefail
+
+# Validate required environment variables
+if [ -z "${AGENT_TYPE:-}" ]; then
+  echo "Error: AGENT_TYPE environment variable required" >&2
+  exit 1
+fi
+
+if [ -z "${PROMPT_FILE:-}" ] || [ ! -f "${PROMPT_FILE:-}" ]; then
+  echo "Error: PROMPT_FILE must be set and file must exist" >&2
+  exit 1
+fi
+
+# Default values
+AGENT_ID="${AGENT_ID:-${AGENT_TYPE}-1}"
+AGENT_MODEL="${AGENT_MODEL:-haiku}"
+TASK_ID="${TASK_ID:-}"
+ITERATION="${ITERATION:-1}"
+MODE="${MODE:-cli}"
+
+echo "=== Agent Execution ==="
+echo "Agent Type: $AGENT_TYPE"
+echo "Agent ID: $AGENT_ID"
+echo "Model: $AGENT_MODEL"
+echo "Task ID: ${TASK_ID:-N/A}"
+echo "Iteration: $ITERATION"
+echo "Mode: $MODE"
+echo ""
+
+# Read prompt from file
+PROMPT=$(cat "$PROMPT_FILE")
+
+# Determine API provider
+API_PROVIDER="anthropic"
+if [ -f ".claude/config/api-provider.json" ]; then
+  PROVIDER_CONFIG=$(cat .claude/config/api-provider.json)
+  if echo "$PROVIDER_CONFIG" | grep -q '"provider".*"zai"'; then
+    API_PROVIDER="zai"
+  fi
+fi
+
+if [ "${CLAUDE_API_PROVIDER:-}" = "zai" ]; then
+  API_PROVIDER="zai"
+fi
+
+echo "API Provider: $API_PROVIDER"
+echo ""
+
+# Map agent model to API model name
+case "$AGENT_MODEL" in
+  haiku)
+    API_MODEL="claude-3-5-haiku-20241022"
+    ;;
+  sonnet)
+    API_MODEL="claude-3-5-sonnet-20241022"
+    ;;
+  opus)
+    API_MODEL="claude-3-opus-20240229"
+    ;;
+  *)
+    echo "Warning: Unknown model '$AGENT_MODEL', defaulting to haiku" >&2
+    API_MODEL="claude-3-5-haiku-20241022"
+    ;;
+esac
+
+# For now, we'll simulate agent execution by echoing the prompt
+# TODO: Implement actual API calls when API client is ready
+echo "=== Agent Prompt (First 500 chars) ==="
+echo "$PROMPT" | head -c 500
+echo "..."
+echo ""
+echo "=== Agent Execution Status ==="
+echo "✅ Agent prompt prepared successfully"
+echo "⚠️  Note: Direct API execution not yet implemented"
+echo ""
+echo "Next Steps:"
+echo "1. Integrate with Claude API SDK"
+echo "2. Implement streaming response handling"
+echo "3. Add tool execution support"
+echo ""
+
+# For CFN Loop agents, simulate completion protocol
+if [ -n "$TASK_ID" ]; then
+  echo "=== CFN Loop Simulation ==="
+  echo "This agent would execute the following protocol:"
+  echo ""
+  echo "1. Execute task work"
+  echo "2. redis-cli lpush \"swarm:${TASK_ID}:${AGENT_ID}:done\" \"complete\""
+  echo "3. ./.claude/skills/redis-coordination/invoke-waiting-mode.sh report \\"
+  echo "     --task-id \"$TASK_ID\" \\"
+  echo "     --agent-id \"$AGENT_ID\" \\"
+  echo "     --confidence 0.85 \\"
+  echo "     --iteration $ITERATION"
+  echo "4. ./.claude/skills/redis-coordination/invoke-waiting-mode.sh enter \\"
+  echo "     --task-id \"$TASK_ID\" \\"
+  echo "     --agent-id \"$AGENT_ID\" \\"
+  echo "     --context \"iteration-complete\""
+  echo ""
+fi
+
+# Clean up prompt file
+rm -f "$PROMPT_FILE"
+
+# Exit with success (temporary until real execution implemented)
+exit 0