Pinguy Learning
Temario · lección 67 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
Proyecto final· 6 min de lectura

Proyecto 2, un workspace legible

En 30 segundos

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 ayudaCon workspace legible
DocumentaciónLigera, sin handoffARCHITECTURE.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

  1. Sesión 1: implementa la importación y escribe el handoff al terminar.
  2. Cierra el agente por completo (contexto nuevo).
  3. 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.
Comprueba lo aprendido

¿Qué evalúa de verdad este proyecto?

El agente no recuerda: el estado debe estar en archivos. Lo que se mide es la legibilidad del repo para quien llega de nuevas.

Fuentes: Learn Harness Engineering, projects/project-02