CLAUDE.md, memoria automática y Brand Brain: cómo darle memoria de marca a la IA
Cada sesión de Claude Code empieza de cero. El modelo no recuerda la conversación de ayer, la corrección que hiciste la semana pasada ni el tono de voz que costó meses afinar. Quien usa IA en marca lo nota todos los días: el texto sale genérico hasta que alguien vuelve a pegar el posicionamiento, la lista de palabras prohibidas y los ejemplos aprobados.
Claude Code tiene dos mecanismos para llevar conocimiento de una sesión a otra: el CLAUDE.md y la memoria automática. En este tercer texto de la serie sobre agentes de IA, explicamos cómo funcionan los dos, a partir de la documentación oficial consultada en octubre de 2026, y por qué, para marca, armamos una tercera capa, el Brand Brain.
Por qué la IA olvida
El modelo trabaja dentro de una ventana de contexto, que es todo lo que tiene en cuenta en una conversación. Cuando la sesión termina, la ventana desaparece. Cuando la conversación se alarga demasiado, Claude Code compacta el historial en un resumen, y los detalles que solo se dijeron en el chat pueden perderse en ese proceso.
La solución es sacar el conocimiento de la conversación y guardarlo en archivos que Claude vuelve a leer en cada sesión. Los dos mecanismos de Claude Code lo hacen de formas distintas: el CLAUDE.md lo escribes tú, y la memoria automática la escribe Claude.
Qué es el CLAUDE.md
El CLAUDE.md es un archivo de texto con instrucciones que Claude lee al comienzo de cada sesión. Según dónde esté, puede valer para un proyecto, para ti en todos tus proyectos o para una organización entera.
| Archivo | Vale para | Sirve para |
|---|---|---|
~/.claude/CLAUDE.md | Ti, en todos los proyectos | Preferencias personales de trabajo |
CLAUDE.md en la raíz del proyecto | Todos los que trabajan en el proyecto | Reglas del proyecto, compartidas a través del repositorio |
CLAUDE.local.md en la raíz del proyecto | Solo tú, en ese proyecto | Ajustes personales que no deben compartirse |
| Archivo administrado por la empresa | Todos los usuarios de la organización | Políticas y estándares obligatorios |
Cuando hay varios, Claude los lee todos y junta el contenido, del más amplio al más específico. Para empezar, el comando /init analiza el proyecto y genera un primer CLAUDE.md, que después ajustas con lo que Claude no podría descubrir por su cuenta.
Cómo escribir un CLAUDE.md que funcione
La documentación sugiere quedarse por debajo de 200 líneas por archivo. Un archivo largo ocupa contexto en cada sesión y, según la propia Anthropic, hace que Claude siga peor las instrucciones. También pide instrucciones específicas: “escribe en español neutro y nunca uses guion como raya” funciona mejor que “escribe bien”.
Las instrucciones que se contradicen son un problema silencioso. Si un pasaje dice “tono formal” y otro dice “tono cercano”, Claude puede seguir cualquiera de los dos. Conviene releer el archivo de vez en cuando y borrar lo que quedó viejo.
El CLAUDE.md puede traer otros archivos con @ruta/del/archivo, hasta cuatro niveles de profundidad. Eso ordena, pero el archivo importado también se carga en cada sesión, así que no ahorra espacio. Para reglas que solo valen en una parte del proyecto, la carpeta .claude/rules/ acepta archivos con un campo paths, que solo entran cuando Claude toca archivos de esa ruta.
Un último punto que suele sorprender: el CLAUDE.md funciona como contexto y no puede bloquear nada. Claude tiende a seguirlo, pero puede equivocarse. Cuando una acción tiene que impedirse siempre, como borrar una carpeta de entregas, el camino es un hook, un comando que Claude Code ejecuta antes de la acción y que puede bloquearla.
Qué es la memoria automática
La memoria automática es el cuaderno que Claude escribe por su cuenta. Mientras trabaja, registra lo que puede servir en una conversación futura: quién eres y cómo prefieres trabajar, las correcciones que hiciste, decisiones del proyecto que no están en el código y dónde encontrar información fuera de él.
Las notas quedan en ~/.claude/projects/<proyecto>/memory/, una por archivo, con un índice llamado MEMORY.md. El índice entra en cada sesión, hasta las primeras 200 líneas o 25 KB. Claude no guarda lo que se puede descubrir leyendo el proyecto ni lo que el CLAUDE.md ya dice. Con el comando /memory, la activas, la desactivas y revisas lo que se guardó.
En el proyecto de nuestro sitio, la memoria automática tiene 87 notas. Una recuerda que la caché del sitio necesita un comando específico para que la página publicada cambie de verdad. Otra registra que, al traducir un post, el idioma tiene que guardarse antes que la categoría, porque si no el post desaparece del listado. Nada de eso estaba escrito en ningún lado antes.
La memoria automática también se equivoca. Si Claude anota algo que no comprobó, la nota empieza a parecer un hecho en las sesiones siguientes. Por eso vale la pena abrir la carpeta cada tanto y borrar lo que esté mal o desactualizado.
Lo que le falta a la marca: el Brand Brain
El CLAUDE.md y la memoria automática quedan atados a un proyecto y a una persona. Una marca necesita otra cosa: un conocimiento que valga en cualquier proyecto, que usen varias personas y en el que cada afirmación tenga origen. Para eso armamos el Brand Brain, la memoria de marca que nuestros agentes consultan antes de producir.
El Brand Brain es una carpeta de archivos de texto organizada por tema. Empieza por fuentes y preguntas abiertas, pasa por estrategia (posicionamiento, propuesta de valor, territorios), audiencia (perfil de cliente, dolores, objeciones, el vocabulario que usa el cliente) y voz (tono, léxico, lo que la marca nunca dice y ejemplos calibrados). Después vienen el kit visual, la gobernanza, la activación y un registro de decisiones.
Dos reglas marcan la diferencia. La primera: ninguna afirmación entra sin fuente. Lo que el material de la marca no responde se convierte en pregunta abierta, nunca en una suposición escrita como hecho.
La segunda: cuando un pedido contradice el brain, quien está produciendo elige entre seguir la regla, abrir una excepción solo para esa pieza o cambiar la regla, y la elección queda registrada con la versión.
El brain tampoco se carga entero. A la hora de producir, el agente consulta solo las secciones que importan para esa pieza: un copy para redes trae la voz y lo que la marca nunca dice, una pieza visual trae el kit. Las skills siguen la misma lógica y solo entran cuando la tarea lo pide.
Cómo encajan las tres capas
| CLAUDE.md | Memoria automática | Brand Brain | |
|---|---|---|---|
| Quién escribe | Tú | Claude | El equipo, a partir del material de la marca |
| Qué guarda | Cómo trabajar en este proyecto | Lo que Claude aprendió contigo | Qué es la marca y qué puede decir |
| Alcance | Un proyecto, una persona o la empresa | Un proyecto | Una marca, en cualquier proyecto |
| Se carga | En cada sesión | Índice en cada sesión | Por sección, cuando la pieza lo pide |
| Fuente | Quien lo escribió | La conversación | Documento citado en cada afirmación |
Una forma de verlo: el CLAUDE.md es el manual de trabajo del equipo, la memoria automática es el cuaderno de notas de quien trabaja, y el Brand Brain es el libro de la marca, con notas al pie.
Por dónde empezar
Ejecuta /init en el proyecto y recorta el archivo generado hasta que quede solo lo que vale para todo. Agrega las tres o cuatro instrucciones que más repites. Deja la memoria automática activada y, después de dos semanas, lee lo que guardó.
Para la marca, empieza por tres archivos: el posicionamiento en un párrafo, una lista de lo que la marca nunca dice y cinco ejemplos de textos aprobados, con la fuente de cada uno. Los ejemplos suelen enseñarle más a la IA que cualquier descripción de tono. En la revisión, las reglas de nuestro mapa de patrones de texto de IA ayudan a armar esa lista.
Los otros textos de la serie tratan de subagentes, que consultan esta memoria en contextos separados, y de skills y plugins, que empaquetan la consulta para que todo el equipo la use de la misma manera.
La serie completa
Este texto es parte de una serie de cinco sobre agentes de IA aplicados a la marca:
- Subagentes y equipos de agentes en Claude Code
- Skills y plugins en Claude Code
- CLAUDE.md y Brand Brain: memoria de marca para la IA (este texto)
- Cómo revisar contenido generado por IA
- Cómo usamos la IA en la operación de Headcore
Preguntas frecuentes
¿Cuál es la diferencia entre el CLAUDE.md y la memoria automática?
El CLAUDE.md lo escribes tú, con instrucciones y reglas, y se lee entero en cada sesión. La memoria automática la escribe el propio Claude, con lo que aprende de tus correcciones y preferencias, y solo el índice entra en cada sesión, hasta 200 líneas o 25 KB.
¿El CLAUDE.md garantiza que la IA siga las reglas?
No lo garantiza. Claude trata el CLAUDE.md como contexto y tiende a seguirlo, sobre todo cuando las instrucciones son cortas y específicas. Para impedir una acción siempre, la documentación indica usar un hook, que se ejecuta antes de la acción y puede bloquearla.
¿Cuál es el tamaño ideal de un CLAUDE.md?
La documentación sugiere menos de 200 líneas por archivo. Los archivos más grandes ocupan más contexto y hacen que Claude los siga peor. Lo que vale solo para una parte del proyecto puede ir a .claude/rules/ con el campo paths, que se carga solo cuando hace falta.
¿Qué pasa con las instrucciones cuando se compacta la conversación?
El CLAUDE.md de la raíz del proyecto se vuelve a leer del disco después de la compactación. Las instrucciones que se dieron solo en la conversación pueden perderse en el resumen. Si una instrucción tiene que durar, debe ir al CLAUDE.md.
¿Se puede darle memoria de marca a la IA sin Claude Code?
Sí. El Brand Brain es una carpeta de archivos de texto, y cualquier herramienta que lea archivos puede consultarlo. Lo que agrega Claude Code es la consulta automática: los agentes leen las secciones correctas antes de producir, sin que nadie tenga que pegar el material en la conversación.
¿Cuál es la diferencia entre el Brand Brain y el brand book?
El brand book está hecho para personas: muestra cómo debe verse y sonar la marca. El Brand Brain está hecho para que una máquina lo consulte antes de generar cualquier cosa, con cada afirmación ligada a su fuente y preguntas abiertas donde el material no responde. El kit visual del brand book vive dentro del brain.
Fuente: documentación de Claude Code sobre memoria, consultada el 21/10/2026.
