🧍 Solo loop
A forma mais simples: um agente, uma tarefa. Ele faz reason → act → observe e repete até "pronto". É a versão direta do esqueleto da Trilha 1: o mesmo "Think→Act→See", o mesmo "modelo + ferramentas em repeat". É a mais fácil de construir e de depurar — e cobre a maior parte do trabalho. Comece sempre por aqui.
Leia o diagrama: um único agente percorre os três beats e volta ao começo. Sem segundo agente, sem chefe — só o ciclo, repetindo. É a forma com menos peças para quebrar.
🧩 Por que começar no Solo
Menos peças = menos bugs. Você consegue ler o que o agente fez a cada volta e corrigir. Só suba para formas com mais agentes quando o Solo realmente não der conta — e o módulo 2.5 te diz quando isso acontece.
🔁 Maker → Checker
Aqui entram dois agentes: um maker faz o trabalho, e um checker separado dá nota. O checker é uma IA fresca, com a única função de avaliar — então ele não carimba o próprio trabalho. É o beat "observe/check" da Trilha 1, mas com um agente dedicado só para verificar.
O que ver: a seta de volta (tracejada) é o coração — enquanto o checker reprovar, o maker conserta. Só quando passa, encerra. Quem faz nunca é quem aprova.
💡 Quando vale o segundo agente
Use Maker→Checker quando a qualidade importa e um agente sozinho tende a se auto-aprovar cedo demais. Esse foi, aliás, o padrão que gerou este curso: um agente copiou cada frase das fontes, outro re-conferiu cada URL.
👔 Manager → Helpers
A terceira forma: um agente líder (manager) divide o objetivo em pedaços e entrega cada um a sub-agentes (helpers) que trabalham em paralelo. É o "um chefe, vários ajudantes" da Trilha 1. Serve quando o trabalho é grande demais para um agente só dar conta em sequência.
O que ver: as três formas em uma imagem. Repare no leque à direita: um líder no topo e os helpers se abrindo em paralelo embaixo. Mais agentes ao mesmo tempo = mais trabalho em menos tempo, mas mais coordenação para gerenciar.
O que ver: o leque (fan-out) é a marca dessa forma. O manager espalha as fatias e depois recolhe — paralelismo de verdade, ao preço de coordenar quem faz o quê.
🌙 "Roda sozinho" não é uma 4ª forma
Você vai ouvir falar de loop "que roda sozinho" (autônomo, sem supervisão) e pode achar que é uma quarta forma. Não é. "Roda sozinho" é qualquer uma das três acima deixada sem supervisão — por isso é a configuração que mais precisa de um STOP forte.
✓ Forma (são 3)
Quantos agentes e quem confere: Solo, Maker→Checker, Manager→Helpers. Essa é a escolha de arquitetura.
✗ "Roda sozinho" (não é forma)
É um modo de operação: a mesma forma, sem humano olhando. Pode ser Solo sozinho, Maker→Checker sozinho etc.
🛑 Por que isso pede STOP forte
Sem ninguém olhando, um loop que não para sozinho queima tokens (e dinheiro) a noite toda — ou faz algo irreversível. Quando for rodar sem supervisão, capriche na condição de parada: teto duro de voltas, limite de tempo, e um gate humano para ações perigosas. A Trilha 4 aprofunda isso.
🧭 Como escolher a forma
A regra é subir só quando precisa: comece no Solo; suba para Maker→Checker quando a qualidade importa; vá para Manager→Helpers quando o job é grande. Só suba um degrau quando um agente realmente não der conta — complexidade extra é custo, não troféu.
Solo
Default. Uma tarefa que um agente resolve repetindo o ciclo. Fique aqui o máximo que puder.
Maker → Checker
Suba quando o agente solo aprova cedo demais e a qualidade precisa de um juiz independente.
Manager → Helpers
Suba quando o job é grande demais para um fluxo sequencial e dá para paralelizar pedaços independentes.
| Forma | Agentes | Suba quando… | Custo |
|---|---|---|---|
| Solo | 1 | — (é o default) | baixo |
| Maker→Checker | 2 | qualidade importa | médio |
| Manager→Helpers | N | job grande / paralelizável | alto |
🧰 Exemplo de cada
Para fixar, um exemplo concreto de cada forma — e um prompt pronto para você rodar um Maker→Checker simples hoje.
🧍 Solo — conserto de teste
Um agente roda a suíte, conserta o que falha, roda de novo. Mesma tarefa, um agente, um ciclo.
🔁 Maker→Checker — gerar thumbnail
Um agente gera o thumbnail; um agente "scorer" dedicado pontua por uma rubrica até passar. Quem cria não se aprova.
👔 Manager→Helpers — auditar 45 fontes
A própria auditoria deste curso: um líder dividiu as 45 fontes entre vários pesquisadores em paralelo, depois juntou os achados.
▶ Copy-run: um Maker→Checker simples
Objetivo: fazer um agente gerar algo e um segundo agente avaliador dar nota, repetindo até PASS — sem o gerador se auto-aprovar.
# Cole no Claude Code — um loop maker→checker de uma tarefa só
# o trabalho (maker)
Gere um README curto para <este projeto>: o que é, como instalar, como rodar.
# o avaliador (checker) — papel SEPARADO, IA fresca
Depois de gerar, aja como um "agente avaliador" diferente: leia o README do zero,
sem suposições, e dê uma nota de 0 a 10 por esta rubrica:
- explica o que o projeto faz (0-4)
- instruções de instalação rodáveis (0-3)
- instruções de execução rodáveis (0-3)
# a regra de parada
Se a nota for < 9, liste o que faltou e reescreva o README. Repita.
Pare quando a nota for >= 9, ou após 5 rodadas — o que vier primeiro.Como verificar: você verá o agente alternar entre "gerei" e "avaliei: nota X, faltou Y", subindo a nota a cada volta. Confirme que ele só encerra ao bater 9 (ou nas 5 rodadas) — esse é o beat maker→checker rodando de verdade.
Por que o checker é um agente SEPARADO do maker?
🧾 Resumo do Módulo
Próximo:
2.3 — Definir e checar "pronto" (os 4 tipos de check)