Como rotear papéis do T25 entre Claude Code, Codex e Cursor
Configure cada estágio para usar o CLI certo e deixe uma alternativa em ordem de preferência.
Read in English Versão em Markdown
O que significa rotear um papel
No T25, rotear um papel é escolher quais adapters CLI podem executar uma função do pipeline, como planner, dev-backend ou reviewer, e em que ordem devem ser considerados. A configuração fica em routing no t25.yaml.
Isso é diferente de escolher um agente para toda a tarefa. Uma ordem passa por vários papéis, e cada um pode ter uma lista própria. O artigo sobre a arquitetura do T25 explica por que os CLIs executam o trabalho enquanto o pipeline mantém o controle das transições.
Confira os CLIs primeiro
O T25 não instala nem autentica o Claude Code, Codex ou Cursor por você. Instale cada CLI que pretende usar e conclua o login no mesmo ambiente em que roda o processo do T25. Se o T25 roda dentro de um container ou serviço, confirme que esse ambiente enxerga os binários e as credenciais necessários.
No repositório atual, os adapters chamam claude, codex e cursor-agent. A documentação lista também kimi, gemini, opencode, pi, vibe e mock. Para detalhes específicos de login e planos de cada fornecedor, use a documentação oficial do CLI: esses requisitos podem mudar independentemente do T25.
Configure uma ordem por papel
O exemplo abaixo mostra três CLIs suportados em cada papel. A ordem varia conforme a preferência: Claude Code, Codex e Cursor podem servir como primeira opção ou fallback, desde que estejam instalados e autenticados no ambiente do T25:
routing:
triage: [claude, codex, cursor]
planner: [claude, cursor, codex]
research: [claude, codex, cursor]
dev-frontend: [cursor, claude, codex]
dev-backend: [codex, claude, cursor]
qa-frontend: [cursor, claude, codex]
qa-backend: [codex, cursor, claude]
reviewer: [claude, codex, cursor]
security: [claude, cursor, codex]
docs: [claude, codex, cursor]
release: [claude, cursor, codex]
É um ponto de partida ilustrativo, não uma recomendação universal. A ordem deve refletir os CLIs instalados e as preferências do seu projeto. Os nomes dos onze papéis e dos adapters precisam corresponder aos aceitos pelo T25; cada lista deve ser não vazia.
O T25 considera a lista ordenada e resolve os providers disponíveis para o papel. Uma alternativa configurada não corrige credenciais expiradas, permissões insuficientes ou diferenças de comportamento entre CLIs. Trate cada CLI como uma dependência a verificar, e confira o resultado da tarefa quando houver fallback.
Um fluxo simples para começar
- Comece com dois CLIs instalados e autenticados, em vez de configurar todos de uma vez.
- Escolha um papel e uma tarefa pequena, como uma correção de documentação, e defina uma lista curta em
t25.yaml. - Rode uma tarefa pequena e confira no cockpit qual adapter foi selecionado e como terminou.
- Acrescente fallback ou mude a ordem apenas depois de observar a execução.
- Repita para os papéis de implementação, QA e revisão. A seleção de um CLI não remove os gates do pipeline.
Se quiser entender o isolamento do trabalho antes de rodar uma ordem, leia uma ordem, um worktree. Para a configuração completa, consulte a referência de configuração.
Onde esse roteamento não ajuda
Uma lista maior não garante que uma tarefa vai terminar. Todos os CLIs podem estar indisponíveis; uma credencial pode falhar; e respostas diferentes podem exigir ajustes no prompt ou no processo. O roteamento dá opções de execução. Ele não substitui a revisão do diff nem a decisão humana de merge.
Também não é uma forma de compartilhar a mesma sessão entre CLIs. Cada adapter executa seu próprio processo e usa a configuração e autenticação daquele CLI. Se uma ferramenta específica for necessária para todos os papéis, deixe isso explícito na configuração, em vez de presumir que o fallback preservará esse requisito.
Perguntas frequentes
Preciso configurar os onze papéis?
O T25 reconhece onze papéis de pipeline. O exemplo mostra todos para deixar visível onde configurar cada um; comece com a configuração que o seu fluxo precisa e preserve as regras de validação do projeto.
Posso usar Claude Code, Codex e Cursor na mesma tarefa?
Sim, papéis diferentes podem ter listas diferentes e usar adapters distintos. Isso não quer dizer que os três sejam chamados em cada etapa.
O T25 fornece as credenciais dos provedores?
Não. Você instala e autentica os CLIs no ambiente de execução. Consulte a documentação de cada fornecedor para requisitos atuais de conta, plano e login.
Fallback significa tentar de novo após qualquer falha?
Não assuma isso. A configuração define a ordem dos candidatos; as condições de seleção e retry dependem do caminho de execução. Inspecione o adapter e o resultado registrado para diagnosticar um caso concreto.
O roteamento faz o merge automaticamente?
Não. O T25 pode levar o trabalho até a etapa correspondente, mas a revisão e o merge continuam sujeitos aos gates configurados e à ação humana.