Pinguy Learning
Temario · lección 58 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

Del loop al grafo

En 30 segundos

Cuando una tarea necesita especialización, paralelismo y retrocesos, el loop se convierte en un grafo. Se compone de nodos, aristas, estado compartido y reglas de routing.

Cuando un solo carril no basta

Un loop maker-checker es como una cocina con un solo cocinero que cocina, prueba y corrige. Va bien para un plato. Si el menú crece, necesitas a alguien que compre, otro que cocine, otro que pruebe, y reglas claras: si el plato sale mal, ¿se vuelve a cocinar o a comprar ingredientes? Eso es pasar de un loop a un grafo.

El material del curso nace de un debate de internet de julio de 2026 sobre si «ya hablamos de grafos en lugar de loops», que empezó en parte como broma. La enseñanza útil no es la moda, sino ver por qué un loop único se queda corto.

Cuatro capas apiladas

CapaDa forma aPregunta
PromptLa instrucción¿Cómo le digo qué hacer?
ContextoLa información¿Qué debe saber antes de decidir?
LoopLa ejecución¿Cómo itera solo hasta lograrlo?
GrafoEl sistema¿Cómo colaboran varios agentes, loops, herramientas y evaluadores?

Cada capa se apila sobre la anterior, no la reemplaza. En un grafo, cada nodo lleva su propio prompt, contexto, herramientas, memoria y loop. El grafo decide cómo se conectan. (Este curso sigue poniendo el harness como base de todo.)

Las cuatro piezas

Nodo: una unidad de trabajo con una responsabilidad. Puede ser código determinista (ejecutar tests), una llamada a un modelo, una herramienta (hacer commit) o un agente completo con su propio loop.

Arista: cómo se pasa el relevo. No es solo «A y luego B»: puede ser paralelismo (B y C a la vez), condición (si pasa, izquierda; si falla, derecha), reintento o retroceso (volver tres pasos atrás).

Estado compartido: el paquete de datos que viaja entre nodos (requisitos, código, resultados de tests, veredicto de revisión). Los nodos no se hablan directamente: todos leen y escriben el mismo estado.

Reglas de routing: el control de flujo. Dicho simple: si el test pasa, entrega; si falla, vuelve a implementar; si falta información, vuelve a investigar.

Un grafo mínimo

Para el desarrollo de una corrección de errores:

estado = {
  requisitos: texto,       # lo escribe el nodo research
  codigo:     texto,       # lo escribe el nodo implement
  revision:   pass | fail, # lo escribe el nodo verify
  intentos:   numero       # +1 por cada fallo
}
NodoTipoDentro del nodoEscribe
researchagentebuscar, leer, resumir, repetir si falta informaciónrequisitos
implementagenteescribir, probar, corregir hasta pasarcodigo
verifyagenterevisión independiente, con contexto nuevorevision
mergecódigohace commit si la verificación pasafin
DesdeCondiciónHacia
verifyrevision == passmerge
verifyrevision == failimplement

Fíjate en verify: debe empezar con una ventana de contexto nueva, sin ver el razonamiento del implementador. Eso es la revisión independiente de maker y checker, pero ahora garantizada por diseño. Además, guardar el estado tras cada paso (checkpoints) permite parar y reanudar sin empezar de cero, y colgar una pausa antes del merge para pedir aprobación humana.

Qué cambia respecto al loop

En el loop, volver atrás es algo que el agente «recuerda» dentro de su contexto. En el grafo, las aristas de retroceso están dibujadas. Por eso el curso cita una idea: el loop es una decisión aplazada («deja que un agente lo haga todo y ya veremos»), y el grafo es una decisión anticipada: declaras quién hace qué y a dónde vuelve cada fallo. El loop esconde el problema dentro del ciclo; el grafo lo pone sobre el papel. El primero sirve para explorar; el segundo, para producción.

Comprueba lo aprendido

En un grafo de agentes, ¿cómo se comunican los nodos?

Cada nodo conserva su contexto privado. Lo único compartido es el estado, que es la mesa común donde se pasan el relevo.

Fuentes: Learn Harness Engineering, lección 14

¡Hecho! Pinguy crece.Siguiente: Cuándo usar un grafo →