Orquestrador Windows-first para Claude Code como planejador principal, Codex como executor e Claude como validador condicional, com failover reativo entre perfis Claude e handoff estruturado de baixo contexto.
Use esta skill quando o trabalho pedir coordenacao entre modelos, troca automatica de perfis Claude por cota, ou quando o usuario quiser explicitar o fluxo Claude planeja -> Codex executa -> Claude valida quando vale a pena.
Claude decide o plano, o risco e se vale chamar outro modelo.Codex executa implementacao, automacao e alteracoes de codigo.Claude valida apenas quando o risco justificar custo e latencia.Nao trate esta skill como um "roteador multi-IA generico". O caminho padrao aqui e:
Nao tente adivinhar seu nome. Observe as ferramentas que voce tem disponíveis:
| Voce tem esta ferramenta |
|---|
| Voce provavelmente e |
|---|
| Como chamar Claude |
|---|
Agent tool | Claude Code | Agent tool nativo (nao use subprocess) |
exec/shell sem Agent tool | Codex, Gemini ou Qwen | echo "prompt" | claude --print |
# Claude
echo "prompt" | claude --print
# Codex (obrigatorio limpar variaveis OpenRouter)
echo "prompt" | unset OPENAI_BASE_URL && unset OPENAI_API_KEY && codex exec --skip-git-repo-check -
# Qwen
echo "prompt" | qwen
# Gemini (nao suporta stdin direto — usar arquivo temporario)
cat > /tmp/prompt.txt << 'EOF'
prompt aqui
EOF
gemini -m gemini-3-flash-preview -p "@/tmp/prompt.txt"
Nunca use -p "prompt inline" para prompts com codigo, JSON ou dados — o cmd.exe no Windows
corrompe {, }, | e % silenciosamente.
Classifique o pedido em um destes modos antes de executar:
claude_only
codex
Valide no Claude somente quando houver um ou mais destes sinais:
security, auth, privacy, pii, migration, schema, billing, infra, refactorPara decidir programaticamente: grep -iE 'security|auth|password|token|pii|migration|billing|schema' <arquivos> — se der match, acione validacao.
Quando o Codex devolver contexto para o Claude, responda apenas este JSON:
{
"status": "OK|ERRO|PARCIAL",
"task_summary": "o que foi feito em 1-2 frases",
"changed_files": ["lista/de/arquivos.py"],
"tests_run": true,
"risks": ["lista de riscos ou array vazio"],
"analyst_summary": "observacoes tecnicas relevantes",
"next_action": "DONE|NEEDS_VALIDATION|NEEDS_RETRY|ESCALATE"
}
NEVER envolva a resposta em blocos markdown (```json). Stdout deve comecar com { e terminar com } para permitir parse direto via jq ou Python.
Sempre que o usuario quiser o fluxo automatizado, prefira os scripts desta skill:
scripts/claude_codex_orchestrator.py bootstrap-profilesscripts/claude_codex_orchestrator.py call-claudescripts/claude_codex_orchestrator.py call-codexscripts/claude_codex_orchestrator.py routescripts/claude_codex_orchestrator.ps1 ...Esses comandos existem para:
CLAUDE_CONFIG_DIR por perfil.cmd correto no WindowsPerfis vivem fora do repositorio, por padrao em:
%USERPROFILE%\.claude-profiles\claude-a%USERPROFILE%\.claude-profiles\claude-bCredenciais e estado ficam fora do hub. So compartilhe no bootstrap os assets nao sensiveis, como:
skillspluginscommandssettings.jsontrustedFolders.jsonNao copie credenciais entre perfis manualmente.
bootstrap-profiles.route.scripts/run_ai_cli.py --provider X --prompt-file /tmp/prompt.txt.calling-conventions.md (kill de arvore de processo no Windows)ai-catalog.md (quirks e fallback de IA)calling-conventions.mdreferences/codex-native-multiagent.mdPara pacotes como superpowers, nao importe a raiz do repositorio como se fosse uma unica skill.
Use o hub para:
SKILL.md raizConsulte:
references/windows-orchestrator.mdreferences/windows-orchestrator.config.example.jsonreferences/calling-conventions-powershell.md