interop-router

Automatic Routing to External AI CLIs

Auto-trigger: This skill evaluates tasks automatically and decides whether to delegate to an external CLI. No manual invocation needed.

---

Auto-Trigger Conditions

Automatically evaluate when detecting:

• Large refactoring (10+ files affected)
• Batch file changes
• Template generation tasks
• Multi-model cross-validation needs

---

Decision Scoring

Calculate delegation score using 3 factors:

Factor	Range	Description
Benefit	0.0 - 0.6	Can external CLI produce faster/more reliable results?
Cost	-0.3 - 0.0	Overhead of wrapping, normalizing, reviewing
Risk	-0.3 - 0.0	Permission/write/secret leakage risks

Threshold: Score >= 0.15 with auto-interop enabled -> auto-execute delegation

---

Routing Targets

Task Type	Target CLI	Reason
Large codebase exploration	Gemini	1M token context
Batch implementation	Codex	Fast bulk generation
Complex architecture analysis	Gemini	Deep reasoning
Template generation	Codex	Efficient structured output

---

Process

1. Check CLI Availability

bash "$CLAUDE_PROJECT_DIR/skills/interop-router/scripts/check_cli_available.sh" --json

2. Score the Decision

python3 "$CLAUDE_PROJECT_DIR/skills/interop-router/scripts/score_decision.py" \
  --task "task description" \
  --files 15 \
  --complexity high \
  --json

3. Wrap Context (if delegating)

python3 "$CLAUDE_PROJECT_DIR/skills/interop-router/scripts/wrap_context.py" \
  --files src/*.py \
  --diff \
  --output /tmp/context.md

4. Execute with External CLI

# Codex
codex "Your task description" < /tmp/context.md

# Gemini
gemini "Your task description" -f /tmp/context.md

---

Safety Constraints

• Default read-only mode
• Automatic secret filtering (API keys, passwords, tokens, connection strings)
• All results must be reviewed before landing
• Sensitive files (.env, credentials, private keys) are always skipped

---

Configuration

Enable auto-interop:

# Project-level (takes precedence)
mkdir -p .claude/flags
echo '{"enabled": true}' > .claude/flags/auto-interop.json

# User-level
mkdir -p ~/.claude/flags
echo '{"enabled": true}' > ~/.claude/flags/auto-interop.json