Como eu estruturo os meus Squads de IA

196 agentes em 13 squads, usados por 5 pessoas todo dia. O que é agente, o que é squad, o exemplo mínimo de um squad de webdesign e o prompt que monta o seu primeiro dentro do Claude Code.

Aqui dentro rodam 196 agentes de IA organizados em 13 squads, usados por 5 pessoas ao mesmo tempo, todo dia. Esse número impressiona quem vê de fora. E ele é a parte menos importante do sistema.

Os nomes certos, primeiro

Agente é uma IA com UM papel. Missão própria, contexto próprio, checklist próprio. Não é "a IA": é a IA com crachá. Um agente de copy só escreve copy, e antes de escrever carrega a voz do especialista e a régua de qualidade dele.

Squad é um time de agentes rodando um processo inteiro, na ordem, um passando o bastão pro outro. Um levanta o briefing. Outro escreve. Outro monta. Outro revisa. Squad são vários agentes na sequência certa, cobrindo o processo do início até a entrega.

A régua: o squad espelha o SEU processo

O erro de quem está começando é copiar o squad dos outros. Squad não nasce de template. Nasce do processo que você repete toda semana: você mapeia como já faz hoje, etapa por etapa, e cada etapa vira um agente. O squad é o espelho do seu processo, não o contrário.

E um squad nasce quando uma função se repete toda semana. Não antes. Squad criado por empolgação vira pasta morta.

Exemplo: o mínimo de um squad de webdesign

Uma página sai do briefing e chega pronta sem eu empurrar cada etapa. Pra isso, o mínimo são quatro agentes:

• Estrategista: recebe o briefing e define objetivo, público e promessa da página
• Copy: recebe a estratégia e escreve as seções no tom da marca
• Builder: recebe a copy e monta o HTML usando o design system
• QA: recebe a página e confere o checklist inteiro antes de chegar em mim

O QA é o que separa brinquedo de sistema. Pega tudo que você confere antes de aprovar uma entrega e transforma em checklist dentro do squad. A partir daí a IA se cobra sozinha, antes de você ver. Qualidade é papel do squad, não uma etapa depois dele.

A ordem de leitura decide tudo

Todo agente daqui lê contexto na mesma ordem, sempre. Primeiro o global: quem somos, como trabalhamos, o que nunca fazemos. Depois o do cliente: voz, público, produtos. Por último o da ação: a campanha específica, oferta, datas.

Bônus: o que é uma skill (e onde ela entra)

Skill é o manual que o agente consulta pra executar do seu jeito: um procedimento que você escreve uma vez e qualquer agente usa. No squad de webdesign, o Builder e o QA podem usar a mesma skill de "checklist de página". O agente é quem faz. A skill é como faz. O squad é o time inteiro.

É por isso que skill boa vale mais que agente novo: ela melhora todos os agentes que a usam de uma vez só.

O prompt que monta o seu primeiro squad

Abre o Claude Code, cola o prompt abaixo inteiro e responde as perguntas. Ele te entrevista sobre o seu processo e constrói o squad em cima das suas respostas, não de um template.

Quero construir meu primeiro squad de agentes dentro do Claude Code, baseado num processo real meu. Siga exatamente estas etapas, sem pular nenhuma:

ETAPA 1: ENTREVISTA (antes de criar qualquer coisa)
Me faça estas perguntas, uma de cada vez, e espere cada resposta:
1. Qual processo do meu trabalho eu repito toda semana e me toma mais tempo?
2. Quais são as etapas desse processo, na ordem, do início até a entrega?
3. O que precisa existir antes de começar (briefing, material, referência)?
4. Como eu sei que a entrega ficou boa? O que eu confiro antes de aprovar?
5. Que erros já aconteceram nesse processo que eu nunca quero repetir?
6. Que materiais meus você precisa conhecer pra fazer isso do meu jeito
   (exemplos prontos que eu aprovo, tom de voz, padrões da marca)?

ETAPA 2: DESENHO DO SQUAD
Com as minhas respostas, desenhe o squad espelhando o MEU processo, sem
inventar etapas que eu não descrevi:
- Um agente por papel do processo (mínimo 3, máximo 5 neste primeiro squad)
- Para cada agente: nome, missão em 1 frase, o que ele recebe, o que ele
  entrega e o checklist de qualidade dele (construído a partir da minha
  resposta 4 e dos erros da resposta 5)
- A ordem de passagem de bastão entre os agentes
Me apresente esse desenho e espere a minha aprovação antes de criar arquivos.

ETAPA 3: CONSTRUÇÃO (só depois da minha aprovação)
- Crie a pasta squads/nome-do-squad/ com um README.md explicando o fluxo
  em linguagem simples
- Crie um arquivo .md por agente contendo: missão, contexto que ele deve
  carregar, ordem de leitura desse contexto (do geral para o específico),
  o que recebe, o que entrega, checklist de saída e exemplos de bom e ruim
  usando as minhas respostas da entrevista
- Crie um arquivo orquestrador.md que define a ordem dos agentes, o que
  passa de um para o outro e em que situações o squad deve parar e me
  perguntar em vez de decidir sozinho
- Regra fixa em todos os agentes: nunca inventar dado ou informação; na
  dúvida, perguntar

ETAPA 4: TESTE REAL
Me peça uma tarefa real do meu trabalho e rode o squad nela, agente por
agente, me mostrando cada passagem de bastão. No final, aponte onde o
resultado divergiu do meu padrão e atualize os arquivos dos agentes com
esse aprendizado.

Regra geral: o squad é um espelho do meu processo. Se em algum momento
você precisar criar uma etapa que eu não descrevi, pare e me pergunte
primeiro.

Por onde começar

• Não comece com 196 agentes. Comece com um squad de uma função que você repete toda semana
• Escreva a função dele em uma frase. Se precisar de duas frases, são dois squads
• Defina a ordem de leitura antes de escrever qualquer agente: global, depois cliente, depois campanha
• Coloque a régua de qualidade dentro do squad desde o primeiro dia
• O segundo squad só nasce quando o primeiro estiver rodando sem você empurrar