Temario · lección 57 de 74
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
- Proyecto 1, solo prompt contra harness mínimo
- Proyecto 2, un workspace legible
- Proyecto 3, continuidad entre sesiones
- Proyecto 4, feedback de runtime e indexado
- Proyecto 5, que el agente verifique su trabajo
- Proyecto 6, el harness completo (capstone)
- Proyecto 7, tu primer loop automático
- Proyecto 8, dibuja tu flujo como un grafo
- Checklist final y plantillas
Costes silenciosos de los loops
Un loop acelera la producción y también el riesgo. Cuatro costes se acumulan sin hacer ruido, deuda de verificación, deterioro de la comprensión, rendición cognitiva y explosión de tokens.
Lo barato que sale caro
Pones un loop a trabajar toda la noche y por la mañana tienes veinte cambios hechos. Genial. Pero ¿entiendes los veinte? ¿Alguien los comprobó de verdad? ¿Cuánto costó? Los problemas de los loops no saltan el primer día: se acumulan y para cuando los notas ya has pagado. Con loops, generar es casi gratis y el juicio pasa a ser el recurso escaso.
1. Deuda de verificación
Un loop rápido tienta a saltarse la comprobación: «se ve bien» no es «confirmado correcto». Cuanto más código se produce sin supervisión, más rápido crece la deuda, igual que un préstamo con intereses.
Antídoto: las condiciones de parada deben poder comprobarse con una máquina (un test, un comando), nunca ser un «más o menos bien».
2. Deterioro de la comprensión
Si el loop entrega código más rápido de lo que lo lees, tu modelo mental del proyecto se separa de la realidad. Un día tienes que depurar algo que «escribió el sistema» y no sabes dónde mirar.
Antídoto: los loops rápidos exigen lectura rápida. Revisa los diffs importantes y mantén tu mapa actualizado; si el equipo lee lo que aterriza, el modelo mental sigue vivo.
3. Rendición cognitiva
Cuando el loop va bien, lo más cómodo es dejar de opinar: aceptas lo que sale y no piensas en ello. Ahí empieza el peligro, porque usas el loop para evitar pensar en lugar de amplificar tu pensamiento. Osmani lo resume así: dos personas pueden construir el mismo loop y obtener resultados opuestos; una lo usa para ir más rápido en trabajo que entiende, la otra para evitar entenderlo. El loop no distingue; tú sí.
Antídoto: decide tú el objetivo y revisa con criterio. Si no podrías explicar por qué una salida es correcta, no la aceptes.
4. Explosión de tokens
Cada vuelta del loop añade contexto: código escrito, errores, decisiones. Si cada ronda añade más o menos la misma cantidad, el historial que ve una ronda crece de forma lineal con el número de rondas. Y si el sistema reprocesa todo el historial en cada ronda, el total de texto procesado a lo largo de N rondas crece aproximadamente como el cuadrado de N. Por eso un loop largo puede costar mucho más de lo esperado.
Antídoto: comprimir el contexto antiguo (Codex, por ejemplo, hace compactación automática de turnos viejos en resúmenes), guardar el estado en archivos en vez de en la conversación y poner un máximo de turnos como parada. Enlaza con lo visto en compactación y notas.
Resumen en una tabla
| Coste | Qué se acumula | Defensa |
|---|---|---|
| Deuda de verificación | Cambios no comprobados | Paradas comprobables por máquina |
| Deterioro de la comprensión | Distancia entre tú y tu código | Leer los diffs que importan |
| Rendición cognitiva | Aceptar sin pensar | Mantener criterio propio |
| Explosión de tokens | Contexto y coste | Compactar, estado en archivos, tope de turnos |
La escalera para empezar sin pasarte
El curso propone cinco niveles: 1) ejecutor de objetivos (/goal), 2) una tarea programada, 3) loop con varios agentes (maker y checker, worktree por hallazgo), 4) loop que descubre su próxima tarea desde el estado externo, 5) varios loops en paralelo con memoria compartida. La mayoría de equipos están entre el 2 y el 3; el nivel 1 es el camino más rápido para ver resultados. Empieza pequeño: un /goal, un temporizador, un archivo de memoria.
¿Qué es la «rendición cognitiva»?
Fuentes: Learn Harness Engineering, lección 13