# Sua primeira squad: crie, rode e aceite um time de agentes

> Uma squad no Tallos é um agente líder que divide seu objetivo entre agentes membros, supervisiona o trabalho e traz o resultado para você aprovar. Para rodar a primeira, abra Squads, descreva o objetivo, escolha um modelo como Construir + revisar, defina líder e membros e clique em Iniciar squad. O líder só te interrompe para perguntas, e nada entra até você clicar em Aceitar.

- Canonical: https://runtallos.com/pt/aprenda/seu-primeiro-squad
- English: https://runtallos.com/learn/your-first-squad.md
- Atualizado em: 2026-09-29
- Section: Aprenda

## Em resumo

- 4 modelos: Construir + revisar, 3 tentativas, Líder divide, Personalizado
- Padrão: 5 rodadas, 4 membros ao mesmo tempo (máx. 20 e 12)
- Agente, modelo e esforço por membro
- Revisão final: Aceitar ou Descartar, resultados por worktree

## 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](https://runtallos.com/pt/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](https://runtallos.com/pt/recursos/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](https://runtallos.com/pt/aprenda/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](https://runtallos.com/pt/aprenda/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. → https://runtallos.com/signup

## 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](https://runtallos.com/pt/squads/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](https://runtallos.com/pt/squads/melhor-de-tres) |
| 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](https://runtallos.com/pt/squads/entregar-uma-feature) |
| Personalizado | Você define cada membro e sua função | Seu próprio fluxo, depois de conhecer os outros |

_Os quatro modelos de squad no Tallos_

## 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.

> **Nada entra até você decidir** — Mesmo quando o membro revisor aprova e o líder recomenda um resultado, a squad para na revisão final. Leia o diff com o [checklist de revisão de código de IA](https://runtallos.com/pt/aprenda/revisar-codigo-gerado-por-ia) antes de aceitar.

## 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](https://runtallos.com/pt/recursos/automacoes): 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](https://runtallos.com/pt/squads/manutencao-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.

---

**Rode seus agentes em paralelo com o Tallos** — Claude Code, Codex, Gemini e mais de 30 agentes — cada um no seu workspace, com squads, chat, terminais e revisão num só app. Usa as assinaturas que você já tem.

https://runtallos.com/signup (macOS 13+ · Windows 10+)