Pinguy Learning
Temario · lección 55 de 74
0Empieza aquí
1Por qué fallan los agentes
2Qué es un harness
3Patrones de agentes
4Herramientas
5Ingeniería de contexto
6El repositorio como memoria
7Tareas largas
8Alcance y “hecho” de verdad
9Observabilidad y estado limpio
10Loops y grafos
11Harness reales
12Proyecto final
Loops y grafos· 8 min de lectura

Las seis primitivas de un loop

En 30 segundos

Un loop de verdad se monta con seis piezas, automatizaciones, worktrees, skills, conectores, subagentes y estado externo. No hacen falta todas siempre, pero hay que saber cuándo usar cada una.

Las piezas del reloj

/goal es un reloj de bolsillo simple. Un loop completo es un reloj con varias piezas que encajan. El material del curso, siguiendo a Addy Osmani, las reduce a seis. Cinco son bloques y una, el estado externo, es la columna sobre la que descansa todo.

1. Automations: el latido

Sin algo que lo dispare, un loop es una ejecución única hecha a mano. Las automatizaciones lo despiertan solas. Hay capas, de más ligera a más pesada:

CapaClaude CodeCuándo sirve
En la sesión/loopVigilar algo mientras trabajas; muere al cerrar la sesión
Tareas localesTareas programadas de escritorioTrabajo recurrente con acceso a tus archivos
En la nubeRoutinesDebe correr aunque tu equipo esté apagado
Totalmente tuyoGitHub Actions o cron propioRequisitos especiales de entorno o seguridad
/loop 30m Ejecuta los tests y arregla los que fallen

2. Worktrees: cada agente en su carril

Dos agentes escribiendo en el mismo archivo es como dos personas editando la misma línea a la vez. Un worktree de git da a cada agente su propia rama en su propia carpeta, así no pueden pisarse. Ojo: resuelve las colisiones, pero tu capacidad de revisión sigue siendo el techo. Cuántos agentes en paralelo puedes supervisar decide cuántos worktrees te sirven.

3. Skills: no repetir tu proyecto cada vez

Un agente empieza cada sesión en frío y rellena lo que no sabe con suposiciones. Un skill es una carpeta con un SKILL.md (instrucciones y metadatos, más scripts opcionales) donde escribes una vez las convenciones, los pasos de compilación y los «esto no se hace así por aquel incidente». Se invoca con su nombre o se activa solo si la tarea encaja con su descripción.

4. Connectors: tocar el mundo real

Un loop que solo ve archivos es pequeño. Los conectores, basados en el protocolo MCP, le dejan leer tu gestor de incidencias, consultar una base de datos o avisar en un canal de chat. Es la diferencia entre «aquí tienes el arreglo» y un loop que abre el PR, enlaza el ticket y avisa cuando la CI pasa.

5. Subagentes: quien hace no es quien comprueba

La decisión de diseño de más valor: separar a quien escribe de quien verifica. Un esquema clásico de tres roles es explorador (lee y localiza), implementador (escribe arreglo y tests) y verificador (revisa de forma independiente). Si el verificador rechaza, el trabajo vuelve al implementador. La próxima lección profundiza en esto: maker y checker.

6. Estado externo: la memoria

Los modelos olvidan todo entre ejecuciones, así que la memoria vive en disco: un archivo markdown, un tablero de incidencias, cualquier cosa fuera de la conversación que guarde qué está hecho, qué está en curso y qué sigue. Es el mismo principio de las tareas largas. Una plantilla de estado de loop del curso incluye: nombre, ronda actual, estado (en curso, completado, bloqueado, fallido), un registro por ronda (qué hizo el maker, resultado de la verificación, problemas, plan siguiente, si hace falta intervención humana) y una lista de bloqueos que se repiten.

Un loop completo, en una mañana

Juntas las seis y obtienes algo así:

  1. A las 9:00 se dispara la automatización.
  2. Lee el estado externo (progreso de ayer, incidencias abiertas).
  3. Un skill de triaje clasifica y prioriza.
  4. Para cada elemento accionable se crea un worktree aislado.
  5. Un subagente implementa y otro verifica.
  6. Si pasa, un conector abre el PR y se actualiza el estado; si falla, vuelve a intentarlo con otro enfoque.
  7. Lo que queda bloqueado o terminado llega a tu bandeja para revisión.

Tu trabajo: revisar la bandeja, decidir y afinar skills y reglas cuando el sistema se desvía.

Comprueba lo aprendido

¿Para qué sirve un worktree en un loop con varios agentes?

Un worktree de git da un checkout independiente a cada agente, evitando colisiones de archivos. Las memorias y horarios son otras primitivas.

Fuentes: Learn Harness Engineering, lección 13

¡Hecho! Pinguy crece.Siguiente: Maker y checker →