Ahora junta todo en una ejecución de verdad: carpeta, goal nivel 3, pruebas congeladas, el modo de ejecutar, vigilar sin interrumpir, saber cuándo parar y cerrar con medición. El piloto del kit, del 01/10/2026, sirve de referencia paso a paso. Al final, el mapa del curso y tu plan con fechas.
Objetivo: conducir una ejecución real del goal.md hasta el cierre medido, con puertas humanas y reglas de parada, y salir con el plan fechado.
01 · Seis etapas, de punta a punta
Cada etapa usa una clase del curso. Haz clic para ver qué hacer.
Haz clic en cada bloque del diagrama para ver qué hace.
La mayor parte del trabajo está en las etapas 1 y 2. En el piloto, con ellas bien hechas, la ejecución terminó en el primer ciclo.
02 · El piloto del kit, minuto a minuto (01/10/2026)
longrun/2026-10-01-medir-sessao/: construir el medir-sessao.py de la clase 7 con un loop headless.
1. Antes
Goal con especificación completa del formato de salida, 12 pruebas rápidas y 2 con sesiones reales de hasta 1,8 GB, congeladas (hash 3ae1ba7975508cba).
loop.env: 6 ciclos de 20 min, 8G de memoria, estancamiento 3; protegidos tests/, pytest.ini y tools/medicao/.
2. 14:19 → 14:22
14:19:41 inicio con 0 passed. El agente salió con rc=0 en 178 s, sin tocar los protegidos.
loop.log real2026-10-01 14:22:48 CONCLUÍDO no ciclo 1: teste final passou (14 passed)
3. 14:30
Verificación independiente: hash de las pruebas sin cambios, sin valores fijos en el código, 14 passed reproducido y una sesión nunca vista (de agosto) comprobada contra el script antiguo.
Medición: 332.791 de entrada, 304.000 de caché leído, 4.296 de salida (caché 91,3%), 0 compactaciones.
4. Lecciones
Con pruebas congeladas y especificación precisa, 1 ciclo. La prueba que decide es del loop, no del agente.
El hook de compactación solo habla con longrun activo: una ejecución ya concluida sin aviso es el comportamiento correcto, no una falla.
03 · Ensayo: el agente quiere continuar
Una ejecución en el ciclo 4. Tú decides si sigue. Las reglas de parada son las del kit.
Agente de la ejecuciónloop headless, ciclo 4
Elige tu respuesta. El comentario aparece justo después y la conversación sigue según tu elección.
04 · El prompt de ciclo y el cierre
El prompt.md es lo que el loop le envía al agente en cada ciclo. Generalizado a partir del piloto.
longrun/[carpeta]/prompt.md (modo headless)
Estás en un ciclo de una ejecución larga en el repo <ruta del proyecto>.
RESULTADO: <el resultado del goal.md en una frase>.
ANTES DE ACTUAR: lee goal.md → state.md → plan.md → últimas líneas de progress.md y failures.md (todos en longrun/<carpeta>/).
EN ESTE CICLO: elige la próxima acción útil, impleméntala, ejecuta <prueba rápida>. Si las rápidas pasan, ejecuta <prueba completa>.
AL TERMINAR EL CICLO (obligatorio):
- reescribe state.md (Funciona / Falta / Como retomar) y plan.md (próximos 3 pasos);
- agrega 1 línea en progress.md: fecha-hora, qué cambió, resultado de la prueba (N passed / N failed);
- si algo salió mal, 1 línea en failures.md: error → intento → resultado;
- decisiones de diseño en decisions.md.
- Cuando la prueba completa pase entera, escribe "concluído" en la primera línea de "## Funciona" del state.md.
RESTRICCIONES: no modifiques <protegidos>. Ninguna API, ninguna red. No hagas commit (el loop externo lo hace).
Terminal · cerrar con verificación independiente
cd ~/projetos/<seu-projeto>
head -5 longrun/<pasta>/state.md # diz concluído? (¿dice concluído?)
<teste completo> # rode você, não leia o log (ejecútalo tú, no leas el log)
git diff --exit-code <commit-base> -- tests/ pytest.ini; echo "protegidos: $?"
git diff --stat <commit-base> # só o que o goal permitia? (¿solo lo que el goal permitía?)
grep -rn "<valor esperado de um teste>" <pasta do código> # valor fixo no código? (¿valor fijo en el código?)
python3 ~/projetos/execucao-longa/tools/medir-sessao.py <sessão.jsonl>
05 · Práctica final
Una ejecución tuya, de verdad. Empieza pequeña: 1 a 3 horas.
E19 · Una ejecución de principio a fin
1–3 h
En la carpeta de las clases 1 y 2, congela las pruebas, elige el modo (/goal o loop-longrun.sh ensayado con agente falso) y déjalo correr con el hook y el vigia activados. Interviene solo en las reglas de parada.
Listo cuando: la primera línea de "## Funciona" del state.md dice concluído y el loop.log (en headless) termina en CONCLUÍDO no ciclo N, o la ejecución se detuvo por una regla del kit con el motivo en failures.md.
E20 · Cerrar y medir
30 min
Cierra con el bloque de verificación independiente y mide la sesión. Escribe la línea final en el progress.md y, si hubo una falla, la corrección mínima en el FALHAS.md del proyecto.
Listo cuando: la prueba completa, ejecutada por ti, pasa; git diff --exit-code [commit-base] -- tests/ → protegidos: 0; el progress.md tiene la línea final con tokens y compactaciones del medir-sessao.py.
06 · El mapa del curso
Cuatro entregas, en orden. Haz clic en un ejercicio para ver el "listo cuando".
Clase 806 · El mapa del cursoCuatro entregas, en orden. Haz clic en un ejercicio para ver el "listo cuando".
Día 1Carpeta y goal
clases 1 y 2
2 ejercicios
goal.md nivel 3 que falla antes del trabajo y resiste la trampa.
Al final del cursoUna ejecución larga tuya terminada por la prueba, cerrada por ti y medida, con el kit listo para la próxima.
20 ejercicios
Haz clic en un ejercicio para ver qué hacer y el "listo cuando".
1/5
Carpeta y goal
Kit instalado, carpeta creada, método en las reglas globales y el goal.md atacado por la trampa más barata.
1/5
Carpeta y goal
Kit instalado, carpeta creada, método en las reglas globales y el goal.md atacado por la trampa más barata.
2/5
Contexto y handoff
Requiere el día 1. Franjas, pausa y handoff ensayados sin gastar cuota; después un handoff real retomado con /prime.
3/5
Loop headless
Requiere los días 1 y 2. Terminado, trampa revertida y bloqueo de segunda copia, antes de soltar un agente de verdad.
4/5
Ejecución real
Requiere todo lo anterior. La ejecución corre en un día; el cierre independiente y la medición, en el siguiente.
5/5
El curso completo
Carpeta y goal, contexto y handoff, loop headless y una ejecución real. Pasa a la siguiente entrega solo cuando el "listo cuando" de la anterior sea verdad.
Orden obligatorio: el loop headless sin un goal de nivel 3 es solo una forma más rápida de gastar.
07 · Genera tu plan con fechas
Elige el inicio y cuánto tiempo tienes por semana. El plan lista los 20 ejercicios en orden.
plano.md
08 · Prueba final
Cinco preguntas sobre el curso completo.
Pregunta 1 de 5
¿Dónde está la mayor parte del trabajo de una ejecución larga, según el piloto?competencia
Correcto
Con criterio nivel 3 y 14 pruebas congeladas, el piloto terminó en el 1.er ciclo, en 3 min. La especificación precisa es lo que permite que el agente termine.
El state.md dice concluído. ¿Qué falta?competencia
Correcto
Verificación independiente: la prueba ejecutada por ti, git diff de los protegidos, búsqueda de valores fijos y una entrada nunca vista. Después, medir y registrar.
No es esa
Verificación independiente: la prueba ejecutada por ti, git diff de los protegidos, búsqueda de valores fijos y una entrada nunca vista. Después, medir y registrar.Repasar: Seis etapas, de punta a punta
Pregunta 3 de 5
¿Cuál de estos NO es motivo del kit para parar y llamar al humano?
Correcto
Subir el número de pruebas que pasan es avance medible: el loop sigue. Los otros tres están en la lista de parada.
~70% del punto de compactación. La franja 1 es el canal; la 3 es no abrir trabajo nuevo y sesión nueva al final de la unidad.
No es esa
~70% del punto de compactación. La franja 1 es el canal; la 3 es no abrir trabajo nuevo y sesión nueva al final de la unidad.Repasar: El mapa del curso
Pregunta 5 de 5
Sesión detenida hace 2 h, 300 mil tokens, handoff de esta sesión grabado a los 45 min. Al volver, lo más barato de ahí en adelante es...competencia
Correcto
Con el camino en un archivo, empezar limpio cuesta ~10 mil por turno contra ~23 mil reenviando (medido hasta el 17/10/2026).
No es esa
Con el camino en un archivo, empezar limpio cuesta ~10 mil por turno contra ~23 mil reenviando (medido hasta el 17/10/2026).Repasar: El mapa del curso
Prueba terminada
Acertaste {a} de {n}. Si aciertas todas, la clase se marca como completada.
Elige una alternativa. La explicación aparece después de tu intento.
09 · El curso en tres frases
Criterio primerogoal.md nivel 3 con pruebas congeladas: es lo que deja que el agente termine e impide la trampa.
Estado fuera del modeloSiete archivos, franjas de contexto, handoff verificado: la sesión puede compactarse, caerse o cambiar de modelo.
Quien cierra eres túLa prueba decide en el loop; tú verificas, mides y registras antes de darlo por terminado.