Inicio / El segundo cerebro

Memoria en archivos: estructura y disciplinas básicas

La memoria de Claude Code vive en una carpeta de archivos markdown, un hecho por archivo clasificado mediante un campo type con cuatro valores, y una nota que lleva una sola idea vinculada al menos a otra sigue siendo localizable en unos segundos en lugar de mediante una relectura completa.

Claude Code puede conservar su propia memoria de una sesión a otra, en una carpeta de archivos de texto en formato markdown, un formato sencillo donde unos pocos símbolos bastan para marcar los títulos y las listas. Un archivo de memoria lleva un solo hecho, y su cabecera, llamada el frontmatter, lleva un campo llamado type que toma uno de cuatro valores posibles, listados más abajo tal como el software los escribe. Existe una carpeta de memoria distinta para cada proyecto abierto con Claude Code, y siempre comienza con un archivo índice que recoge en una línea cada una de las memorias ya escritas.

El frontmatter, la cabecera que clasifica cada archivo

El frontmatter es el bloque de información colocado entre dos líneas de guiones, al comienzo mismo del archivo, antes del texto que realmente se lee. No cuenta nada, solo sirve para clasificar la nota. Un archivo de memoria mínimo se parece a esto:

---
type: project
---
El atajo para reabrir la última sesión cerrada sigue activo siete días.

Los cuatro valores del campo type: user, feedback, project, reference

El valor project vincula una nota al trabajo en curso sobre un repositorio concreto. Una nota de tipo feedback documenta en cambio una observación sobre una forma de trabajar, y una nota del cuarto tipo listado más arriba señala un hecho estable, para consultar más que para seguir al pie de la letra.

Una nota que lleva una sola idea, vinculada a otra

El campo type sirve para clasificar lo que Claude registra en el frontmatter, pero la disciplina que hace que una carpeta de memoria sea realmente útil depende por completo de la persona que la escribe. Un archivo que mezcla dos hechos distintos resulta más difícil de encontrar el día en que solo uno de los dos sigue importando. Una nota aislada, sin ningún enlace hacia otra nota, permanece invisible mientras nadie piense en buscar exactamente su título.

Vincular una nota al menos a otra, aunque sea con una simple frase que la cite, construye una red que se puede recorrer en lugar de una pila que solo se puede rebuscar de arriba abajo. Esta disciplina no figura en ninguna regla impuesta por el campo type: nada impide escribir una nota de tipo project que mezcle tres temas sin enlace hacia nada más. Sigue siendo pese a todo la diferencia entre una carpeta consultable en unos segundos y una carpeta que hay que releer entera para encontrar un solo hecho, algo que desarrolla interrogar un grafo en lugar de releerlo todo, la tercera lección de este módulo.

Esta misma disciplina explica también por qué un mapa de contenido, una forma de vincular varias notas entre sí, cobra todo su sentido una vez acumulados varios archivos de memoria, un tema desarrollado en wikilinks, mapas de contenido y tipos de memoria.