Base: anatomia do loop|INEMA.CLUB-PRO

Aula 4 · 18 min

LOOP-R: as cinco letras e os nove agentes

Um agente que avalia o próprio trabalho tende a se aprovar. O LOOP-R, framework aberto do INEMA que dá nome a esta formação, resolve isso separando funções: nove agentes, cada um com o que lê, o que escreve, o que decide e o que nunca faz. As cinco letras dão a ordem do método. Aqui você vê o desenho; a parte de promover e voltar versões é do curso 5.

Começar a aula
Nove pequenas figuras de robô industrial com visor escuro em círculo sobre uma mesa técnica escura.

Nesta aula você vai

  1. 1Localizar, Operar, Observar, Propor, Reforçar
  2. 2Os nove agentes e o contrato de cada um
  3. 3Por que a separação impede o loop de se convencer
  4. 4Um ciclo real do exemplo, lido no ledger

Objetivo: explicar as letras L-O-O-P-R e o contrato dos nove agentes (lê, escreve, decide, nunca faz) e dizer por que quem faz não avalia.

01As cinco letras, na ordem do ciclo

Clique em cada letra: o que ela pede e quais agentes entram nela.

Role a página: cada etapa abaixo acende a sua parte do diagrama.

  1. 1/6

    L · Localizar

    Escolher um processo que se repete muito e escrever o objetivo com número: levar X a Y sem piorar Z. A ficha tem cinco respostas que nenhum sistema infere com segurança: objetivo com número, onde nasce a evidência, o que nunca muda sozinho, teto de custo e tempo, e quem aprova. É o objetivo da aula 1, com guarda-corpo.

  2. 2/6

    O · Operar

    O processo ganha uma versão atual, um roteiro curto seguido em toda execução, para que duas execuções sejam comparáveis. O Executor produz o artefato e registra uma linha. Não opina, não sugere, não muda o próprio prompt.

  3. 3/6

    O · Observar

    Uma linha por execução, sempre as mesmas colunas, resultado em sim ou não. O Observador transforma as linhas em evidência: contagens por versão e variante, sem adjetivo. Se os dados não batem com o esquema, ele para o ciclo.

  4. 4/6

    P · Propor

    O Crítico diz o que funcionou e o que falhou, com a força da evidência, sem propor solução. O Otimizador escreve hipóteses no formato SE, ENTÃO, PORQUE e MUDANÇA, sem repetir as descartadas. O Guardião veta o que toca no que nunca muda ou no teto; o veto é final e ele não negocia.

  5. 5/6

    R · Reforçar

    O Experimentador desenha o teste A contra B, com amostra mínima calculada antes. O Avaliador responde uma de três: B_GANHOU, A_SEGUE ou AMOSTRA_INSUFICIENTE. Não existe "está ganhando". A Memória registra tudo sem apagar, e o Meta-agente olha o sistema (custo, vetos) e só relata.

  6. 6/6

    Quem monta não é quem inspeciona

    Nove funções separadas, cada uma lendo só o que o contrato manda. É a separação, não um prompt mais esperto, que impede o loop de se convencer de que melhorou.

Letras como apresentadas na trilha 2 do vídeo do LOOP-R; contratos dos agentes em loop-r/docs/04-agentes.md e .claude/agents/.

02O contrato dos nove, numa tabela

Resumo de loop-r/docs/02-arquitetura.md, §4. Cada agente é um arquivo markdown em .claude/agents/.

Contratos (docs/02 §4)
| Agente         | Lê                                  | Escreve                    | Decide                  | Nunca faz                       |
|----------------|-------------------------------------|----------------------------|-------------------------|---------------------------------|
| Executor       | versoes/atual, entrada da tarefa    | artefato + linha no CSV    | nada                    | mudar o próprio prompt          |
| Observador     | CSV, esquema                        | evidencia.md               | nada                    | interpretar causa               |
| Crítico        | evidência, versão atual, memória    | critica.md                 | se há padrão com N      | propor solução                  |
| Otimizador     | crítica, memória (descartados!)     | hipoteses.md               | nada                    | repetir hipótese descartada     |
| Guardião       | hipóteses, yaml (guarda-corpos, teto)| veto/aprovação por hipótese| veto é final            | ser convencido                  |
| Experimentador | hipóteses aprovadas, amostra mínima | experimento.md             | desenho do teste        | rodar sem N calculado           |
| Avaliador      | resultados A/B, rubrica, calibração | veredito.md                | uma das 3 respostas     | "parece melhor"                 |
| Memória        | tudo do ciclo                       | ledger + 3 arquivos        | nada                    | apagar registro                 |
| Meta-agente    | manifestos de todos os ciclos       | relatorio-meta.md          | nada (v0.1/v1)          | alterar agentes                 |
Terminal · clonar e conferir os agentes
git clone https://github.com/inematds/loop-r ~/projetos/loop-r
cd ~/projetos/loop-r
ls .claude/agents/*.md | wc -l
grep -h '^description:' .claude/agents/*.md | cut -c1-110
Terminal · ler o exemplo (dados sintéticos)
cd ~/projetos/loop-r/exemplos/vendas-whatsapp
grep -c '^| 2026' memoria/ledger.md
grep -oE '\| (VETADA|EM TESTE|AGUARDANDO|DESCARTADA|PROMOVIDA v2) \|' memoria/ledger.md | sort | uniq -c
Exemplo do repositório
$ ls .claude/agents/*.md | wc -l
9

$ grep -c '^| 2026' memoria/ledger.md
8

$ grep -oE '...' memoria/ledger.md | sort | uniq -c
      2 | AGUARDANDO |
      1 | DESCARTADA |
      2 | EM TESTE |
      1 | PROMOVIDA v2 |
      2 | VETADA |

Quatro ciclos, oito linhas de decisão: duas hipóteses vetadas pelo Guardião antes de qualquer teste, uma descartada pelo Avaliador, uma promovida para a v2.

03Um descarte que ensina

Ciclo 0002 do exemplo: a métrica subiu e mesmo assim a versão nova não entrou.

1. A hipótese

Propostas com no máximo 80 palavras. Passou pelo Guardião e foi a teste, A contra B, 300 execuções de cada lado.

04Vídeo: as cinco letras do método

Trilha 2 do LOOP-R em vídeo. Feita para gestores, com exemplos de negócio; o método é o mesmo que um loop de engenharia usa.

LOOP-R, trilha 2: as cinco letras · 17 minPágina do vídeo com roteiro →

05Prática

Na sua máquina. Só leitura no repositório do LOOP-R.

E1 · Os nove contratos

15 min

Clone o loop-r e abra três agentes: executor.md, guardiao.md e avaliador.md. Para cada um, anote em agentes.md a linha "nunca" do arquivo.

Pronto quando: ls ~/projetos/loop-r/.claude/agents/*.md | wc -l → 9, e grep -ci nunca agentes.md → 3 ou mais.

E2 · Ler um ciclo pelo ledger

15 min

No exemplo vendas-whatsapp, leia o ledger e o veredito do ciclo 0002. Escreva em uma frase por que a hipótese foi descartada mesmo subindo a taxa de resposta.

Pronto quando: grep -c '^| 2026' memoria/ledger.md → 8, e a sua frase cita o guarda-corpo (reclamações) e a tolerância.

E3 · Separar quem faz de quem avalia

10 min

Pense num loop seu (código, conteúdo, atendimento). Escreva em agentes.md duas linhas, uma começando por executa: e outra por avalia:, e diga o que o avaliador lê que o executor não escreve.

Pronto quando: grep -cE '^(executa|avalia):' agentes.md → 2, e a linha "avalia:" aponta uma fonte que o executor não controla (teste, planilha, rubrica).

06Teste da aula

Pergunta 1 de 4

Por que o LOOP-R usa nove agentes em vez de um agente que faz e confere?competência

07Em três frases

Cinco letrasLocalizar o processo e o número, Operar sempre igual, Observar em linhas, Propor com crítica e veto, Reforçar só com teste.
Nove contratosCada agente lê, escreve e decide só o que o contrato manda, e tem uma lista do que nunca faz.
Não-regressãoO LOOP-R não garante que o número sobe; garante que versão pior não substitui a atual por decisão do sistema.

Para ir além

LOOP-R no GitHub (framework, agentes, exemplo)Guia do LOOP-RLOOP-R em vídeo: 5 trilhas, PT/EN/ESCurso 5 da formação: o loop que aprende (promoção e rollback)
Aula anteriorPróxima aula