Base: anatomía del loop|INEMA.CLUB-PRO

Clase 4 · 18 min

LOOP-R: las cinco letras y los nueve agentes

Un agente que evalúa su propio trabajo tiende a aprobarse. El LOOP-R, framework abierto de INEMA que da nombre a esta formación, resuelve eso separando funciones: nueve agentes, cada uno con lo que lee, lo que escribe, lo que decide y lo que nunca hace. Las cinco letras dan el orden del método. Aquí ves el diseño; la parte de promover y volver a versiones anteriores es del curso 5.

Empezar la lección
Nueve pequeñas figuras de robot industrial con visor oscuro en círculo sobre una mesa técnica oscura.

En esta lección vas a

  1. 1Localizar, Operar, Observar, Proponer, Reforzar
  2. 2Los nueve agentes y el contrato de cada uno
  3. 3Por qué la separación impide que el loop se convenza a sí mismo
  4. 4Un ciclo real del ejemplo, leído en el ledger

Objetivo: explicar las letras L-O-O-P-R y el contrato de los nueve agentes (lee, escribe, decide, nunca hace) y decir por qué quien hace no evalúa.

01Las cinco letras, en el orden del ciclo

Haz clic en cada letra: qué pide y qué agentes entran en ella.

Desplázate por la página: cada etapa de abajo ilumina su parte del diagrama.

  1. 1/6

    L · Localizar

    Elige un proceso que se repita mucho y escribe el objetivo con número: llevar X a Y sin empeorar Z. La ficha del loop tiene cinco respuestas que ningún sistema infiere con seguridad: objetivo con número, dónde nace la evidencia, qué nunca cambia solo, tope de costo y tiempo, y quién aprueba. Es el objetivo de la clase 1, con límite que no puede empeorar (guardarraíl).

  2. 2/6

    O · Operar

    El proceso gana una versión actual, un guion corto que se sigue en cada ejecución, para que dos ejecuciones sean comparables. El Ejecutor produce el artefacto y registra una línea. No opina, no sugiere, no cambia su propio prompt.

  3. 3/6

    O · Observar

    Una línea por ejecución, siempre las mismas columnas, resultado en sí o no. El Observador transforma las líneas en evidencia: conteos por versión y variante, sin adjetivos. Si los datos no coinciden con el esquema, detiene el ciclo.

  4. 4/6

    P · Proponer

    El Crítico dice qué funcionó y qué falló, con la fuerza de la evidencia, sin proponer solución. El Optimizador escribe hipótesis en el formato SE, ENTÃO, PORQUE y MUDANÇA, sin repetir las descartadas. El Guardián veta lo que toca lo que nunca cambia o el tope; el veto es final y no negocia.

  5. 5/6

    R · Reforzar

    El Experimentador diseña la prueba A contra B, con muestra mínima calculada de antemano. El Evaluador responde una de tres: B_GANHOU, A_SEGUE o AMOSTRA_INSUFICIENTE. No existe "va ganando". La Memoria registra todo sin borrar, y el Meta-agente mira el sistema (costo, vetos) y solo reporta.

  6. 6/6

    Quien arma no es quien inspecciona

    Nueve funciones separadas, cada una leyendo solo lo que el contrato manda. Es la separación, no un prompt más inteligente, lo que impide que el loop se convenza de que mejoró.

Letras como se presentan en la pista 2 del video del LOOP-R; contratos de los agentes en loop-r/docs/04-agentes.md y .claude/agents/.

02El contrato de los nueve, en una tabla

Resumen de loop-r/docs/02-arquitetura.md, §4. Cada agente es un archivo markdown en .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 y revisar los 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 · leer el ejemplo (datos 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
Ejemplo del repositorio
$ 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 |

Cuatro ciclos, ocho líneas de decisión: dos hipótesis vetadas por el Guardián antes de cualquier prueba, una descartada por el Evaluador, una promovida a la v2.

03Un descarte que enseña

Ciclo 0002 del ejemplo: la métrica subió y aun así la versión nueva no entró.

1. La hipótesis

Propuestas de máximo 80 palabras. Pasó por el Guardián y fue a prueba, A contra B, 300 ejecuciones de cada lado.

04Video: las cinco letras del método

Ruta 2 de LOOP-R en video. Hecha para gerentes, con ejemplos de negocio; el método es el mismo que usa un loop de ingeniería.

LOOP-R, ruta 2: las cinco letras · 15 min 44 sPágina del video con guion →

05Práctica

En tu máquina. Solo lectura en el repositorio de LOOP-R.

E1 · Los nueve contratos

15 min

Clona el loop-r y abre tres agentes: executor.md, guardiao.md y avaliador.md. Para cada uno, anota en agentes.md la línea "nunca" del archivo.

Listo cuando: ls ~/projetos/loop-r/.claude/agents/*.md | wc -l → 9, y grep -ci nunca agentes.md → 3 o más.

E2 · Leer un ciclo por el ledger

15 min

En el ejemplo vendas-whatsapp, lee el ledger y el veredicto del ciclo 0002. Escribe en una frase por qué la hipótesis fue descartada aunque la tasa de respuesta subió.

Listo cuando: grep -c '^| 2026' memoria/ledger.md → 8, y tu frase cita el límite que no puede empeorar (reclamos) y la tolerancia.

E3 · Separar a quien hace de quien evalúa

10 min

Piensa en un loop tuyo (código, contenido, atención al cliente). Escribe en agentes.md dos líneas, una que empiece por executa: y otra por avalia:, y di qué lee el evaluador que el ejecutor no escribe.

Listo cuando: grep -cE '^(executa|avalia):' agentes.md → 2, y la línea "avalia:" apunta a una fuente que el ejecutor no controla (prueba, planilla, rúbrica).

06Prueba de la lección

Pregunta 1 de 4

¿Por qué LOOP-R usa nueve agentes en vez de un agente que hace y revisa?competencia

07En tres frases

Cinco letrasLocalizar el proceso y el número, Operar siempre igual, Observar en líneas, Proponer con crítica y veto, Reforzar solo con prueba.
Nueve contratosCada agente lee, escribe y decide solo lo que el contrato manda, y tiene una lista de lo que nunca hace.
No regresiónEl LOOP-R no garantiza que el número suba; garantiza que una versión peor no reemplace a la actual por decisión del sistema.

Para ir más allá

LOOP-R en GitHub (framework, agentes, ejemplo)Guía del LOOP-RLOOP-R en video: 5 rutas, PT/EN/ESCurso 5 de la formación: el loop que aprende (promoción y rollback)
Clase anteriorPróxima clase