Usa un archivo de instrucciones para tu agente

# CLAUDE.md
- Proyecto: tienda online en Astro.
- Comandos: `npm run dev`, `npm run build`.
- Estilo: TypeScript estricto, sin dependencias nuevas sin avisar.
- No toques la carpeta /legacy.

Sin un archivo de instrucciones, cada sesión arranca de cero: le repetís al agente cómo se llama el proyecto, qué comandos usar y qué no tocar, y aun así improvisa. Un archivo como CLAUDE.md o AGENTS.md en la raíz del repo concentra esas reglas en un solo lugar que el agente lee solo al empezar. Es la diferencia entre uno que adivina tu forma de trabajar y uno que ya la conoce. Escribís las reglas una vez y se aplican en cada sesión.

Cómo aplicarlo

1. Crea el archivo en la raíz. CLAUDE.md para Claude Code, AGENTS.md para varios agentes. Ahí lo busca solo.
2. Empieza por lo esencial. Qué es el proyecto, su stack y los comandos clave (cómo levantarlo, cómo testear, cómo buildear).
3. Escribe las reglas como órdenes. “Usa TypeScript estricto”, “no agregues dependencias sin avisar”, “no toques /legacy”. Cortas y claras.
4. Mantenelo corto y vivo. Si una regla deja de valer, bórrala. Un archivo inflado se ignora; uno preciso se respeta.

Antes y después

Sin archivo, lo repetís en cada chat:

Acuérdate: esto es Astro, usa TS estricto, no instales nada
sin preguntar y no toques la carpeta legacy... (otra vez)

Con archivo, lo escribís una vez:

# CLAUDE.md
- Proyecto: tienda online en Astro.
- Comandos: `npm run dev`, `npm run build`.
- Estilo: TypeScript estricto, sin dependencias nuevas sin avisar.
- No toques la carpeta /legacy.

Llévalo más lejos

• Reglas por carpeta. Algunos agentes leen archivos de instrucciones anidados; pon reglas específicas dentro del módulo al que aplican.
• Documenta las decisiones, no solo el estilo. Anota por qué algo es como es (“no migrar a X porque rompe Y”); evita que el agente “arregle” lo que no debe.
• Versionalo con el repo. Al estar en git, el archivo evoluciona con el proyecto y todo el equipo (y cada agente) trabaja con las mismas reglas.