Tools mentioned in this article
Open the browser-based tool while you read and try the workflow immediately.
Claude Code, Cursor, GitHub Copilot, Windsurf, Gemini CLI ― cuantas más herramientas de codificación con IA adopta, más se plantea la pregunta: ¿en qué archivo van las reglas del proyecto? El Generador de reglas de IA responde exactamente eso: un formulario, y genera los archivos de reglas para seis herramientas principales a la vez, todo en su navegador.
El problema de “cada herramienta tiene su propio archivo de reglas”
Cada herramienta de codificación con IA lee las convenciones del proyecto desde su propia ubicación.
| Herramienta | Archivo que lee |
|---|---|
| OpenAI Codex / Google Jules y otros | AGENTS.md |
| Claude Code | CLAUDE.md |
| Cursor | .cursor/rules/*.mdc |
| GitHub Copilot | .github/copilot-instructions.md |
| Windsurf | .windsurfrules |
| Gemini CLI | GEMINI.md |
Cuando los miembros del equipo usan herramientas diferentes, las mismas reglas terminan copiadas y pegadas en varios archivos. Semanas después llega el incidente clásico: “CLAUDE.md se actualizó, pero las reglas de Cursor siguen siendo la versión antigua.”
Convertir AGENTS.md en la fuente única de verdad
La respuesta práctica es derivar todos los archivos específicos de cada herramienta a partir de una única fuente canónica.
AGENTS.md es la elección natural para esa fuente canónica: un estándar abierto para describir su proyecto a los agentes de codificación con IA — un “README para agentes” — cuya adopción se está extendiendo entre herramientas como OpenAI Codex y Google Jules.
Esta herramienta sigue exactamente ese diseño. La entrada de su formulario construye primero el AGENTS.md, y los otros cinco archivos se derivan de él. CLAUDE.md, copilot-instructions.md, .windsurfrules y GEMINI.md comparten el cuerpo textualmente; solo el .mdc de Cursor recibe un bloque de frontmatter MDC (description más alwaysApply: true) al principio. Como el contenido siempre coincide entre todos los archivos, la desincronización por copiar y pegar es estructuralmente imposible.
Cómo usarlo
- Abra el Generador de reglas de IA y complete el formulario:
- Nombre y descripción del proyecto — el primer contexto que lee la IA
- Stack tecnológico — separado por comas o saltos de línea (p. ej.,
TypeScript, React, Vite) - Comandos — servidor de desarrollo, build, test y lint
- Convenciones de código / prohibiciones — un elemento por línea
- Estructura de directorios y notas — opcional (las secciones vacías se omiten automáticamente de la salida)
- Elija el idioma de salida (inglés / japonés) y haga clic en generar.
- Aparecen seis archivos en pestañas. Cópielos individualmente, o use la descarga en ZIP — el archivo incluye la estructura de directorios
.cursor/rules/y.github/, así que extraerlo en la raíz del repositorio deja todo en su sitio.
La generación se ejecuta enteramente en JavaScript del navegador; los detalles de su proyecto nunca se envían a un servidor.
Qué debería contener un archivo de reglas
El contenido con más impacto en la calidad de las sugerencias del agente es el conocimiento que es difícil de deducir leyendo el código:
- Comandos de verificación — cómo ejecutar tests, lint y build. Esto permite al agente verificar sus propios cambios
- Convenciones específicas del proyecto — “solo componentes de función”, “todo el manejo de fechas vía dayjs” — el estilo propio del código base
- Prohibiciones — “nunca usar
any”, “nunca editar archivos generados”, “nunca hacer commit de.env” — declaraciones explícitas de lo que no quiere
Por el contrario, la información que el agente puede leer del código (listados de archivos, descripciones de funciones) no necesita explicarse. Unas reglas demasiado largas entierran las instrucciones importantes, así que empiece por esas tres categorías, de forma concisa.
Consejos de uso
- Trate la salida como un andamiaje — revísela en equipo y ajústela a la realidad
- Fusione, no sobrescriba, los archivos existentes — si ya mantiene un CLAUDE.md, compare las diferencias antes de integrar
- Sin secretos — los archivos de reglas se hacen commit. Mantenga fuera las claves de API y las URLs internas
- Actualice a través de la herramienta — cuando cambien las reglas, regenere; los seis archivos se mantienen sincronizados
Preguntas frecuentes
¿Por qué se generan varios archivos con el mismo contenido?
Porque cada agente busca un nombre de archivo distinto. Claude Code lee CLAUDE.md, Cursor lee .cursor/rules/, GitHub Copilot lee .github/copilot-instructions.md, Windsurf lee .windsurfrules y Gemini CLI lee GEMINI.md. El contenido puede ser el mismo, así que esta herramienta trata AGENTS.md como única fuente de verdad y deriva de él los demás.
¿Por qué el archivo de Cursor tiene líneas adicionales al principio?
Porque el formato .mdc de Cursor espera frontmatter. El bloque generado contiene tres campos: description (qué es la regla), globs (a qué patrones de archivo se aplica) y alwaysApply: true. Si quiere aplicarla solo a ciertos directorios, añada patrones a globs después de generar; si se deja vacío, se aplica a todo.
¿Hay que regenerar todos los archivos cuando cambian las reglas?
Sí, pero no debería editar seis archivos a mano. El planteamiento que mejor aguanta es tratar AGENTS.md como la única copia autorizada y regenerar el resto con esta herramienta cada vez que cambie. Editar directamente los archivos derivados es la vía rápida para no saber cuál está actualizado.
¿Conviene generar la salida en inglés o en otro idioma?
Los agentes entienden ambos, así que la regla práctica es usar el mismo idioma que el resto del repositorio. Si los comentarios y el README están en inglés, use inglés. Los identificadores que escriba en las reglas —nombres de comandos, rutas de directorios— se transmiten igual en cualquier caso.
¿Se envía a algún sitio lo que escribo?
No. El generador de reglas para IA funciona íntegramente en su navegador, así que una estructura de proyecto sin publicar o una convención interna que introduzca nunca se transmite.
Resumen
- Cada herramienta de codificación con IA lee un archivo de reglas diferente, así que el mantenimiento manual se desincroniza
- Derivar todo desde AGENTS.md mantiene las reglas idénticas entre herramientas
- Escriba lo que el código no puede expresar: comandos de verificación, convenciones propias, prohibiciones
Si usa más de una herramienta de IA, empiece generando un conjunto completo y coherente con el Generador de reglas de IA.