Temario · lección 67 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
Proyecto 2, un workspace legible
Haz que una sesión nueva del agente entienda el proyecto y retome el trabajo solo leyendo el repo, con ARCHITECTURE.md, PRODUCT.md y session-handoff.md.
El nuevo en la oficina
Primer día en un trabajo. Si nadie te explica nada, pierdes la mañana preguntando dónde está cada cosa. Si hay un plano del edificio y una nota del compañero anterior, empiezas en diez minutos. Cada sesión de un agente es ese primer día. Este proyecto consiste en dejarle el plano y la nota. Relaciona dos ideas del curso: el repo como fuente de verdad y el handoff.
Qué construyes
Sobre la app del proyecto 1, añades tres funciones de producto en dos sesiones:
- Importación de documentos.
- Vista de detalle con el contenido completo.
- Persistencia: los datos siguen ahí tras reiniciar.
La función de harness es el verdadero objetivo: un workspace que otro agente pueda retomar.
Los dos intentos
| Sin ayuda | Con workspace legible | |
|---|---|---|
| Documentación | Ligera, sin handoff | ARCHITECTURE.md, PRODUCT.md, session-handoff.md, feature_list.json |
| Pregunta a medir | ¿Cuánto redescubre la segunda sesión? | ¿Puede continuar solo con el estado del repo? |
Qué debe tener cada archivo
- ARCHITECTURE.md: capas, qué hace cada carpeta, qué no se mezcla.
- PRODUCT.md: qué hace la app y para quién, con las funciones esperadas.
- session-handoff.md: nota de traspaso. Usa la plantilla del curso:
## Verificado ahora
- Qué funciona y qué verificación se ejecutó:
## Cambiado en esta sesión
## Roto o sin verificar
## Mejor próximo paso
- Función de mayor prioridad / por qué / qué cuenta como aprobado
## Comandos
- Inicio / verificación / depuración
Cómo hacer la prueba
- Sesión 1: implementa la importación y escribe el handoff al terminar.
- Cierra el agente por completo (contexto nuevo).
- Sesión 2: abre un agente limpio y dile solo «continúa». Observa cuánto tarda en saber dónde estaba y si pregunta lo que ya estaba escrito.
¿Qué evalúa de verdad este proyecto?
Fuentes: Learn Harness Engineering, projects/project-02