Lo que Claude prometió debe vivir fuera de la conversación
Una promesa hecha en la conversación desaparece con el contexto, tras una compactación o una sesión nueva; un registro de un archivo por tarea, con un estado y reglas de cierre, la hace sobrevivir; las transcripciones de sesiones, leídas sin su contenido, dicen qué sesiones se han movido.
Una promesa hecha en la conversación, «yo me encargo», «te respondo luego», existe solo mientras esa conversación sigue en el contexto. Tras una compactación o una sesión nueva, ha desaparecido, y nada avisa al asistente de que estaba abierta. El remedio es el de la primera lección de este módulo: escribir en un archivo lo que debe sobrevivir.
Un archivo por tarea, un estado por archivo
El registro es una carpeta: un archivo por tarea, con una línea de estado entre abierta, en-curso, entregada, abandonada, retirada, escritas así en los archivos. Las tres últimas cierran la tarea. La demostración crea sus datos en una carpeta desechable:
mkdir -p registro && cd registro
printf 'estado: abierta\ntitulo: Revisar el presupuesto del proveedor\n' > t001.md
printf 'estado: entregada\nprueba: presupuesto-revisado.md\ntitulo: Enviar la síntesis\n' > t002.md
printf 'estado: abandonada\ncita: "deja la comparación"\ntitulo: Comparar tres ofertas\n' > t003.md
grep -L -E '^estado: (entregada|abandonada|retirada)' t*.md
t001.md
El comando lista los archivos que no tienen ninguna línea de cierre: las tareas todavía abiertas o en curso. Una tarea anunciada como terminada en la conversación pero nunca cerrada en el registro sigue visible en él: es intencionado, porque el cierre exige una prueba.
Reglas de cierre
- Una sola herramienta escribe en el registro, bajo bloqueo, para que dos sesiones no se pisen, herramienta dada más abajo (una bóveda compartida no tiene edición concurrente).
- Una tarea solo sale entregada, con una prueba nombrada, abandonada, con la cita de la persona que renunció, o retirada, con el motivo (duplicado, anotada por error).
- Una tarea abandonada no vuelve porque un título nuevo se parezca al antiguo.
- Al retomar, un hook
SessionStartmuestra las tareas abiertas antes de la primera solicitud.
Esta es esa herramienta, en pocas líneas. mkdir falla si la carpeta ya existe: un solo proceso a la vez pasa el bloqueo, los demás esperan. Un bloqueo que queda tras un fallo se retira a mano (rmdir .bloqueo). Repetida con Git Bash el 2026-11-16, devuelve la salida de abajo y la tarea sigue listada por el comando anterior.
escribir() { # escribir t001.md en-curso
until mkdir .bloqueo 2>/dev/null; do sleep 1; done
sed -i "s/^estado: .*/estado: $2/" "$1"
rmdir .bloqueo
}
escribir t001.md en-curso && cat t001.md
estado: en-curso
titulo: Revisar el presupuesto del proveedor
Seguir la actividad desde las transcripciones
Las conversaciones se guardan en texto claro en projects/<proyecto>/<sesión>.jsonl, dentro de la carpeta de configuración de Claude Code, y se conservan 30 días por defecto (documentación oficial, consultada el 2026-11-16). Una herramienta de solo lectura puede decir qué sesiones se han movido sin mostrar su contenido:
mkdir -p projets/a
echo '{"type":"user"}' > projets/a/active.jsonl
echo '{"type":"user"}' > projets/a/ancienne.jsonl
touch -t 202601010000 projets/a/ancienne.jsonl
find projets -name '*.jsonl' -mmin -10
projets/a/active.jsonl
El formato interno de estas líneas no está garantizado de una versión a otra. Limita la herramienta a lo que no depende de él, el nombre del archivo y su fecha de modificación.
La vida de una tarea en el registro
Una coordinadora pide a su asistente, un viernes, que prepare el seguimiento de tres proveedores. El lunes, en una sesión nueva, el asistente no recuerda nada de esa petición. Ella abre la carpeta del registro, que contiene tres archivos, y lanza el comando que busca los archivos que no tienen línea de cierre: lista dos nombres. Ella vuelve a encargar al asistente esas dos tareas.
Escribe en una frase lo que esta situación establece, y en una frase lo que no establece.
Lo que esto establece: Establece que, según las líneas de estado del registro, dos de las tres tareas no tienen línea de cierre, y que el seguimiento del lunes se apoya en un archivo y no en la memoria de la conversación.
Lo que esto no establece: No establece que esas dos tareas sigan realmente pendientes, pues una tarea terminada cuyo estado no se actualizó aparecería también, ni que la tercera se haya cumplido sin leer su pieza de cierre.
Los tres calibrados falsos más frecuentes
- Demasiado amplio Este registro garantiza que ninguna promesa del asistente se pierde, sea cual sea la forma en que se escriban las tareas.
- Demasiado estrecho El comando solo mostró dos nombres de archivo, sin decir nada de las tareas.
- Fuera de tema Esta situación muestra que el asistente es poco fiable, porque olvidó una petición al cambiar de sesión.
- Una promesa hecha en la conversación desaparece con el contexto, tras una compactación o una sesión nueva: lo que debe sobrevivir se escribe en un archivo.
- Un archivo por tarea, con una línea de estado, permite encontrar las tareas abiertas con una sola búsqueda de los archivos sin línea de cierre.
- Una tarea solo sale del registro entregada con una prueba, abandonada con la cita de la persona o retirada con un motivo, y una tarea abandonada no vuelve porque un título se le parezca.
- Las transcripciones sitúan la actividad de las sesiones, pero su formato es interno: lee el nombre y la fecha, no el contenido.
En una carpeta temporal, crea tres archivos de estado como arriba, lanza el comando grep -L y comprueba que solo devuelve la tarea no cerrada.
Estos puntos dependen de una interfaz o de una regla que puede haber cambiado desde la redacción. Verifícalos en tu propia pantalla antes de fiarte de ellos.
- Reproduce la demostración en una carpeta temporal: el comando debe devolver un solo archivo, el que no tiene línea de cierre. Cambia el estado de otro archivo para reabrirlo y vuelve a lanzarlo.
Cada afirmación datable de esta lección remite aquí al texto público que la respalda. Una fuente que no se abre no prueba nada.
- Claude Code, documentación de la carpeta de configuración: transcripciones y plazo de conservación consultada el 2026-11-16
- Registro de cambios de Claude Code: hooks SessionStart consultada el 2026-11-16