Um agente sozinho faz uma coisa de cada vez e se perde em tarefa grande. Vários agentes sem combinado mexem no mesmo arquivo, ninguém confere e a sua cota vai embora. A ficha resolve isso antes de você digitar /swarm.
O Google lançou no Antigravity o comando /swarm: você descreve uma tarefa e um coordenador a divide entre vários agentes com nome, que trabalham ao mesmo tempo, enquanto um verificador revisa e testa. Isso só dá certo se as partes não se atropelarem. A Ficha do Enxame é uma folha curta que você escreve antes: quem é dono de quê, o que cada um não toca, quando está pronto, quem verifica e quando parar. Este guia explica o /swarm pela documentação oficial e traz um kit grátis que confere a sua ficha e monta o texto para colar. Precisa do plano Google AI Pro ou Ultra para o /swarm e de Python 3 para o kit.
Três vídeos vão entrar aqui: o básico (o que é e quando usar), o técnico (coordenador, quadro e verificador) e o da ficha (como escrever a especificação).
Tudo nesta seção vem da documentação oficial do Google Antigravity. O /swarm existe no app e na CLI, está em prévia e é dos planos Google AI Pro e Ultra.
A sua conversa vira o coordenador. Ele dá nome ao enxame, divide a tarefa em peças que não colidem (por exemplo, um worker por arquivo ou por pacote) e cria os workers com nome, como @parser e @docs, ou um grupo numerado, @fix-1 a @fix-4. Ele não faz o trabalho técnico: distribui, julga o que volta e fala com você.
Cada worker começa do zero, numa conversa própria. O brief dele vai para o quadro, à vista de todos, e diz três coisas: do que ele é dono, o que ele não pode tocar e como é o "pronto". É exatamente isso que a Ficha do Enxame faz você pensar antes.
O coordenador costuma pôr um @verifier para cada 2 a 4 workers. Ele lê as mudanças (os diffs), roda os testes e devolve os problemas para quem escreveu. Dá para pedir que ele rode num modelo diferente do dos workers.
Tarefas, perguntas, resumos e resultados de teste vão para um quadro de mensagens único, com menções @nome, @grupo ou @all. Workers não conversam em privado: a conversa toda fica num lugar, em ordem.
Worker sem nada para fazer dorme no quadro sem usar tokens e acorda quando alguém o menciona. O @monitor fica dormindo enquanto há progresso e só fala se todo mundo parar antes do fim.
Por padrão, todos usam a sua pasta do projeto. Quando vários editam ao mesmo tempo, o coordenador pode dar uma cópia de trabalho a cada um. Remover um worker apaga a cópia dele, por isso ele entrega as mudanças antes.
O enxame não é sempre a resposta. A tabela oficial separa quatro jeitos de pôr mais de um agente para trabalhar. O kit tem um ajudante que faz estas perguntas por você (como usar ↓).
| Serve para | Como começa | Tempo típico | Plano | |
|---|---|---|---|---|
| Subagente | Tarefa lateral e focada: pesquisar no código, conferir no navegador, rodar os testes | Delegação automática ou menção @subagent | Segundos a minutos | Todos |
| /boost | Problema difícil, não amplo: bug cabeludo, condição de corrida, algoritmo | /boost <tarefa> | Segundos a horas | Pagos |
| /swarm | Tarefa ampla que se divide limpo em arquivos, pacotes ou perguntas independentes | /swarm <tarefa> | Minutos a horas | Google AI Pro e Ultra |
| /teamwork | Projeto de vários marcos: migração do repositório inteiro, simulação, pesquisa longa; começa com entrevista e usa pasta própria | /teamwork <objetivo> | Horas a dias | Pagos |
Fonte: tabela "Choose between Swarm, Teamwork, Boost, and subagents" da documentação oficial. Para o dia a dia, a própria documentação recomenda falar direto com o agente padrão.
No app, o painel Swarm abre ao lado da conversa, pelo link "Open the Swarm UI" na resposta do coordenador. Na CLI, uma linha de status aparece embaixo do campo de digitação e o quadro abre em tela cheia.
alt+s board. Alt+X esconde a linha; um post novo traz de volta.imagem: documentação do Google Antigravity
/swarm board ou Alt+S. Três painéis: membros (working, waiting, killed), posts e a mensagem inteira. q fecha.imagem: documentação do Google Antigravity/agents lista os workers.Na CLI, comece com @ e o nome: @verifier também roda os testes de integração. A mensagem vai só para ele, não para o quadro. No app, abra a conversa dele pela aba Members.
A documentação pede para você dizer o que quer e como verificar, e deixa o coordenador dividir. A ficha vai um passo antes: você já chega com a divisão pensada, e o coordenador tem menos chance de pôr dois workers no mesmo arquivo. Exemplo: uma calculadora de ROI em uma página.
node --test tests/calculo.test.js.O kit confere essa ficha em 8 itens e dá nota de 0 a 8. Só com 7 ou 8 ele monta o texto para colar no /swarm; abaixo disso, mostra o que corrigir (como usar ↓).
Cada worker é um agente próprio. Pela nossa conta, três workers, um verificador e o monitor já são cinco agentes além do coordenador, não um.
A documentação avisa: um enxame gasta cota muito mais rápido que uma conversa. Está em prévia e só nos planos Google AI Pro e Ultra.
O membro que fica sem cota pausa e não fica tentando. Só volta com post novo no quadro, troca de modelo ou mensagem sua. Não reinicia sozinho quando a cota renova.
Worker removido não volta, e a cópia de trabalho dele é apagada. Peça ao coordenador para ele entregar as mudanças antes.
Relato de um usuário: a conta foi bloqueada em minutos quando outro agente disparou dezenas de sessões sem supervisão, em segundos; voltou depois de um recurso automático. Segundo o mesmo relato, uma resposta no fórum do Google disse que o uso automatizado é permitido e desconta da cota, mas laços de fundo sem supervisão, em alto volume, podem acionar a proteção antiabuso.
Você não precisa desta parte para entender o que está acima.
Python 3 com biblioteca padrão. Nada de instalar pacote, nada de chave de API: os scripts só leem arquivos de texto.
O modelo da ficha em Markdown: Tarefa, Como verificar, Peças (### @nome com dono, não mexe, pronto quando), Verificador, Limites e, se quiser, Modelo dos workers.
Confere 8 itens, dá nota 0–8 com o motivo e como corrigir. --prompt monta o texto para colar (só com nota 7 ou mais), --en em inglês, --json para outro programa. Sai com 0 se a nota for 7 ou mais.
Subagente, /boost, /swarm ou /teamwork, pela tabela oficial; se nenhum servir, responde "o agente padrão, numa conversa normal". Por flags (--divide-limpo sim, --dificil, --dias, --lateral) ou por perguntas no terminal.
🧠 você · ⚙️ script do kit · 🤖 o /swarm no Antigravity
Tarefa · comando de verificação · 2+ peças · todo mundo com dono · donos sem sobreposição · não mexe e pronto quando · verificador · limites sem laço.
Mesmo arquivo, pasta que contém arquivo de outra peça e glob simples (padrão com * que pega vários arquivos, como src/*.js). Caminhos sempre entre crases; dono sem crase é pergunta (investigação).
Falta de - roda: reprova. Proporção (1 para 2–4 peças) e modelo igual ao dos workers só avisam.
Reprova "rodar a noite toda sem supervisão", "em laço", "dezenas de sessões". A negação ("nada de laço") passa.
Para o kit, só Python 3. Para usar o /swarm, o Antigravity (app ou CLI) num plano Google AI Pro ou Ultra.
Qualquer versão recente. Confira:
python3 --versionBaixe o repositório:
git clone https://github.com/inematds/enxame-antigravity cd enxame-antigravity
As saídas abaixo são reais, do checar.py e do escolher.py rodando nos exemplos do kit. Não são saídas do /swarm.
Sem flags, o script faz 4 perguntas. Com flags, responde direto.
python3 escolher.py --divide-limpo sim Use: /swarm <tarefa> Por quê: Tarefa ampla que se divide limpo em arquivos, pacotes ou perguntas independentes: workers com nome trabalham ao mesmo tempo e um @verifier revisa os diffs e roda os testes, tudo num quadro único. Plano exigido: Google AI Pro e Google AI Ultra (em prévia; gasta cota muito mais rápido que uma conversa) · horizonte típico: minutos a horas (tabela oficial: https://antigravity.google/docs/swarm) Próximo passo: Antes de digitar, escreva a Ficha do Enxame: cp modelos/FICHA.md minha-ficha.md && python3 checar.py minha-ficha.md
Arquivos e pastas sempre entre crases. Para investigação, o dono pode ser uma pergunta: - dono: pergunta: quais módulos custam mais tempo? O modelo vazio tira 1/8 no conferidor: é normal, ele só passa depois de preenchido.
cp modelos/FICHA.md minha-ficha.md
Saída real no exemplo da calculadora de ROI:
python3 checar.py exemplos/calculadora-roi/ficha.md Ficha do Enxame: exemplos/calculadora-roi/ficha.md ✔ 1. Tarefa escrita — tarefa: Criar uma página HTML única de calculadora de ROI: a pessoa digita tráfego mensal, taxa de… ✔ 2. Como verificar tem um comando — comando: node --test tests/calculo.test.js ✔ 3. Pelo menos 2 peças — 3 peça(s): @layout, @entradas, @calculo ✔ 4. Toda peça tem dono — todas têm dono ✔ 5. Donos não se sobrepõem — nenhum arquivo com dois donos ✔ 6. Toda peça diz o que não mexe e quando está pronta — todas completas ✔ 7. Verificador definido — 1 verificador(es) para 3 peça(s); roda: node --test tests/calculo.test.js ✔ 8. Limites de cota e de parada, sem laço sem supervisão — cota e parada definidas; nenhum laço sem supervisão Nota: 8/8 — pronta para o /swarm
E no exemplo ruim (trecho), com o motivo e como corrigir:
python3 checar.py exemplos/ruim.md ✘ 5. Donos não se sobrepõem — colisão: @design `site/` × @textos `site/index.html` → como corrigir: Dê cada arquivo a uma peça só. Se duas precisam do mesmo arquivo, quebre o arquivo em partes, junte as duas peças numa só, ou peça cópias de trabalho (working copy) para cada worker. ✘ 7. Verificador definido — sem seção '## Verificador' ✘ 8. Limites de cota e de parada, sem laço sem supervisão — falta limite de cota; falta quando parar; pede laço sem supervisão: - deixar o /swarm rodando a noite toda sem supervisão até ficar perfeito Nota: 2/8 — ainda não: corrija os ✘ antes do /swarm
Uma linha só, que já começa com /swarm. Só sai com nota 7 ou 8; abaixo disso, o script mostra o que corrigir e sai com código 1. Com --en, o esqueleto sai em inglês ("Give each piece its own worker", "Add 1 verifier…"), mas a tarefa e os donos continuam como você escreveu, em português. Saída real (trecho):
python3 checar.py exemplos/calculadora-roi/ficha.md --prompt /swarm Criar uma página HTML única de calculadora de ROI: a pessoa digita tráfego mensal, taxa de conversão (%), ticket médio e aumento estimado (%), e a página mostra o ganho estimado por mês, com ganho = tráfego × (aumento/100) × (conversão/100) × ticket. Dê a cada peça o seu próprio worker. Peças: @layout é dono de index.html, estilo.css; não mexe em entradas.js, calculo.js, tests/; pronto quando … | @entradas é dono de entradas.js; … | @calculo é dono de calculo.js, tests/calculo.test.js; … Adicione 1 verificador num modelo diferente do dos workers. Verificador: lê os 3 diffs, confere que ninguém editou arquivo de outra peça e roda node --test tests/calculo.test.js. Para verificar, rode node --test tests/calculo.test.js. Limites: …
A linha já começa com /swarm: cole a linha inteira na conversa, sem digitar /swarm antes. A documentação mostra o comando sendo digitado e completado com Tab; se o comando colado não for reconhecido, digite /swarm, aperte Tab e cole só o resto do texto. No app, abra o painel pelo link "Open the Swarm UI". Na CLI, rode /swarm board ou Alt+S. Quando o coordenador reportar, rode você mesmo o comando de "Como verificar" e peça para remover os workers que terminaram.
/swarm board # na CLI do Antigravity: abre o quadro ao vivo
36 testes com unittest: os 4 exemplos tiram 8, o ruim sai com código 1 (inclusive no --prompt), os prompt.txt batem com o que o script gera.
python3 -m unittest -v Ran 36 tests … OK
Cada pasta tem a ficha.md, o prompt.txt e o prompt.en.txt gerados pelo checar.py. As saídas reais de todas estão em exemplos/saidas.txt.
Página única de calculadora com 4 entradas (tráfego, conversão, ticket médio, aumento estimado): @layout, @entradas e @calculo, cada um com os seus arquivos, e 1 verificador rodando o teste do cálculo.
Seis peças (cabeçalho, benefícios, formulário, depoimentos, FAQ e montagem com os botões), cada seção num arquivo, cópia de trabalho para a montagem e 2 verificadores.
Três investigadores só leitura (importações, configuração, plugins), donos de perguntas, e um verificador que repete as medições e ordena as correções.
Um worker por pacote quebrado, sem apagar nem afrouxar assert, e um verificador que compara os diffs e roda a suíte inteira.
Os exemplos investigação lenta e testes por pacote se inspiram em exemplos da documentação oficial; as fichas, com verificador e limites, são do kit.
O kit segue a documentação; quando ela mudar, ele muda.
A Ficha do Enxame, o conferidor e os exemplos estão grátis no inema.club, direto na internet.
INEMA.CLUB