CLAUDE.md / AGENTS.md: memoria y reglas para tu agente

Un archivo CLAUDE.md es una especie de chuleta que tu agente de código lee automáticamente en cada tarea.

El problema sin memoria

Un agente de IA empieza de cero en cada sesión nueva. No sabe qué reglas de código tiene tu equipo, qué comandos se usan para testear, o que nunca hacéis push directo a main, a menos que se lo digas cada vez de nuevo.

La solución: un archivo de reglas

CLAUDE.md (en algunas herramientas se llama AGENTS.md) es un simple archivo markdown en la carpeta raíz de tu proyecto. El agente lo lee automáticamente al principio de cada sesión y trata su contenido como instrucción fija, como una memoria que persiste más allá de cada chat individual.

¿Qué debe incluir?

Contexto del proyecto ("Esto es un frontend en React con backend en Express")
Comandos ("Los tests se ejecutan con npm test")
Reglas ("Nunca hacer push directo a main", "Ejecutar siempre los tests antes de hacer commit")
Estilo de código
Trampas conocidas del proyecto

Por qué funciona

Sin este archivo, tendrías que repetir las mismas reglas en cada sesión nueva. Con él, las reglas base siempre están presentes: el agente se comporta de forma más consistente y comete menos errores evitables.