Roteamento de Fronteira Eficiente (Efficient Frontier Routing)
Corresponda o modelo ao trabalho no Claude Code, Codex ou outro agente que possa iniciar subagentes em um modelo escolhido (por exemplo, Gemini CLI ou Antigravity CLI), independentemente do modelo da sessão principal. Uma sessão principal mais barata pode coordenar trabalho rotineiro e consultar um agente mais forte; uma sessão principal mais forte pode delegar trabalho rotineiro para agentes mais baratos. Mantenha tarefas pequenas localmente quando uma transferência custaria mais do que fazer o trabalho.
Ajuda e Configuração
Quando invocado com help ou --help, leia a ajuda de configuração,
explique os controles e exemplos e pare. Não inicie trabalho delegado nem
altere configurações para uma solicitação de ajuda. Para perguntas de configuração, leia a mesma
referência; para tarefas comuns, ignore-a.
Aplique as preferências de roteamento da solicitação do usuário e dos arquivos de instrução aplicáveis. Para as preferências deste skill, use primeiro as instruções explícitas da tarefa, depois as preferências do projeto, depois as preferências globais e, por fim, os padrões abaixo. Permissões do host, disponibilidade do modelo e limites obrigatórios ainda se aplicam. Os usuários podem escolher os modelos de descoberta, implementação e revisão; esforço por agente; gatilhos de escalonamento e número de repetições; um número máximo de subagentes simultâneos; e se o escalonamento requer aprovação. Respeite um teto de modelo configurado ou preferência de não delegação. Se uma revisão necessária não puder ser executada dentro desses limites, relate a revisão não atendida em vez de substituí-la silenciosamente. Estas são instruções interpretadas pelo assistente, não configurações JSON ou um limite de gastos rígido. Não edite preferências persistentes a menos que solicitado.
Fluxo de Trabalho
- Identifique decisões que exigem julgamento mais forte: arquitetura, ambiguidade, risco, evidências conflitantes e revisão técnica final. Lidere-as na sessão principal quando ela for adequada para a tarefa; caso contrário, delegue para cima.
- Identifique trabalho delegável: varreduras de pesquisa, inventário de repositório, busca, extração de documentação, passes de navegador/teste, redução de logs, agrupamento de falhas de teste, codificação restrita e edições mecânicas.
- Crie subagentes para transferências justificadas, paralelizando fatias independentes com propriedade clara, escopo limitado, portões de verificação e evidências.
- Exija retornos compactos: descobertas, arquivos alterados, comandos executados, risco residual, condições de parada atingidas e decisões que precisam de síntese ou escalonamento.
- Integre e revise centralmente antes de apresentar o resultado.
Pacotes de Transferência
Escreva prompts delegados como pacotes autossuficientes. Presuma que o agente receptor não viu a conversa. Inclua o caminho do repositório, objetivo, escopo, áreas fora do escopo, arquivos relevantes ou alvos de busca, formato de retorno esperado, comandos de verificação e condições de parada.
Condições de parada úteis:
- O código ativo não corresponde à suposição na transferência.
- Um comando de verificação atinge o limite de repetições configurado (padrão: duas tentativas com falha após correções razoáveis).
- O trabalho parece exigir arquivos fora do escopo atribuído.
- O agente não consegue produzir evidências concretas para sua afirmação.
Ciclo de Revisão
Trate a saída delegada como evidência a ser inspecionada, não como um veredito a ser encaminhado. Reabra arquivos importantes citados, examine diffs de alto risco e reexecute ou verifique pontualmente a verificação que importa antes de alegar conclusão. Se agentes delegados discordarem em uma questão técnica difícil, use um revisor mais forte com as evidências. Mantenha as escolhas de produto e mudanças de escopo com o usuário.
Cenários Comuns
Use como sugestões flexíveis:
- Pesquisa: delegue varreduras amplas de repositório, extração de documentação e comparação de fontes; a sessão principal prioriza os resultados e escala julgamentos difíceis.
- Codificação: delegue patches delimitados, refatorações ou edições mecânicas quando a propriedade do arquivo for clara; integre e revise centralmente.
- Testes: escolha a estratégia de validação no nível de raciocínio apropriado, depois use agentes mais baratos para executar verificações unitárias, fluxos de navegador, capturas de tela e redução de logs. Peça a eles que retornem comandos exatos, falhas, causas prováveis e se o sinal parece instável, ambiental ou relevante para o produto.
- Depuração: envie agentes independentes para teorias, logs ou caminhos de reprodução separados; escale o diagnóstico quando as evidências permanecerem conflitantes.
Exemplo Prático
Uma sessão principal Sonnet recebe "corrija os testes de checkout com falha e aperte a regra de reembolso enquanto você está nisso", com preferências de projeto de Haiku para descoberta, Sonnet para implementação, Opus com alto esforço para revisão arriscada, e no máximo dois subagentes simultâneos.
- A descoberta vai para um subagente Haiku: execute o conjunto de testes, agrupe as falhas e retorne os testes com falha, os arquivos que eles tocam e os comandos exatos. Um segundo subagente Haiku mapeia onde a lógica de reembolso reside.
- As falhas se agrupam em uma fixture desatualizada. Isso é um reparo delimitado e mecânico, então a sessão principal o faz localmente em vez de pagar por uma transferência.
- A regra de reembolso toca na cobrança, que é de alto risco. Antes de editar, a
sessão principal envia para Opus (solicitado explicitamente,
effort: high) um pacote com os arquivos de reembolso, a alteração proposta, os testes atuais e uma pergunta: esta alteração quebra algum caminho de reembolso existente? - A sessão principal aplica a alteração, executa os testes novamente, reabre os dois arquivos que Opus sinalizou e relata qual modelo executou cada etapa, para que o usuário possa ver que a revisão mais forte realmente aconteceu.
Correspondência de Níveis
Use os modelos disponíveis do host e os mapeamentos do usuário para escolher o nível mais barato adequado, acima ou abaixo do modelo da sessão principal:
| Trabalho | Capacidade necessária | Exemplos Claude | Codex e outros hosts |
|---|---|---|---|
| Descoberta, resumos, verificações factuais | Extração rápida e precisa | Haiku | Um modelo rápido disponível adequado para trabalho factual |
| Implementação e testes com escopo definido | Codificação confiável dentro de padrões estabelecidos | Sonnet | Um modelo de codificação disponível adequado ao escopo |
| Arquitetura, depuração profunda, revisão arriscada | Raciocínio forte entre sistemas | Opus, ou Fable onde disponível | Um modelo de raciocínio mais forte disponível |
Os nomes Claude são exemplos para sessões Claude, não aliases para passar ao Codex. Não invente IDs de modelo Codex nem presuma um mapeamento um-para-um permanente entre fornecedores. Inspecione as opções de modelo disponíveis do host e use nomes válidos explícitos. Permaneça com o provedor atual para roteamento comum, a menos que o usuário solicite o contrário; aplique a regra separada de revisão de fornecedor diferente quando necessário. Selecione o esforço independentemente do modelo e respeite os limites de esforço do usuário. Não defina todos os agentes como o esforço mais alto.
Uma sessão principal mais forte pode tomar decisões difíceis diretamente. De uma sessão mais barata, delegue a decisão difícil ou revisão com um pacote de evidências compacto, depois integre o resultado e execute as verificações necessárias. Se o host expuser apenas um modelo, mantenha o trabalho nele e relate qualquer requisito de revisão mais forte não atendido. Não reivindique um nível de modelo mais alto meramente porque o esforço aumentou.
Escalonamento a Partir de uma Sessão Principal Mais Barata
Escale antes de implementar uma mudança arquitetônica desconhecida ou uma mudança em um invariante de alto risco, sujeito à política de escalonamento do usuário. Também escale quando as evidências entrarem em conflito ou o limite de repetições for alcançado (padrão: duas tentativas razoáveis no mesmo problema técnico). Reutilize evidências coletadas; não pague por outra exploração ampla dos mesmos arquivos.
Trate autenticação, cobrança, permissões, segurança, migrações, perda de dados, estado compartilhado, cache, concorrência, comportamento entre módulos, APIs públicas e fluxos de trabalho visíveis ao usuário como de alto risco. Use o nível mais forte adequado para a decisão ou revisão técnica. Quando o usuário exigir uma revisão por um modelo de fornecedor diferente para trabalho de alto risco, mantenha essa revisão; ela adiciona a perspectiva de um modelo diferente.
No Claude Code, solicite explicitamente o model do subagente na chamada de Agente ou
use um agente personalizado com model: opus (e effort: high quando apropriado).
Um modelo não especificado pode herdar o modelo principal mais barato. Use um subagente
comum com uma transferência focada; uma ramificação de conversa usa o modelo principal.
Verifique o modelo relatado, usando /tasks quando disponível. No Codex ou outro
host, defina explicitamente o modelo e o esforço de raciocínio através do seletor
por agente suportado pelo host. Use uma transferência de tarefa focada se herdar a
conversa completa impedir uma substituição de modelo. Verifique a seleção
relatada; se o host não puder selecionar modelos por agente, relate essa limitação
em vez de simular roteamento.
Mantenha a sessão principal em seu modelo escolhido. Esta é uma instrução de roteamento, não um roteador automático de tempo de execução nem uma garantia de que o modelo mais barato detectará todos os casos difíceis. Se o modelo necessário estiver indisponível ou restrito, relate a limitação em vez de reivindicar silenciosamente que ocorreu uma revisão mais forte.
Proteções
- Para um bloqueio imediato, trabalhe localmente, a menos que uma experiência mais forte ou isolamento de contexto justifiquem uma transferência sequencial. Faça trabalho independente enquanto espera, quando disponível.
- Não peça a vários agentes para editar os mesmos arquivos ao mesmo tempo.
- Não confie cegamente nas conclusões do subagente quando o risco for alto; inspecione você mesmo as evidências importantes.
- Não reivindique economia universal. O padrão funciona melhor quando exploração e implementação, teste ou pesquisa podem ser paralelizados.
Estrutura Padrão
"Vou manter o trabalho rotineiro no modelo atual ou em um mais barato e delegar decisões difíceis ou revisões arriscadas a um agente mais forte quando necessário."