Lecciones relacionadas: Lección 03. Convierte el repositorio en tu única fuente de verdad · Lección 04. Divide las instrucciones en varios archivos Archivos de plantilla: templates/
Proyecto 02. Haz el proyecto legible y retoma el trabajo donde lo dejaste
Qué harás
Añade "legibilidad" al repositorio para que un agente nuevo pueda entender rápidamente la estructura del proyecto, conocer el progreso actual y retomar el trabajo. En concreto: implementa importación de documentos, vista de detalle y persistencia local, completado en dos sesiones.
Lo ejecutarás dos veces: primero sin ayuda, y después con ARCHITECTURE.md, PRODUCT.md y session-handoff.md ya colocados en el repositorio.
Usa el proyecto incluido
Ruta en el repositorio: projects/project-02/
| Directorio | Qué contiene | Qué comparar |
|---|---|---|
starter/ | Código de Project 01 con importación, vista de detalle y persistencia todavía incompletas. La documentación existe, pero es más ligera y no hay session-handoff.md. | Cuánto contexto tiene que redescubrir una segunda sesión del agente. |
solution/ | La misma porción de producto ya completada, con documentación de handoff bajo projects/project-02/solution/, además de feature_list.json y session-handoff.md. | Si una sesión nueva puede continuar solo desde el estado del repositorio. |
Las funciones de producto son importación de documentos, carga completa del detalle/contenido y persistencia tras reiniciar. La función de harness es un workspace legible y fácil de retomar.
Herramientas
- Claude Code o Codex
- Git
- Node.js + Electron
Mecanismo de harness
Workspace legible para el agente + archivos de estado persistentes