Proyecto 3, continuidad entre sesiones

Una novela por capítulos sueltos

Imagina escribir una novela donde cada mañana olvidas el capítulo anterior. Sin notas, repites escenas y contradices a los personajes. Un agente trabaja así. Este proyecto le da el cuaderno: un registro de progreso, una lista de funciones con estado y un cierre ordenado de cada sesión. Teoría en el diario progress.md y una cosa a la vez.

Qué construyes

Cuatro funciones sobre la app de los proyectos anteriores:

• Partir los documentos en fragmentos (chunking).
• Extraer metadatos.
• Mostrar el progreso de indexación.
• Preguntas y respuestas con citas.

Y las sigues con feature_list.json: una función a la vez y nada de passing sin evidencia.

Los estados de una función

Los dos intentos

Primero sin restricciones; luego con reglas estrictas. El punto de partida (starter) trae solo una lista inicial. La solución añade init.sh, session-handoff.md, claude-progress.md y clean-state-checklist.md. Compara si el agente se desvía entre funciones o pierde el estado al reiniciar, y si cada función tiene evidencia concreta antes de aprobarse.

Ejemplo de entrada de evidencia

{
  "id": "index-002",
  "status": "passing",
  "evidence": "init.sh OK; indexé 3 documentos; la barra llegó a 100%; test indexing.test pasa"
}

Una frase como «parece que funciona» no es evidencia. Un comando ejecutado y su resultado, sí.

Cierre limpio de cada sesión

Antes de parar, repasa esta lista (viene en las plantillas del curso):

• El arranque estándar sigue funcionando.
• La verificación estándar sigue ejecutándose.
• El progreso está en el registro.
• El estado de las funciones refleja la realidad, sin falsos passing.
• No hay pasos a medias sin documentar.
• La siguiente sesión puede continuar sin arreglos manuales.