Estado limpio al cerrar sesión

En 30 segundos

Una sesión no está terminada cuando la función funciona, sino cuando deja el repo en un estado desde el que la siguiente puede empezar sin rescatarlo. Son cinco dimensiones.

La cocina del turno anterior

Llegas a trabajar a una cocina y encuentras platos sucios, ingredientes sin guardar y una nota que dice «algo falla en el horno». Pasas la primera hora averiguando qué pasó, no cocinando. Una sesión de agente que acaba dejando el repo así hace lo mismo a la siguiente: build roto, tests en rojo, archivos temporales por todas partes y nadie sabe qué está hecho.

Y hay un agravante: la sesión nueva viene a hacer su tarea, no a limpiar. Ignorará el desorden y construirá encima, añadiendo más desorden. Esa es la trampa de «ya limpiaré luego»: limpiar después equivale a no limpiar nunca.

Qué es un estado limpio

El estado limpio (clean state) se cumple cuando se satisfacen cinco dimensiones a la vez. Si falta una, la sesión no está terminada.

Dimensión	Pregunta
Build	¿Compila sin errores?
Pruebas	¿Pasan todos los tests, también los que existían antes?
Progreso	¿Está registrado qué se hizo, qué está a medias y qué no se empezó?
Artefactos	¿Se han retirado logs de depuración, archivos temporales, código comentado y marcadores sueltos?
Arranque	¿Funciona la ruta estándar de inicio sin intervención manual?

Trabajo terminado -> build ok? -> tests ok? -> actualizar lista y progreso
  -> quitar temporales -> arranque estándar ok? -> TRASPASO LIMPIO
(si algo falla en cualquier paso: arreglar antes de salir y volver a empezar)

Hacerlo parte de «terminado»

La regla del curso: sesión completa = la tarea pasa su verificación Y pasa la comprobación de estado limpio. Escríbelo en el archivo de instrucciones del agente, como una lista breve:

## Al cerrar la sesión
- [ ] El build pasa
- [ ] Todos los tests pasan
- [ ] Lista de funciones y progreso actualizados
- [ ] Sin código de depuración (console.log, debugger, TODO sueltos)
- [ ] La ruta de arranque estándar funciona

El coste de no hacerlo

El material del curso incluye un escenario hipotético de 12 semanas (valores supuestos, no medidas reales). Sin estrategia de limpieza, el build exitoso baja del 100 % al 68 %, los tests del 100 % al 61 % y el arranque de una sesión nueva pasa de 5 a más de 60 minutos. Con limpieza al salir y un repaso semanal, se mantienen cerca del 97 % y 95 %, y el arranque en unos 9 minutos. Tómalo como una ilustración de la idea, no como un dato para citar: el desorden se acumula solo, y solo la limpieza activa lo frena.

Progreso entre sesiones, con otra mirada

Esto continúa lo que viste en tareas largas: el diario de progreso es una de las cinco dimensiones. Si la siguiente sesión puede leer el estado en el repo en vez de deducirlo, empieza a trabajar de inmediato.

Comprueba lo aprendido

¿Cuál de estas NO es una de las cinco dimensiones del estado limpio?

Las cinco son build, pruebas, progreso, artefactos y arranque. Cuántas líneas se escriben no dice nada sobre si el repo queda en buen estado.

Fuentes: Learn Harness Engineering, lección 12