Cómo recuerdan cosas los agentes de IA
Un agente empieza cada sesión con la mente en blanco. Los sistemas de memoria como CLAUDE.md y los archivos de memoria salvan esa distancia.
El problema de fondo
Cada nueva sesión de un agente de IA empieza con una ventana de contexto vacía. Sin mecanismos adicionales, el agente no sabe nada de ayer: qué reglas aplican, qué salió mal la última vez, qué biblioteca usa tu equipo.
Dos tipos de memoria
Se puede distinguir a grandes rasgos entre dos tipos de memoria. La memoria semántica son reglas y hechos fijos y duraderos: 'usamos pnpm, no npm', el estilo de código, las decisiones de arquitectura. Eso está en archivos como CLAUDE.md o AGENTS.md, que tú mantienes. La memoria episódica son notas sobre eventos concretos del pasado: 'en la sesión X, el enfoque Y falló porque Z'. Ese tipo de notas suele escribirlas el propio agente en archivos de memoria separados.
Cómo se ve esto a nivel técnico
CLAUDE.md/AGENTS.md se carga por completo en cada sesión. Los archivos de memoria suelen funcionar de otra forma: un archivo índice corto se carga siempre, mientras que los archivos temáticos más extensos el agente los carga solo cuando los necesita, algo parecido a un índice que apunta a páginas de detalle.
Compactación
Si el contexto dentro de una sesión en curso se llena demasiado, el agente resume automáticamente las partes más antiguas de la conversación (compactación) para hacer espacio. Es un mecanismo distinto al de los archivos persistentes: actúa dentro de una sesión, no entre sesiones.
EJEMPLO
Ejemplo de reparto: en CLAUDE.md pone 'Los tests se ejecutan con npm test, nunca uses npm run test:ci en local' (semántico, duradero). En un archivo de memoria pone 'Sesión del 12/07: la migración con db:push falló por una violación de clave foránea; la próxima vez probar primero db:migrate:dry-run' (episódico, ligado a un evento concreto).
QUIZ RÁPIDO
¿Qué distingue mejor a una nota de memoria episódica de una regla en CLAUDE.md?
FUENTES
- Claude Code Doku: CLAUDE.md und Auto Memory ↗ code.claude.com
- Anthropic: Effective Context Engineering for AI Agents ↗ www.anthropic.com
- agents.md: AGENTS.md-Standard ↗ agents.md