Trabajo todo el día con un agente de IA (en mi caso Claude Code) y por meses viví la misma fricción tonta: cada sesión empezaba de cero. Reexplicaba quién era, cómo estaba organizado el proyecto, qué habíamos decidido la semana pasada. La IA es brillante dentro de una conversación y amnésica entre conversaciones. Cierras la ventana y se borra todo.
Un día busqué en Google "segundo cerebro", pensando que encontraría la solución. Solo encontré lo de siempre: el método PARA, Notion, Obsidian, un segundo cerebro para que un humano tome notas. Nada sobre darle memoria a un agente. Así que dejé de buscar y armé el mío. Este post es el patrón que quedó después de ordenar la casa unas tres veces, generalizado, para que lo adaptes. Al final hay una plantilla para descargar.
El problema: la ventana de contexto no es memoria
La confusión empieza aquí, así que separemos las dos:
- Ventana de contexto = la memoria de corto plazo de una conversación. Hoy es enorme, pero volátil: termina la sesión, se evapora.
- Memoria persistente = conocimiento que vive fuera de la conversación, en archivos. El agente lo lee al inicio de cada sesión y lo escribe durante el trabajo. Sobrevive.
Pegar el contexto al inicio de cada conversación "lo resuelve", igual que anotar un teléfono en la palma de la mano lo resuelve. No escala, y olvidas la mitad. Lo que escala es darle al agente un lugar fijo, versionado, del que él mismo lee y al que él mismo escribe.
La arquitectura en 3 capas
Tras prueba y error, el formato que resultó robusto tiene tres capas, de lo general a lo específico:
Reglas globalesQuién eres, cómo te gusta trabajar, qué nunca debe hacer la IA. Vale para todo proyecto. En Claude Code es el CLAUDE.md global. Es el "sistema operativo" del agente.
Memoria por proyectoLos hechos que solo importan aquí: decisiones de arquitectura, reglas de negocio, el estado de cada frente. Un hecho por archivo, fácil de actualizar y borrar sin tocar el resto.
El índiceUn archivo conciso, una línea por hecho, cargado en cada sesión. Es el mapa: la IA lee el índice, decide qué es relevante y solo entonces abre el hecho completo. Barato de mantener en mente.
El truco de la capa 3 es económico: el índice se paga en tokens en cada sesión. Si es un párrafo por hecho, quemas contexto para nada. Una línea por hecho mantiene el mapa liviano y deja el detalle para cuando (y si) haga falta.
Durabilidad: versiona, pero por whitelist
Buena memoria es la que no se pierde cuando muere el disco y que te acompaña entre máquinas. La respuesta es vieja y aburrida: git. Comiteas el cerebro en un repositorio privado y lo espejas en la nube. ¿Máquina nueva? git clone y el agente ya lo sabe todo.
Pero hay una trampa de seguridad en la que cae casi todo el mundo. Si versionas por blacklist (ignora .env, ignora *.key...), basta olvidar un patrón para filtrar un secreto al repositorio. La inversión te salva: ignora todo por defecto y libera solo el conocimiento.
# ❌ blacklist — peligroso: olvidaste un patrón, se filtró
# .env
# *.key
# ✅ whitelist — ignora TODO, libera solo el conocimiento
*
!*/
!**/*.md
!.gitignoreCon whitelist, un archivo con un secreto creado por error simplemente no entra. Git ni lo mira. Las credenciales quedan en el .env (fuera del versionado). Y si trabajas con datos de un cliente, levanta una pared dura: los datos y el código del cliente viven solo en su infraestructura; a tu cerebro personal entra, como mucho, el aprendizaje destilado, nunca el dato crudo.
Las lecciones que Google no te cuenta
- La memoria es una foto del pasado, no el estado actual. Lo escrito era verdad cuando se escribió. Antes de actuar según una memoria, la IA la confirma contra el código/la realidad. Si no, repite con confianza un hecho que ya cambió.
- Un hecho por archivo. Actualizar es abrir un archivo, no cazar un párrafo dentro de un documento gigante. Y puedes borrar lo que quedó mal sin miedo.
- Condensa lo que terminó. Una historia concluida no necesita sus 12 pasos. Se vuelve un resumen de una línea ("hecho: X resuelto tal fecha"). El cerebro queda liviano.
- El índice es sagrado. Es el único archivo que la IA siempre lee. Mantenerlo corto y honesto es lo que hace funcionar todo el sistema sin quemar contexto.
La plantilla para empezar hoy
Para que no armes desde cero, te dejé un esqueleto sanitizado, el mismo formato que uso, sin nada específico mío. Descárgalo, renombra los placeholders y tienes un cerebro funcionando en 10 minutos.
CLAUDE.md— esqueleto de las reglas globales (capa 1)MEMORY.md— un índice de ejemplo (capa 3).gitignore— la whitelist lista (durabilidad segura)README.md— cómo conectarlo y el ritual para sincronizar entre máquinas
Es texto puro. Ábrelo, léelo, adáptalo. También está en mi Biblioteca, junto a otros recursos gratuitos.
En resumen
Un agente de IA no tiene por qué ser amnésico. Puedes darle un segundo cerebro: tres capas (reglas globales · memoria por proyecto · índice), versionado con git usando una whitelist para que no se filtre ningún secreto, portátil entre máquinas. No es magia. Son archivos de texto bien organizados y una disciplina simple de mantener. Pero la diferencia en el día a día es enorme: dejas de reexplicar y empiezas a construir desde donde lo dejaste.
Lectura relacionada: Qué son las skills de IA. La memoria es la mitad de lo que hace útil a un agente; las skills son la otra mitad (lo que sabe hacer). Ambos son parte de la guía Cómo trabajar con un agente de IA.
Quiero un sistema a medida para mi negocio
Es lo que hago: convierto el problema de tu negocio en software, con IA aplicada al negocio, automatización y obsesión por la seguridad. Si encaja con tu caso, hablemos.