# EL ARNÉS DE MEMORIA **Para que Claude Code no empiece de cero cada mañana.** Son dos archivos y una carpeta. Se instala en 10 minutos. Funciona hoy. No hay que instalar nada, no hay dependencias, no hay que registrarse en ningún lado. Es texto plano. --- ## 1. El problema, en dos líneas Le explicas tu negocio, te da una respuesta buenísima, cierras la ventana. Al día siguiente abres otra sesión y no se acuerda de nada. No es que el modelo sea malo. Es que le estás hablando a alguien sin libreta. Y un prompt más largo tampoco lo arregla, porque el prompt se va con la ventana. Lo único que se queda es **un archivo en disco que se carga solo**. Eso es todo lo que es el arnés: dos archivos que se cargan solos, y una carpeta de fichas donde cada cosa que aprendiste queda escrita, fechada y enlazada. --- ## 2. Qué hay en este paquete ``` arnes-de-memoria/ ├── LEEME.md ← esto ├── CLAUDE.md.plantilla ← el archivo de reglas, comentado, para copiar ├── MEMORY.md.ejemplo ← el índice de la memoria └── memoria/ ├── como-trabajo.md ← ficha tipo `user` ├── cafe-lima-pedidos-whatsapp.md ← ficha tipo `project` └── trampa-zona-horaria.md ← ficha tipo `feedback` ``` Las tres fichas de `memoria/` son de una cafetería inventada, **Café Lima**. No son reales. Están para que copies la forma, no el contenido. --- ## 3. Instalación en 10 minutos Hazlo sobre un proyecto que ya tengas abierto. No crees uno nuevo para probar: el arnés solo se entiende cuando tiene algo real adentro. **Paso 1 — decide dónde vive la memoria (1 min).** La recomendación es **dentro del proyecto**, en `.claude/memoria/`. Así viaja con el proyecto, lo ve cualquiera del equipo y no se te pierde cuando cambies de laptop. ``` mkdir -p .claude/memoria ``` **Paso 2 — pon el archivo de reglas (4 min).** Copia `CLAUDE.md.plantilla` a la raíz de tu proyecto y renómbralo a `CLAUDE.md`. Ábrelo y llena los seis bloques. Borra los comentarios que no uses: un `CLAUDE.md` con instrucciones de la plantilla dentro es ruido que se carga en cada sesión. **Paso 3 — pon el índice (2 min).** Copia `MEMORY.md.ejemplo` a `.claude/memoria/MEMORY.md`. Borra el contenido y deja solo los títulos de sección. **Empieza vacío.** Un índice con fichas de Café Lima adentro no te sirve de nada. **Paso 4 — escribe la primera ficha (3 min).** Copia la ficha que más se parezca a lo que tienes que guardar, renómbrala y reescríbela entera. > **Cuál es la primera ficha:** la cosa que más veces has tenido que explicarle. > No la más importante. La más repetida. Enlázala en el índice: una línea, `- [Título](archivo.md) — de qué va.` **Paso 5 — comprueba que está puesto (30 s).** Abre una sesión nueva y escribe: ``` ¿Qué sabes de este proyecto? Dime de qué archivo lo sacaste. ``` Si te responde con lo que escribiste **y nombra el archivo**, ya está. Si te inventa algo o dice que no sabe nada, la ruta que pusiste en el `CLAUDE.md` no apunta a donde está la carpeta. Corrígela y vuelve a probar. --- ## 4. Dónde va cada archivo y por qué Hay dos sitios y se confunden todo el tiempo. | Archivo | Se carga en | Qué va ahí | |---|---|---| | `~/.claude/CLAUDE.md` | **todas** tus sesiones, de todos tus proyectos | lo tuyo: tu sistema, tu terminal, cómo quieres que te hable | | `CLAUDE.md` en la raíz del proyecto | solo ese proyecto | lo del proyecto: reglas, nombres, decisiones, dónde vive la memoria | En Windows el global es `C:\Users\TU-USUARIO\.claude\CLAUDE.md`. **La regla para no equivocarte:** lee la frase que ibas a escribir. Si empieza con *"yo..."* → va en el global. Si empieza con *"este proyecto..."* → va en el del proyecto. > `/memory` dentro de la sesión te abre estos archivos para editarlos sin salir, > y un mensaje que empieza con `#` agrega una línea a la memoria. > Si tu versión de Claude Code no los trae, edítalos con tu editor de siempre: > son archivos normales. --- ## 5. Las cuatro cosas que van en el archivo de reglas La plantilla trae seis bloques. **Cuatro no pueden faltar.** El resto es lujo. **1. Qué NUNCA hacer.** Es el bloque más rentable y el que casi nadie escribe. Cada vez que Claude haga algo que te dio rabia, eso es una línea aquí. No es una lista de buenas prácticas: son las cosas concretas que ya pasaron. > `NUNCA borres o reescribas migraciones que ya corrieron. Se agrega una nueva.` **2. Cómo se llama cada cosa.** Si en tu cabeza "pedido" y "orden" son lo mismo pero en la base de datos no, y no lo escribes, Claude va a elegir uno al azar cada vez. > `"Pedido" = lo que el cliente pide por WhatsApp. "Comanda" = lo que sale a cocina.` > `No son lo mismo y tienen tablas distintas.` **3. Qué ya está decidido.** Lo que no se vuelve a discutir. Sin esto, cada dos semanas te vuelve a proponer lo que ya descartaste, y vas a volver a explicar por qué no. > `La agenda es Google Calendar. Ya se evaluó y se descartó hacer una propia.` **4. Dónde vive cada archivo — y dónde vive la memoria.** Esta es la línea que conecta el arnés. Sin ella, el `CLAUDE.md` funciona y la carpeta de fichas no la lee nadie. > `La memoria de este proyecto está en .claude/memoria/.` > `Antes de trabajar, lee .claude/memoria/MEMORY.md y abre las fichas que hagan falta.` Los otros dos bloques de la plantilla — **los comandos reales** y **quién decide qué** — son los que más se agradecen cuando el proyecto crece o entra alguien más. --- ## 6. Cómo se escribe una ficha ### El nombre del archivo es la consulta Este es el detalle que hace que el sistema sirva a los seis meses. El nombre no describe la ficha: **es lo que tú escribirías en el buscador dentro de tres meses cuando te vuelva a pasar.** ``` mal: notas3.md · reunion-lunes.md · importante.md · v2-final.md bien: cafe-lima-pedidos-whatsapp.md · trampa-zona-horaria.md · como-trabajo.md ``` Todo en minúsculas, sin espacios, sin tildes, con guiones. Si el nombre necesita una fecha para distinguirse de otro, la fecha va al final: `cierre-15sep.md`. ### La cabecera Va arriba del todo, entre líneas de tres guiones. Es lo que hace que Claude sepa de qué va la ficha **sin abrirla**, y por eso la descripción importa tanto como el contenido: ```yaml --- name: cafe-lima-pedidos-whatsapp description: Estado del bot de pedidos de Café Lima al 15-sep-2026; qué funciona, qué falta y qué no se toca. metadata: node_type: memory type: project modified: 2026-09-15T18:20:00.000Z --- ``` - **`name`** — igual al nombre del archivo, sin el `.md`. - **`description`** — una frase, con la fecha adentro. Es lo único que se lee cuando hay cuarenta fichas. Si la descripción es vaga, la ficha no existe. - **`type`** — cuál de los cuatro (abajo). - **`modified`** — cuándo se tocó por última vez. - Si Claude escribe la ficha, te va a agregar un `originSessionId`. Déjalo. Si la escribes tú a mano, omítelo. ### Los cuatro tipos | `type` | Qué guarda | Ejemplo en este paquete | |---|---|---| | `user` | cómo trabajas **tú**. Vale en todos tus proyectos | `como-trabajo.md` | | `project` | el estado de **una cosa**: qué hay, qué falta, qué no se toca | `cafe-lima-pedidos-whatsapp.md` | | `feedback` | una trampa que ya pisaste, escrita como regla | `trampa-zona-horaria.md` | | `reference` | dato estable que se consulta: URLs, IDs, rutas, credenciales de dónde está qué | — | La que más valor da por hora es `feedback`, y es la que menos gente escribe. ### Los enlaces Entre fichas se enlaza con dobles corchetes y el nombre del archivo sin `.md`: ``` Ver [[trampa-zona-horaria]] antes de tocar los recordatorios. ``` En el índice (`MEMORY.md`) se enlaza con markdown normal, porque ahí sí quieres poder hacer clic: `- [Título](archivo.md) — de qué va.` **Enlaza siempre.** Una ficha suelta se pierde. Una ficha enlazada desde otras tres aparece sola cuando hace falta. ### Reglas de escritura - **Una pantalla.** Si no cabe, son dos fichas. - **La fecha va dentro del texto**, no solo en la cabecera: *"medido el 15-sep-2026"*. Una afirmación sin fecha no se puede desmentir después. - **Lo que está roto va marcado como roto.** Con una marca fija, siempre la misma: `[ROTO]`, `[PENDIENTE]`, `[OK]`. Elige tres y no cambies de sistema. - **Escribe la conclusión, no el camino.** No "probamos A, luego B, luego C". Escribe: "se usa C. A no sirve porque X." - **Si sabes por qué, escríbelo.** Una regla sin el porqué se rompe en cuanto alguien encuentra un caso que parece distinto. --- ## 7. El hábito: qué haces cada día Casi nada. Ese es el punto. **Al empezar:** nada. Se carga solo. **Cuando rompas algo y lo arregles:** ficha de tipo `feedback`, **el mismo día**. Tres partes, en este orden: la regla arriba, el porqué abajo, y cómo se aplica. Si lo dejas para el viernes, el viernes ya no te acuerdas del detalle que importaba. **Cuando cierres una decisión:** una línea al `CLAUDE.md`, en "qué ya está decidido". Diez segundos. Te ahorra la misma discusión tres veces. **Al final de una sesión larga**, pídeselo: ``` Escribe una ficha de memoria con lo que cerramos hoy: nombre de archivo, descripción con fecha, tipo, y enlázala en el índice. Marca lo que quedó roto. ``` Y después **léela y corrígela.** Claude escribe fichas demasiado optimistas: tiende a dar por cerrado lo que solo probó una vez. **Una vez al mes:** abre el índice, lee las descripciones y borra o archiva lo que ya no es cierto. Mueve lo viejo a `memoria/archivo/` en vez de borrarlo — a veces necesitas saber por qué se decidió algo hace tres meses. --- ## 8. Los tres errores que hacen que esto no funcione **1. Escribir la biblia el primer día.** Nadie mantiene cuarenta fichas escritas de golpe, y las que no se mantienen mienten. Empieza con tres. La cuarta se escribe cuando te haga falta, no antes. **2. No actualizar lo que dejó de ser cierto.** Es el único error que **empeora** las cosas frente a no tener memoria. Si la ficha dice que el pago va por un proveedor y hace dos meses cambiaste, Claude va a trabajar con confianza sobre un dato falso y tú no lo vas a notar hasta que duela. Dato viejo se corrige o se borra. No se deja "por si acaso". **3. Meter ahí lo que cambia cada hora.** La memoria no es un registro de tareas ni un diario. Si algo va a ser mentira la semana que viene, no es una ficha. Es un mensaje. **Y tres menores que igual duelen:** - Un solo archivo gigante en vez de fichas. Deja de ser buscable a las 300 líneas. - Dejar que Claude escriba las fichas y no leerlas nunca. - No marcar lo que está roto — entonces vuelve a proponértelo como si funcionara. --- ## 9. Qué NO meter nunca aquí El `CLAUDE.md` se sube al repositorio por defecto. La carpeta de memoria termina en tu backup, en tu sincronización, y en cualquier captura de pantalla que hagas. **Nunca:** - Claves, tokens, contraseñas, cadenas de conexión. - Teléfonos, correos, documentos de identidad de terceros — clientes incluidos. - Nombres de clientes reales, si tú no eres el dueño de ese dato. - Números del negocio que no querrías ver en pantalla compartida. **Lo que sí va:** el **nombre** de la variable, nunca su valor. ``` La clave del proveedor de pagos está en .env como PAGOS_API_KEY. Nunca la pegues en un archivo ni la imprimas en consola. ``` Y `.env` en el `.gitignore`, antes del primer commit. > **La prueba de los 5 segundos:** antes de guardar una ficha, mírala y pregúntate > si te incomodaría que apareciera en una captura de pantalla. Si dudas, sácalo. --- ## 10. Qué NO hace esto Para que no pierdas la tarde persiguiendo algo que no está aquí: - **No hace que Claude sea más inteligente.** Hace que no te repitas. - **No es memoria entre proyectos distintos** — salvo lo que pongas en el global. - **No se actualiza solo.** Si no escribes, no hay memoria. Son cinco minutos a la semana, pero son cinco minutos. - **No sustituye a la documentación del proyecto.** El `README` sigue siendo para personas. Esto es para la sesión. --- *Cópialo, rómpelo, cámbialo. No hay que pedir permiso ni dar crédito.*