Lección 13 · 2 min de lectura

Deja cada sesión en estado limpio

Cómo termina una sesión no es una nota al pie, es la primera jugada de la siguiente. Termínala sucia y le has dejado a la próxima un trabajo de limpieza en vez de un arranque en marcha.

💡Deja el campamento más limpio de lo que lo encontraste

La regla de un buen campamento es dejarlo listo para el siguiente: fuego apagado, herramientas guardadas, una nota sobre el agua. Una sesión que termina sucia hace que la siguiente empiece limpiando. La entropía es lo normal; un traspaso limpio es la disciplina que la combate.


El desorden se acumula

Deja atrás un árbol a medio commitear, un proceso de fondo suelto y ninguna nota de lo ocurrido, y la siguiente sesión abre en la confusión. No puede distinguir trabajo terminado de intentos abandonados, ni un servicio en marcha de uno filtrado. Cada final desordenado hace más lento el siguiente arranque, y el coste se acumula a lo largo de una tarea larga.

flowchart LR
  Green["Funcion en verde"] --> Commit["Commit, ordena el arbol"]
  Commit --> Handoff["Sobrescribe handoff.md"]
  Handoff --> Advance["Avanza feature_list.json"]
  Advance --> Resume["La siguiente pasada reanuda en limpio"]
Cada función en verde termina en un estado commiteado, documentado y reanudable.

El ritual de estado limpio

Termina cada sesión a propósito: commitea o revierte para que el árbol quede limpio, detén lo que arrancaste y escribe un traspaso corto, qué se hizo, qué sigue, qué es arriesgado. La prueba de un buen traspaso es simple: una sesión nueva debería poder leerlo y ser productiva de inmediato, sin nada que desenredar primero.

Definición de limpio

Árbol commiteado, sin procesos sueltos y una nota de traspaso que permita arrancar en frío. Si falta alguna de las tres, la sesión no está terminada.

Los traspasos limpios cierran el bucle

Aquí es donde el bucle pasa de frágil a compuesto. Tras cada función en verde, el motor de Agentum sobrescribe .agentum-harness/handoff.md con el estado actual y avanza la función en feature_list.json antes de tomar la siguiente, así una corrida de varios días es una cadena de estados limpios y reanudables, y un daemon reiniciado lee el board directo desde el disco. La corrida solo llega a done cuando todas las funciones están en verde. Esa disciplina de estado limpio es lo que permite que el bucle corra sin supervisión en tmux y siga siendo confiable cuando reconectas por el túnel.

Puntos clave

  • Un final desordenado le entrega a la siguiente sesión un problema de depuración en vez de un punto de partida.
  • Limpio significa: árbol commiteado, sin procesos sueltos y una nota de traspaso usable.
  • La prueba: una sesión nueva puede leer el traspaso y ser productiva de inmediato.
  • Agentum termina cada iteración limpia, convirtiendo una corrida autónoma larga en una cadena de puntos de reanudación seguros.

Ejercicios

  1. Pasa la checklist. Termina una sesión con: árbol commiteado, sin procesos sueltos, traspaso escrito. ¿Pasaron las tres?
  2. Mide la entropía. Abre una rama de hace una semana. ¿Cuánto tardas en entender su estado? Ese hueco es el coste de las salidas sucias.

Para seguir leyendo

Esta lección reformula para Agentum el capítulo equivalente del curso abierto de Walking Labs. Lee el original ↗