Inicio / Una instalación estructurada

Conectar la memoria de archivos a git

Una carpeta de memoria versionada con git, con un remote privado y una regla de fusión que conserva ambos contenidos en lugar de forzar, sigue siendo una técnica que hay que construir uno mismo, distinta de la memoria automática nativa que, por su parte, nunca sale de la máquina local.

Una carpeta de memoria sigue siendo un montón de archivos de texto mientras vive sola en un equipo: desaparece con la máquina, y nada permite saber quién escribió qué ni cuándo. Convertirla en un repositorio git cambia su naturaleza. Añade un remote privado, y esa carpeta se convierte en un cofre sincronizable entre varios equipos, con el historial, el diff y la posibilidad de volver a una versión anterior que git ya aporta.

El protocolo en cuatro gestos

El protocolo se resume en pocas palabras. Al iniciar una sesión, trae las notas remotas mediante un pull antes de leer cualquier otra cosa. Escribe luego durante la sesión, como un cuaderno ordinario. Al final de la sesión, valida las notas del día con un commit, y después empújalas hacia el remote. Ante un conflicto de fusión, la regla nunca es forzar una versión sobre la otra: es conservar ambos contenidos y fusionarlos a la lectura, a mano, un poco más tarde. Un repositorio desechable ilustra la mecánica básica sin tocar ninguna carpeta real.

mkdir demo-memoire && cd demo-memoire
git init -q
echo "note du jour" > carnet.md
git add carnet.md
git commit -q -m "premiere note"
git log --oneline

En un cofre real, esta secuencia se repite en cada sesión, con un pull añadido antes de escribir y un push después del commit. Pasar la carpeta por grep para localizar un secreto antes del primer push evita que un identificador olvidado se vaya al remote y quede después en el historial, incluso después de eliminar posteriormente el archivo.

Lo que la memoria automática nativa no reemplaza

Claude Code incorpora ahora un mecanismo de memoria automática, distinto de CLAUDE.md, que acumula solo notas de sesión en una carpeta local. Este mecanismo permanece deliberadamente local a la máquina: los worktrees y subcarpetas de un mismo repositorio git comparten una sola carpeta de memoria automática, pero nada se comparte entre varias máquinas o entornos en la nube. El protocolo git descrito aquí conserva por tanto su razón de ser precisamente donde se detiene la memoria automática, en cuanto entra en juego un segundo equipo o un remote compartido. Los dos mecanismos responden a dos necesidades distintas y pueden coexistir sin estorbarse entre sí.

Este protocolo cobra todo su sentido una vez conectado a los eventos del ciclo de sesión, en hooks y latido, donde el pull y el push dejan de ser un gesto manual para volverse automáticos.