Instrucciones de proyecto para la IA (AGENTS.md)
Para no repetir «sin librerías, en español, accesible» en cada conversación, escribe un AGENTS.md corto y concreto que tu asistente lea solo, y comprueba que lo respeta.
Un fichero de instrucciones de proyecto se carga solo en cada conversación: así no tienes que repetir tus reglas ni la IA las «olvida».
AGENTS.md, en la raíz del proyecto, es el formato común: lo leen Copilot en VS Code, Codex, Cursor y las versiones recientes de Claude Code.
Un buen AGENTS.md es corto y concreto: qué es el proyecto, tecnologías y límites, estilo de código, accesibilidad, cómo comprobar y qué no hacer.
Nada de secretos ni de reglas vagas como «escribe buen código».
- Escribes tus reglas una vez y la herramienta las lee siempre.
- Cada conversación con un asistente empieza de cero. Si tu proyecto es HTML, CSS y JavaScript sin librerías, con clases en español y pensado para teclado, tienes que decirlo cada vez. Si se te olvida, es fácil que aparezcan jQuery, un div con onclick o nombres en inglés.
- Un fichero de instrucciones de proyecto evita repetirlo: es un Markdown en tu repositorio que la herramienta añade sola al contexto de cada petición. Escribes tus reglas una vez, las versionas con Git y valen para ti, para tus compañeros y para cualquier agente que trabaje en el proyecto.
- Cada herramienta busca un nombre, pero AGENTS.md lo leen casi todas.
- FicheroDóndeLo leen AGENTS.mdRaíz del proyecto (y subcarpetas, si hace falta)Copilot en VS Code, Codex, Cursor, Claude Code (versiones recientes) y otros .github/copilot-instructions.mdCarpeta .githubGitHub Copilot CLAUDE.mdRaíz del proyectoClaude Code .cursor/rules/*.mdcCarpeta .cursor/rulesCursor (reglas por tipo de fichero)
Por qué un fichero de instrucciones
Escribes tus reglas una vez y la herramienta las lee siempre.
Cada conversación con un asistente empieza de cero. Si tu proyecto es HTML, CSS y JavaScript sin librerías, con clases en español y pensado para teclado, tienes que decirlo cada vez. Si se te olvida, es fácil que aparezcan jQuery, un div con onclick o nombres en inglés.
Un fichero de instrucciones de proyecto evita repetirlo: es un Markdown en tu repositorio que la herramienta añade sola al contexto de cada petición. Escribes tus reglas una vez, las versionas con Git y valen para ti, para tus compañeros y para cualquier agente que trabaje en el proyecto.
Dónde va cada fichero
Cada herramienta busca un nombre, pero AGENTS.md lo leen casi todas.
FicheroDóndeLo leen AGENTS.mdRaíz del proyecto (y subcarpetas, si hace falta)Copilot en VS Code, Codex, Cursor, Claude Code (versiones recientes) y otros .github/copilot-instructions.mdCarpeta .githubGitHub Copilot CLAUDE.mdRaíz del proyectoClaude Code .cursor/rules/*.mdcCarpeta .cursor/rulesCursor (reglas por tipo de fichero)
Recomendación: escribe tus reglas en AGENTS.md, que es un formato abierto y compartido. Si una herramienta no lo lee, no copies el texto: enlázalo. Por ejemplo, en Claude Code antiguo basta un CLAUDE.md con la línea @AGENTS.md, que importa el fichero. (Así en octubre de 2026; las herramientas cambian a menudo, revisa su documentación.)
Qué poner: seis bloques cortos
Entre 20 y 50 líneas suelen bastar.
Qué no poner
Cada línea ocupa contexto.
- Secretos: claves, contraseñas, URLs privadas. El fichero va en el repositorio y lo lee cualquier herramienta.
- Reglas vagas que no cambian nada: «escribe buen código», «sé profesional». Sustitúyelas por algo comprobable.
- Explicaciones largas o tutoriales: si hace falta contexto, enlaza el documento del proyecto que lo explica.
- Contradicciones: «sin librerías» en un sitio y «usa Bootstrap» en otro. La IA elegirá una al azar.
Comprobar que lo respeta
Pide algo que vaya contra una regla y mira qué hace.
Abre una conversación nueva en tu editor y pide algo que choque con una regla: «Añade un carrusel de proyectos usando una librería de sliders». Si el asistente responde que el proyecto no usa librerías y te propone una solución nativa, las instrucciones se están cargando.
Si no las respeta, comprueba el nombre y la ubicación del fichero, que la herramienta tenga activada la lectura de instrucciones (en VS Code se ven en la lista de referencias de la respuesta) y que la regla esté escrita de forma clara y sin contradicciones.