--- title: "Generador de AGENTS.md con reglas para cinco agentes de código · DotsAgent" description: "Completa un formulario para generar un AGENTS.md, la misma regla por ruta para Cursor, Copilot, Claude Code, Cline y Devin, y archivos puente para Gemini CLI y Aider." url: https://dotsagent.io/es/instructions --- Instruir · herramienta # Generador de AGENTS.md Completa un formulario y obtén un AGENTS.md con tus comandos, convenciones y límites estrictos. También obtendrás una regla específica por ruta para Cursor, GitHub Copilot, Claude Code, Cline y Devin Desktop, además de archivos puente para las herramientas que no detectan AGENTS.md de forma predeterminada. [Dónde busca cada herramienta sus archivos de instrucciones →](https://dotsagent.io/es/instructions/files) `AGENTS.md` ``` # Aplicación web Acme Una aplicación web para clientes con un área de administración y una pequeña API REST. ## Stack Next.js, React, TypeScript, pnpm ## Comandos - Instalación: `pnpm install` - Ejecución local: `pnpm dev` - Pruebas: `pnpm test` - Lint y comprobación de tipos: `pnpm lint && pnpm tsc --noEmit` - Build: `pnpm build` ## Estilo de código - Sigue el formato que exige el linter y deja intactos los archivos que no necesites modificar. - Prefiere funciones pequeñas con entradas y salidas claras; limita los efectos secundarios a los extremos. - Pregunta antes de añadir una dependencia nueva. - Comenta el motivo del código que no sea evidente, no lo que hace cada línea. ## Pruebas - Añade o actualiza una prueba por cada comportamiento que cambies. - Ejecuta el comando de pruebas y corrige los errores antes de dar la tarea por terminada. - No elimines ni omitas una prueba fallida para que la suite pase. ## Commits y pull requests - Escribe los asuntos de los commits en imperativo y con menos de 72 caracteres. - Limita cada pull request a un solo cambio e indica en la descripción cómo lo has probado. - Ejecuta el linter y las pruebas antes de cada commit. ## Nunca - No incluyas nunca secretos, claves de API ni archivos .env en un commit. - No edites nunca a mano los archivos generados de src/generated/; vuelve a generarlos. - No ejecutes nunca comandos destructivos de base de datos en producción. - No hagas nunca force-push a main ni reescribas el historial compartido. ``` ### La misma regla para cinco herramientas Una regla en cinco formatos; guarda cada archivo en la ruta que aparece encima. `.cursor/rules/scoped.mdc` ``` --- description: Convenciones para los archivos que coincidan con este glob globs: app/**/*.tsx alwaysApply: false --- Sigue los patrones que ya usan los archivos cercanos de esta carpeta. Cada función exportada debe tener un docstring y una prueba en el archivo de pruebas correspondiente. ``` `.github/instructions/scoped.instructions.md` ``` --- applyTo: "app/**/*.tsx" --- Sigue los patrones que ya usan los archivos cercanos de esta carpeta. Cada función exportada debe tener un docstring y una prueba en el archivo de pruebas correspondiente. ``` `.claude/rules/scoped.md` ``` --- paths: - "app/**/*.tsx" --- Sigue los patrones que ya usan los archivos cercanos de esta carpeta. Cada función exportada debe tener un docstring y una prueba en el archivo de pruebas correspondiente. ``` `.clinerules/scoped.md` ``` --- paths: - "app/**/*.tsx" --- Sigue los patrones que ya usan los archivos cercanos de esta carpeta. Cada función exportada debe tener un docstring y una prueba en el archivo de pruebas correspondiente. ``` `.devin/rules/scoped.md` ``` --- trigger: glob globs: app/**/*.tsx --- Sigue los patrones que ya usan los archivos cercanos de esta carpeta. Cada función exportada debe tener un docstring y una prueba en el archivo de pruebas correspondiente. ``` ## Cómo crear un archivo de instrucciones eficaz ### Incluye los comandos exactos al principio Enumera al principio del archivo los comandos reales para instalar, probar y ejecutar el linter, con sus flags. Especifica la tecnología y las versiones exactas, y añade un breve ejemplo de código cuando la prosa resulte ambigua. Blog de GitHub, análisis de más de 2.500 archivos AGENTS.md ### Indica claramente qué no debe hacerse Especifica con claridad qué no debe hacer el agente, como modificar secretos, código de terceros incluido en el repositorio o el entorno de producción. «No hagas commit de secretos» fue la restricción útil más habitual en los archivos que revisó GitHub. Blog de GitHub, análisis de más de 2.500 archivos AGENTS.md ### Haz que cada instrucción se pueda comprobar «Ejecuta npm test antes de hacer commit» se puede verificar; «prueba tus cambios», no. Elimina las contradicciones: si dos líneas no coinciden, el modelo puede seguir cualquiera de ellas. Documentación de memoria de Claude Code ### Sé breve y separa las reglas por ruta Anthropic recomienda no superar las 200 líneas por archivo y Cursor, las 500 por regla. Traslada las indicaciones específicas de una zona a una regla asociada a una ruta para que solo se cargue cuando se trabaje con esos archivos. Las importaciones ordenan el archivo, pero no reducen el coste de contexto. Documentación de memoria de Claude Code; documentación de Cursor Rules ### Omite lo que el agente ya sabe En un estudio con cuatro agentes de programación, los archivos de contexto no mejoraron de forma consistente el éxito en las tareas y aumentaron el coste de inferencia en más de un 20%. Los archivos escritos por LLM perjudicaron ligeramente los resultados y las descripciones generales de los repositorios no ayudaron. Limita el archivo a requisitos que no sean obvios, como herramientas específicas. ETH Zurich SRI Lab, arXiv 2602.11988 ### Añade reglas cuando se repitan los errores Empieza con poco y añade una línea cuando veas que el agente comete el mismo error más de una vez. Usa un archivo existente como referencia en lugar de pegar una guía de estilo completa. Documentación de Cursor Rules; blog de GitHub ## Preguntas sobre AGENTS.md ### ¿Claude Code lee AGENTS.md? Sí, desde la versión v2.1.277. De forma predeterminada, solo lee AGENTS.md o .claude/AGENTS.md cuando no hay ningún CLAUDE.md, .claude/CLAUDE.md ni CLAUDE.local.md en el directorio de trabajo o en sus directorios superiores. El ajuste claude-md-and-agents-md carga ambos, y un CLAUDE.md que contenga @AGENTS.md funciona en cualquier versión. ### ¿AGENTS.md necesita frontmatter o encabezados específicos? No. AGENTS.md es un archivo Markdown sin campos obligatorios y puedes usar los encabezados que quieras. El sitio agents.md sugiere secciones como una descripción general del proyecto, comandos para compilar y ejecutar pruebas, estilo de código, pruebas, notas de seguridad y pautas para pull requests. ### ¿Cómo uso AGENTS.md en un monorepo? Coloca un AGENTS.md en la raíz y otro dentro de cada paquete que necesite sus propias reglas. Los agentes leen el archivo más cercano al código que se está editando; si hay conflictos, prevalece ese archivo. Cuando agents.md documentó el repositorio principal de OpenAI, este tenía 88 archivos de este tipo. ### ¿Cómo hago que Gemini CLI lea AGENTS.md? Gemini CLI sigue usando GEMINI.md de forma predeterminada. Añade AGENTS.md a context.fileName en .gemini/settings.json, por ejemplo ["AGENTS.md", "GEMINI.md"]. Ejecuta /memory show para comprobar qué se ha cargado. ### ¿Qué agentes de programación son compatibles con AGENTS.md? Revisamos la documentación de OpenAI Codex, Claude Code, Cursor, GitHub Copilot, Devin Desktop, Cline y OpenClaw, que leen el archivo de forma nativa. Gemini CLI y Aider necesitan una línea de configuración. El sitio agents.md enumera un total de 23 herramientas compatibles, entre ellas Zed, Warp, goose, opencode, Jules y JetBrains Junie. ### ¿Quién mantiene el formato AGENTS.md? OpenAI aportó AGENTS.md a Agentic AI Foundation, un fondo dirigido por Linux Foundation que se anunció el 2025-12-09 junto con MCP y goose. Según el sitio agents.md, más de 60k proyectos de código abierto lo utilizan. Referencia independiente para quienes crean agentes de IA. No estamos afiliados a ninguno de los proveedores mencionados aquí. © 2026 DotsAgent · Datos verificados el 1 de octubre de 2026