O que é uma squad no Tallos?
Uma squad é um time de agentes de IA para programação com um líder e um ou mais membros. O líder planeja o trabalho, distribui as tarefas, confere os resultados e reporta a você. Ele não implementa nada sozinho. Os membros fazem o trabalho, cada um no seu worktree, com o agente, o modelo e o esforço que você escolher. É desenvolvimento multiagente com um supervisor que não precisa ser você.
O líder trabalha em rodadas (planejar, distribuir, conferir) até cumprir o objetivo ou chegar ao limite de rodadas. Ele faz perguntas pelo Tallos quando precisa de uma decisão e para no final com um relatório. Você revisa as mudanças e clica em Aceitar ou Descartar. Veja a página de squads para o quadro completo.
O que eu preciso antes de criar minha primeira squad?
- Tallos com pelo menos um agente conectado. Uma squad pode usar o mesmo agente em todos os papéis; dois agentes diferentes deixam a revisão mais útil. Veja conectar seus agentes.
- Um projeto adicionado ao Tallos, com a branch base limpa.
- Uma tarefa solo concluída. Se você ainda não rodou o ciclo básico, faça antes o guia da primeira tarefa; as squads partem dele.
- Um objetivo pequeno e bem definido. Uma feature com critério de pronto claro, um bug com reprodução ou uma lacuna de cobertura de testes.
Como criar e rodar minha primeira squad, passo a passo?
- 1
Abra Squads
Clique em Squads na barra lateral. A página tem três partes: Nova squad, Em execução e histórico e Squads salvas.
- 2
Escreva o objetivo e escolha o projeto
Em O que a squad deve fazer?, descreva o resultado com palavras simples, por exemplo “Adicionar um alternador de modo escuro na página de configurações”. Escolha o Projeto. Se quiser, dê um nome à squad e cole um Link da tarefa do GitHub, GitLab, Linear ou Jira para o líder receber o contexto do ticket.
- 3
Escolha como a squad deve trabalhar
Escolha um modelo em Como a squad deve trabalhar? Na primeira vez, Construir + revisar é o mais fácil de acompanhar: um membro constrói, outro revisa, e eles vão e voltam até o revisor aprovar. Os modelos só preenchem o formulário; dá para editar tudo.
- 4
Defina o líder
Escolha agente, modelo e esforço do líder. Modelo padrão do agente usa o que estiver configurado naquele agente. Adicione Instruções do líder se quiser orientar como ele conduz a squad.
- 5
Defina os membros
Para cada membro, descreva a função (“escreve os testes”) e escolha agente, modelo, esforço e Quantos cópias. Misturar agentes funciona bem: por exemplo, o Claude Code constrói e o Codex revisa. Use Adicionar membro para mais papéis.
- 6
Confira os limites e o plano
Máximo de rodadas começa em 5 e Máximo de membros ao mesmo tempo em 4 (até 20 e 12). Leia o resumo do plano abaixo do formulário: ele diz quem lidera, quantos membros trabalham ao mesmo tempo e que tudo acontece num workspace novo e separado.
- 7
Inicie a squad
Clique em Iniciar squad. Clique antes em Salvar como squad se quiser reutilizar esse time. A execução abre com o líder planejando.
- 8
Acompanhe e responda ao líder
A execução mostra o status de cada membro (trabalhando, precisa de você, concluído, falhou, travado) e o progresso: rodadas, tarefas iniciadas, concluídas e com falha, e um custo estimado quando disponível. Quando aparecer O líder precisa da sua resposta, escolha uma opção ou escreva a sua. Parar squad interrompe todos; o que já foi feito fica nos worktrees.
- 9
Revise e depois aceite ou descarte
Quando o status mudar para pronto para revisão, leia o Relatório final e os Resultados por worktree. O líder pode marcar um resultado como Recomendado. Abra as alterações de cada worktree para ler o diff e depois clique em Aceitar ou Descartar.
- 10
Entregue o trabalho aceito
Depois de aceitar, clique em Abrir para criar PR no worktree que você quer entregar, revise o diff mais uma vez e abra o pull request, ou faça o merge você mesmo.
Rode sua primeira squad num ticket de verdade. Baixe o Tallos.
Com qual modelo de squad eu começo?
Comece com Construir + revisar na maioria das tarefas, 3 tentativas, escolhe a melhor quando você não sabe bem como resolver algo, e Líder divide o trabalho quando o objetivo se quebra em partes independentes. Personalizado começa com a equipe em branco.
| Modelo | Como funciona | Bom primeiro uso |
|---|---|---|
| Construir + revisar | Um agente constrói, outro revisa; eles iteram até o revisor aprovar | Uma feature pequena ou correção de bug. Veja construir e revisar |
| 3 tentativas, escolhe a melhor | Três agentes tentam o mesmo objetivo em worktrees separados; o líder compara e recomenda um | Uma correção difícil com várias abordagens possíveis. Veja melhor de três |
| Líder divide o trabalho | O líder divide o objetivo em partes, entrega cada uma a um membro e junta os resultados | Uma feature com partes separadas de API, interface e testes. Veja entregar uma feature |
| Personalizado | Você define cada membro e sua função | Seu próprio fluxo, depois de conhecer os outros |
O que acontece quando aceito ou descarto o resultado de uma squad?
Aceitar marca a execução como aceita; as mudanças continuam nos worktrees e você abre um deles para criar um pull request ou fazer o merge. Nada entra automaticamente. Descartar marca a execução como descartada e mantém os worktrees, a menos que você marque a opção de também excluir os worktrees dos membros, o que apaga as alterações não commitadas deles.
Como salvo, reutilizo e agendo uma squad?
Clique em Salvar como squad no formulário para guardar o time. As squads salvas mostram líder, membros e limites, e oferecem Usar (preenche o formulário), Renomear, Duplicar, Agendar e Excluir. Excluir uma squad salva mantém as execuções passadas.
Agendar roda a squad de forma recorrente, como uma automação: a cada hora, todo dia, em dias úteis, toda semana ou num horário personalizado, com projeto e objetivo para cada execução. Toda execução concluída aparece em Em execução e histórico com status, rodadas e contagem de membros. Uma manutenção noturna combina bem; veja manutenção agendada.
Solução de problemas: por que minha squad não inicia ou não termina?
- “Um dos agentes escolhidos não está instalado ou está desativado.” Instale ou entre nesse agente em Configurações → Conexões, ou escolha outro.
- “Descreva a função de cada membro.” Cada membro precisa de uma função descrita; o líder nunca atribui trabalho fora dela.
- Os membros esperam em vez de começar. O líder bateu no Máximo de membros ao mesmo tempo e espera um terminar. Aumente o limite (até 12) se sua máquina e seu plano aguentarem.
- A execução parou antes de terminar. O limite de rodadas foi atingido. O líder reporta o que tem; aumente o Máximo de rodadas (até 20) ou estreite o objetivo.
- A squad não conseguiu terminar. Abra o terminal do líder para ver o que aconteceu. O que já foi feito fica nos worktrees.
Perguntas frequentes
O líder e os membros podem usar agentes de IA diferentes?
Sim. Cada papel tem seu agente, modelo e esforço, então o Claude Code pode liderar enquanto o Codex e o Gemini CLI trabalham como membros.
Quantos agentes uma squad roda ao mesmo tempo?
Por padrão, 4 membros ao mesmo tempo, e dá para subir até 12. O limite de rodadas começa em 5 e vai até 20.
A squad faz merge do código sozinha?
Não. A squad para numa revisão final, e mesmo depois de Aceitar você abre um worktree para criar o pull request ou fazer o merge.
Como o líder me faz perguntas?
O líder chama tallos squad ask no terminal dele, e a pergunta aparece no painel da execução. Você escolhe uma opção ou escreve sua resposta.
Posso ligar uma squad a uma issue do GitHub ou a um ticket do Jira?
Pode. Cole um link do GitHub, GitLab, Linear ou Jira em Link da tarefa e o líder recebe o ticket como tarefa de origem.
Dá para rodar uma squad em horário agendado?
Dá. Salve a squad e use Agendar para rodar a cada hora, todo dia, em dias úteis, toda semana ou num horário personalizado.
O que significa o custo estimado numa execução de squad?
Quando aparece, é uma estimativa calculada a partir do uso registrado na execução, não uma cobrança. O gasto real é cobrado pelo fabricante de cada agente, na sua assinatura ou chave de API.
