Clase 1 · 15 min
Todo loop de agente que funciona tiene las mismas cinco piezas, del /goal al lazo de shell. Cuando un loop falla, casi siempre falta una: no dice adónde quiere llegar, olvida dónde estaba, se aprueba solo o no sabe parar. Aquí aprendes a verlas y ejecutas un loop de juguete, sin modelo, que las muestra.
Empezar la lección
Objetivo: identificar las 5 piezas en cualquier loop de agente y ejecutar un loop de juguete que se detiene solo por la prueba o por el tope.
Haz clic en cada bloque: la pregunta que responde la pieza y lo que pasa cuando falta.
Desplázate por la página: cada etapa de abajo ilumina su parte del diagrama.
Una frase con un final que se puede verificar: un archivo con 5 líneas, una suite de tests pasando, una cola vacía. Sin eso el loop no tiene cómo saber que terminó, y se detiene cuando se acaba la cuota o cuando el modelo cree que ya está bien.
Lo que ya se hizo, lo que falta y cómo retomar. En un loop largo el contexto del modelo se compacta, se resetea o se cambia de sesión; lo que solo está en la conversación se pierde. Por eso el estado vive fuera del modelo (clase 5).
Lo que hace el agente en este ciclo: editar un archivo, ejecutar un comando, pedir una herramienta. Un paso pequeño es un paso verificable; cinco cambios a la vez no dicen cuál de ellos rompió algo.
Quien dice que el paso salió bien es un comando, no la opinión del agente: el test corre e imprime "6 passed", el wc cuenta 5 líneas. Es la pieza que más falta y la que más cuesta cuando falta. La escala de 0 a 4 está en la clase 6; cómo armar el evaluador, en el curso 1.
Dos salidas, siempre: la buena (el objetivo se verificó) y la de seguridad (se alcanzó un tope o dejó de avanzar). Un loop sin tope es el que gira toda la noche en el mismo test roto. Los cinco topes están en la clase 7.
¿Adónde quiero llegar? ¿Dónde estoy? ¿Cuál es el próximo paso? ¿Salió bien, con prueba? ¿Paro o sigo? El loop que responde las cinco con un archivo y un comando trabaja solo; el que responde con la memoria del modelo depende de la suerte.
Vale para un loop de shell, para el /goal de Claude Code, para el codex exec dentro de un script y para los nueve agentes del LOOP-R.
Cuatro síntomas que todos ya vieron, y la pieza que los resuelve.
El agente termina con un resumen seguro de sí mismo y el test ni corrió. El objetivo existía, pero nadie lo comprobó.
Corrección: la parada depende de un comando que imprime el resultado, y la prueba aparece en la salida.
"deja los tests pasando" → "python3 -m pytest -q imprime 6 passed"
El mismo test roto, el mismo intento, ciclo tras ciclo, hasta que se acaba la cuota.
Corrección: tope de ciclos y regla de estancamiento, por ejemplo 3 ciclos sin avance medido = parar y llamarte.
Después de una compactación o de una sesión nueva, el agente vuelve a empezar un ítem que ya estaba listo o se salta uno pendiente.
Corrección: el estado va a un archivo y a git, y todo ciclo empieza releyéndolo (lección 5).
"Mejora el código" no tiene fin: cada ciclo encuentra una cosa más.
Corrección: un estado final que se comprueba con un comando. Si no puedes escribir el comando, la tarea todavía no está lista para convertirse en loop.
Sin ningún modelo: la "acción" es una línea de shell. El objetivo es ver las piezas, no el agente.
#!/usr/bin/env bash # Loop de juguete: las 5 piezas sin ningún modelo. El "agente" es una línea de shell. set -u OBJETIVO=5 # 1. objetivo: saida.txt con 5 líneas ESTADO=estado.txt # 2. estado: queda en un archivo, no en la memoria MAX_CICLOS=8 # 5. parada: tope de ciclos touch saida.txt ciclo=$(cat "$ESTADO" 2>/dev/null || echo 0) while true; do feitas=$(wc -l < saida.txt) # 4. verificación: un comando, antes de actuar echo "ciclo $ciclo: $feitas de $OBJETIVO linhas" if [ "$feitas" -ge "$OBJETIVO" ]; then echo "PRONTO no ciclo $ciclo"; exit 0; fi if [ "$ciclo" -ge "$MAX_CICLOS" ]; then echo "PARADO: teto de $MAX_CICLOS ciclos"; exit 2; fi ciclo=$((ciclo + 1)); echo "$ciclo" > "$ESTADO" echo "item $ciclo" >> saida.txt # 3. acción done
mkdir -p ~/ensaio-loop/pecas && cd ~/ensaio-loop/pecas # pega el script de arriba en loop-brinquedo.sh y ejecútalo: bash loop-brinquedo.sh; echo "rc=$?" bash loop-brinquedo.sh; echo "rc=$?" # otra vez: ya está listo, no actúa
$ bash loop-brinquedo.sh; echo "rc=$?" ciclo 0: 0 de 5 linhas ciclo 1: 1 de 5 linhas ciclo 2: 2 de 5 linhas ciclo 3: 3 de 5 linhas ciclo 4: 4 de 5 linhas ciclo 5: 5 de 5 linhas PRONTO no ciclo 5 rc=0 $ bash loop-brinquedo.sh; echo "rc=$?" ciclo 5: 5 de 5 linhas PRONTO no ciclo 5 rc=0
La segunda ejecución no agrega nada: el estado está en el archivo y la verificación viene antes de la acción.
$ bash loop-brinquedo.sh | tail -3; echo "rc=${PIPESTATUS[0]}"
ciclo 7: 7 de 20 linhas
ciclo 8: 8 de 20 linhas
PARADO: teto de 8 ciclos
rc=2El objetivo no cabe en el tope: el loop sale por la puerta de seguridad, con un código distinto de 0, en vez de girar para siempre.
Este curso da la anatomía; los otros cinco profundizan una pieza cada uno. Verificación: curso 1 (evaluador separado, pruebas congeladas, reward hacking). Estado y objetivo en una ejecución de horas: curso 2 (el kit de siete archivos y el goal.md).
Acción dividida entre varios agentes: curso 3. Límites de lo que el agente puede hacer: curso 4. Y el loop que mejora su propio proceso, con promoción y rollback: curso 5.
En tu máquina. Pasa al siguiente solo cuando el "listo cuando" sea verdad.
Crea ~/ensaio-loop/pecas, pega el loop-brinquedo.sh y ejecútalo dos veces seguidas.
Listo cuando: La primera ejecución termina con PRONTO no ciclo 5 y rc=0; la segunda imprime solo ciclo 5: 5 de 5 linhas y PRONTO no ciclo 5, y wc -l < saida.txt → 5.
Borra saida.txt y estado.txt, cambia OBJETIVO=5 por OBJETIVO=20 y ejecútalo de nuevo.
Listo cuando: La última línea es PARADO: teto de 8 ciclos y echo $? justo después → 2.
Toma el último pedido largo que le hiciste a Claude Code o a Codex. En un archivo pecas.md, escribe una línea por pieza, empezando por objetivo:, estado:, ação:, verificação: y parada:, diciendo qué cumplía ese papel, o faltou. Escribe las marcas exactamente así, en portugués: el grep del "listo cuando" las busca.
Listo cuando: grep -ciE '^(objetivo|estado|ação|verificação|parada):' pecas.md → 5, y al menos una línea dice "faltou" o apunta a un comando de verdad.
Pregunta 1 de 4
El agente terminó diciendo "implementé y todo está funcionando", pero ninguna prueba aparece en la salida. ¿Qué pieza faltó?competencia
Pregunta 2 de 4
En el loop de juguete, ¿por qué la segunda ejecución no agrega la 6.ª línea?
Pregunta 3 de 4
Un loop tiene objetivo verificable, estado en archivo y prueba por ciclo, pero ningún tope. ¿Qué puede salir mal?
Pregunta 4 de 4
¿Qué objetivo está listo para convertirse en loop?competencia
Elige una alternativa. La explicación aparece después de tu intento.