O que é uma squad no Tallos?
Uma squad é um time de agentes de código com um líder. O líder é um agente que planeja o trabalho, distribui as tarefas, confere os resultados e reporta a você. Os membros são agentes que executam, cada um seguindo uma função que você escreve com suas palavras, como "escreve os testes" ou "revisa segurança".
As squads usam a mesma base dos workspaces paralelos: cada membro trabalha no próprio worktree do git, então nenhum membro edita os mesmos arquivos ao mesmo tempo que outro. A diferença é quem coordena. Com agentes em paralelo, é você. Com uma squad, é o líder, e você entra só para responder perguntas e decidir no final.
Como uma squad roda, passo a passo?
Uma squad roda em rodadas. Cada rodada é planejar, distribuir e revisar. Abra Squads na barra lateral e siga:
- 1
Descreva o objetivo
Escreva o resultado que você quer em palavras simples e escolha o projeto. Se quiser, cole um link de tarefa do GitHub, GitLab, Linear ou Jira; o líder usa esse link como tarefa de origem.
- 2
Escolha um template
Defina como a squad deve trabalhar. O template só preenche o time e as instruções do líder; dá para editar tudo antes de começar.
- 3
Monte o time
Escolha agente, modelo e esforço do líder e, para cada membro, agente, modelo, esforço, função e "Quantos" podem rodar ao mesmo tempo.
- 4
Inicie a squad
O Tallos mostra um resumo do plano e inicia o líder em um workspace novo e separado. Os membros ganham worktrees filhos próprios.
- 5
Acompanhe ou vá fazer outra coisa
A página da execução mostra o status de cada membro (Trabalhando, Precisa de você, Concluído, Falhou, Travado) e contadores de rodadas, membros iniciados, concluídos e que falharam. Abra o terminal de qualquer membro para olhar de perto, ou pare a squad quando quiser.
- 6
Revise e decida
Quando o líder reporta, leia o relatório final, abra as alterações de cada worktree e aceite ou descarte.
Qual template de squad devo escolher?
Escolha o template que combina com o formato do trabalho. O Tallos vem com quatro:
| Template | Como funciona | Melhor para |
|---|---|---|
| Construir + revisar | Um agente faz o trabalho, outro revisa. Eles vão e voltam até o revisor aprovar. | Refatorações, migrações, mudanças arriscadas |
| 3 tentativas, escolhe a melhor | Três agentes tentam o mesmo objetivo separadamente, cada um no próprio worktree. O líder compara os resultados e recomenda um, explicando o porquê. | Performance, bugs difíceis, design em aberto |
| Líder divide o trabalho | O líder divide o objetivo em partes independentes, entrega cada parte a um membro, confere cada resultado e junta tudo. | Features, varreduras de testes, mudanças grandes |
| Personalizado | Comece do zero: escolha cada membro e descreva o que ele deve fazer. | O seu próprio processo |
Cada template tem um caso de uso detalhado: construir e revisar, melhor de três e entregar uma feature de ponta a ponta.
Como configuro o líder e os membros?
Toda posição do time é configurada do mesmo jeito, então você casa cada função com o agente e o modelo em que confia para ela.
- Agente: qualquer CLI de agente instalada e ativa. O Tallos avisa antes de iniciar se algum agente escolhido não está instalado ou está desativado.
- Modelo: escolha na lista do agente, digite o id de um modelo ou deixe o modelo padrão do agente.
- Esforço: o nível de raciocínio do modelo, quando o agente oferece essa opção.
- Função: o que o membro faz. O líder precisa respeitá-la e nunca passa a um membro trabalho fora da função dele.
- Quantos: quantas cópias desse membro o líder pode rodar em paralelo, por exemplo quatro membros escrevendo testes.
- Instruções do líder (opcional): como o líder deve conduzir a squad. Os templates já preenchem.
Os agentes disponíveis vêm das conexões de agentes, onde o Tallos instala cada CLI e faz login com a assinatura ou a chave de API que você já tem.
Como os limites mantêm a squad sob controle?
Dois limites valem para toda execução: quantas rodadas o líder pode fazer e quantos membros podem trabalhar ao mesmo tempo.
| Limite | Padrão | Máximo |
|---|---|---|
| Máximo de rodadas (planejar, distribuir, revisar) | 5 | 20 |
| Máximo de membros ao mesmo tempo | 4 | 12 |
Quando a squad para para me perguntar algo?
A squad só pergunta quando o líder realmente trava. O líder chama tallos squad ask com uma pergunta e, se quiser, algumas opções. A execução passa para Precisa da sua resposta e a pergunta aparece em Perguntas do líder.
Escolha uma opção ou escreva sua própria resposta e envie. O líder espera a resposta e continua dali. As perguntas respondidas ficam listadas na execução, para você lembrar o que decidiu e quando.
Pronto para rodar sua primeira squad?
O caminho mais rápido é o guia passo a passo: sua primeira squad mostra uma execução Construir + revisar em um repositório real.
Baixe o Tallos e monte sua primeira squad.
O que acontece quando a squad termina?
Quando o trabalho acaba, o líder escreve um relatório final com tallos squad report: o que foi feito, qual resultado recomenda e onde ele está, e os riscos que você deve conferir. A execução passa para Pronto para sua revisão. Nada é mesclado até você decidir.
- Relatório final: o resumo do líder, exibido na página da execução.
- Resultados por worktree: uma linha por worktree que a squad gerou, com a tarefa do membro e o botão Ver alterações.
- Recomendado: o resultado que o líder escolheu, marcado para você revisar primeiro.
- Abrir para criar PR: abre aquele worktree para você fazer commit, push e abrir o pull request.
- Aceitar: marca a execução como aceita. Depois você abre as alterações de um worktree para criar o PR ou mesclar.
- Descartar: marca a execução como descartada. Os worktrees são mantidos, a menos que você escolha excluir também os worktrees dos membros.
O líder é instruído a nunca mesclar, fazer push nem mexer na sua branch base.
Posso salvar, reutilizar e agendar uma squad?
Sim. Clique em Salvar como squad no formulário e o time, o template, as instruções e os limites viram uma squad salva.
| Onde | O que dá para fazer |
|---|---|
| Squads salvas | Usar (preenche o formulário), Renomear, Duplicar, Excluir, Agendar. Excluir mantém as execuções passadas; só a definição salva sai. |
| Agendamentos | A cada hora, todo dia, dias úteis ou toda semana, no horário que você escolher. O agendamento vira uma automação e cada execução começa em um workspace novo. |
| Em execução e histórico | Execuções ativas primeiro, depois as anteriores filtradas por status, cada uma com rodadas, membros iniciados, concluídos e que falharam, e custo estimado quando o preço do modelo é conhecido. |
Uma squad agendada combina com tarefas de rotina, como o caso de manutenção agendada: atualização de dependências com revisor, esperando por você toda manhã.
Qual a diferença entre uma squad e rodar agentes em paralelo?
Agentes em paralelo
- Você abre cada workspace e inicia cada agente
- Você divide a tarefa e escreve cada prompt
- Você confere cada resultado e devolve as correções
- Melhor quando as tarefas já são independentes
Uma squad
- O líder inicia os membros em worktrees próprios
- O líder divide o objetivo pela função de cada membro
- O líder revisa e repete, dentro dos seus limites
- Melhor quando o trabalho precisa de plano e conferência
As duas formas convivem no Tallos. Para a abordagem manual e quando ela vale mais, leia desenvolvimento multiagente.
Perguntas frequentes
O líder e os membros podem usar agentes e modelos diferentes?
Sim. O líder e cada membro escolhem agente, modelo e esforço próprios, então uma squad pode misturar Claude Code, Codex, Gemini CLI, OpenCode e outras CLIs que você tenha instaladas.
Quantos agentes uma squad roda ao mesmo tempo?
Por padrão, até 4 membros ao mesmo tempo e até 5 rodadas. Dá para subir para 12 membros simultâneos e 20 rodadas.
A squad mescla código na minha branch principal?
Não. Cada membro trabalha no próprio worktree e o líder é instruído a nunca mesclar nem fazer push. Você aceita ou descarta no final e depois abre um worktree para criar o PR ou mesclar por conta própria.
O que acontece com o trabalho se eu parar a squad?
O líder e os membros param. As alterações já feitas continuam nos worktrees, então você ainda pode revisá-las.
Uma squad pode começar a partir de um ticket do GitHub, Linear ou Jira?
Sim. Cole um link do GitHub, GitLab, Linear ou Jira no campo de link da tarefa e o líder usa esse ticket como tarefa de origem do objetivo.
Dá para rodar a mesma squad todo dia?
Sim. Salve a squad e escolha Agendar: a cada hora, todo dia, dias úteis ou toda semana, em um horário definido. Cada execução agendada começa em um workspace novo.
Preciso de uma nova assinatura de IA para usar squads?
Não. As squads rodam as CLIs de agentes que você já tem, logadas com suas próprias assinaturas ou chaves de API. O Tallos não revende acesso a modelos.
