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
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.