Temario · lección 74 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
Checklist final y plantillas
Las diez plantillas del curso, qué hace cada una, con cuáles empezar y una lista final para comprobar que tu proyecto tiene un harness de verdad.
La caja de herramientas
Cuando acabas un curso de cocina, lo útil no es el recuerdo: es el juego de recetas fichadas. Esta lección reúne las plantillas listas para copiar y una lista para repasar el conjunto. Todas se editan con los comandos, rutas y nombres de tu proyecto.
Empieza solo con cuatro
AGENTS.md(oCLAUDE.mdsi usas Claude Code; misma estructura).init.sh.claude-progress.md.feature_list.json.
El resto se añade cuando el proyecto crece.
Qué hace cada plantilla
| Plantilla | Para qué sirve |
|---|---|
AGENTS.md / CLAUDE.md | Primer archivo que lee el agente: flujo de inicio, reglas de trabajo, definición de «hecho», cierre limpio |
init.sh | Instala, verifica y muestra cómo arrancar (tres variables: INSTALL_CMD, VERIFY_CMD, START_CMD) |
claude-progress.md | Diario: estado verificado actual y una entrada por sesión |
feature_list.json | Funciones con prioridad, verificación, evidencia y estado |
session-handoff.md | Nota breve de traspaso entre sesiones |
clean-state-checklist.md | Revisión antes de cerrar sesión |
evaluator-rubric.md | Seis dimensiones de 0 a 2 para juzgar una entrega |
quality-document.md | Notas A a D de dominios y capas, y base para la ablación |
El esqueleto de init.sh
INSTALL_CMD=(npm install)
VERIFY_CMD=(npm test)
START_CMD=(npm run dev)Si la verificación falla, el agente se detiene y arregla la base antes de hacer nada nuevo.
El orden de trabajo que fijan
Al empezar: confirmar carpeta, leer el progreso, elegir la función pendiente de mayor prioridad, mirar los últimos commits, ejecutar init.sh y la verificación. Durante: una función a la vez, y nada de «hecho» sin evidencia. Al cerrar: pasar el checklist de estado limpio y dejar el handoff.
Checklist final del curso
Marca cada casilla en tu proyecto:
- Existe un mapa corto (AGENTS.md o CLAUDE.md) que enlaza a documentos por tema.
- Un comando (
init.sh) deja el entorno listo y verificado. - Hay una lista de funciones con una sola en curso.
- Ninguna función es
passingsin evidencia registrada. - Cada sesión termina con progreso actualizado y handoff.
- Los límites importantes se imponen con scripts o permisos, no solo con frases.
- Hay logs que permiten diagnosticar sin abrir el código.
- Alguien (u otro agente) evalúa con una rúbrica, no solo quien generó.
- Los loops tienen objetivo, verificación y parada.
- Has probado a quitar piezas para saber cuáles hacen falta.
¿Con qué conjunto conviene empezar un harness nuevo?
Fuentes: Learn Harness Engineering, resources/templates
