AGENTS.md vs CLAUDE.md vs .cursor/rules vs copilot-instructions.md vs GEMINI.md en proyectos de apps
Cada agente de programación tiene su propio archivo de instrucciones, pero a estas alturas la mayoría también lee AGENTS.md. Para una app web que se publica como apps de iOS y Android, lo más limpio es una sección común sobre la app nativa en AGENTS.md y archivos mínimos por herramienta que remitan a ella. Aquí tienes quién lee qué y la sección para copiar.
Desde $109 de pago único por plataforma, o deja que nuestro equipo lo haga todo desde $698.
Garantía de aprobación – o te devolvemos el dinero en 14 días
Sin programar
Pago único, actualizaciones gratuitas
Soporte humano 24/7
Hecho en Alemania desde 2014 · ISO 27001
9:41
Tu app
Tu appYa en tu bolsillo
App Store · Google Play Aprobada
Quién lee qué archivo (a noviembre de 2026)
Archivo
Lo leen
Ubicación y alcance
Conviene saber
AGENTS.md
Codex, Cursor, GitHub Copilot (cloud agent, revisión de código, VS Code), Devin Desktop (antes Windsurf), Jules, Zed, Aider y más; Claude Code cuando no existe un CLAUDE.md
Markdown simple, sin front matter. Raíz y subcarpetas; gana el archivo más cercano al código editado
Formato abierto, ahora bajo la tutela de la Agentic AI Foundation, dentro de la Linux Foundation
CLAUDE.md
Claude Code; GitHub Copilot también acepta un único CLAUDE.md en la raíz
./CLAUDE.md o ./.claude/CLAUDE.md, el personal CLAUDE.local.md, el global del usuario ~/.claude/CLAUDE.md; reglas por ruta en .claude/rules/
Importa con @path; apunta a menos de 200 líneas. Si existe, Claude Code lo lee en lugar de AGENTS.md, salvo que importe AGENTS.md
.cursor/rules/*.mdc
El agente de Cursor
Front matter description, globs, alwaysApply; tipos Always Apply, Apply Intelligently, Apply to Specific Files, Apply Manually
Deben ser .mdc; menos de 500 líneas por regla. Bugbot las ignora y lee .cursor/BUGBOT.md
.github/copilot-instructions.md
GitHub Copilot: VS Code, Chat en GitHub.com, cloud agent, revisión de código
Para todo el repositorio; añade .github/instructions/*.instructions.md con globs applyTo para rutas concretas
excludeAgent aparta un archivo por ruta de la revisión de código o del cloud agent (guía de Copilot)
GEMINI.md
Gemini CLI y su sucesor de 2026, Antigravity CLI (compatible con versiones anteriores); GitHub Copilot acepta un único GEMINI.md en la raíz
Global ~/.gemini/GEMINI.md más archivos en el workspace y sus carpetas superiores; importa con @file.md
Gemini CLI puede cargar AGENTS.md mediante el ajuste context.fileName; Antigravity CLI recomienda renombrarlo a AGENTS.md
.devin/rules/*.md
Devin Desktop (antes Windsurf)
Front matter trigger: always_on, glob, model_decision, manual
Los antiguos .windsurf/rules y .windsurfrules se siguen cargando; AGENTS.md se lee como regla siempre activa (guía de Windsurf)
La recomendación: una sola fuente y adaptadores mínimos
Escribe el conocimiento sobre la app nativa una sola vez, en AGENTS.md, porque casi todos los agentes lo leen. Después dale a cada herramienta solo lo que no puede sacar de ahí: a Claude Code una línea de importación, a Cursor una regla con alcance limitado para los archivos de interfaz, a Copilot un archivo breve en el repositorio y a Gemini una importación o un ajuste.
¿Para qué mantener los archivos adicionales? Por dos motivos. Algunas herramientas prefieren su propio archivo cuando existen ambos (Claude Code lee CLAUDE.md en lugar de AGENTS.md si encuentra uno), y el alcance depende de cada herramienta: globs, applyTo y las reglas por ruta solo existen en los formatos propios. Una regla que solo se carga cuando el agente edita un componente es el mejor sitio para el checklist de diseño móvil.
Los enlaces simbólicos también funcionan (la web de AGENTS.md sugiere renombrar el archivo antiguo y enlazarlo de vuelta), pero se rompen con facilidad en checkouts de Windows y no se ven en la revisión de código. Las importaciones y los archivos breves que remiten a otro dicen lo que hacen. Para saber cómo deben leer los agentes la propia referencia de WebViewGold, consulta la guía de llms.txt.
La sección común sobre la app nativa (pégala en AGENTS.md)
## Native app (WebViewGold): read before changing UI, auth or payments
Runtime
- Production: https://app.example.com. WebViewGold loads it in a WKWebView (iOS) and
an Android WebView. Every deploy is live in the store apps; there is no mobile codebase.
- In the app, the user agent contains "MyAppNative" (useragent_iphone / useragent_ipad
in Config.swift, USER_AGENT in Config.java). Check it only through isNativeApp()
in src/lib/platform.ts.
Native bridge (app only, always with a web fallback)
- Trigger by navigation: window.location.href = "scheme://..."
- Push permission: registerpush:// | iOS status: checkNativePushPermissions:// -> nativePushEnabled
- Share sheet: shareapp://message?=TEXT&url=URL
- Haptics: lighthaptic://, successhaptic://, errorhaptic://
- Biometrics: bioauth:// (iOS calls onBioAuthSuccess, onBioAuthFailure, onBioAuthUnavailable)
- QR code: qrcode:// | App version: getappversion:// -> versionNumber
- Anything else: look it up in https://www.webviewgold.com/llms-full.txt. Never invent a scheme.
Store invariants (Apple and Google review)
- /privacy and /terms are real pages, linked from footer and settings.
- Sign-up exists => in-app account deletion (server-side) and a public /delete-account page.
- Google or other social login => Sign in with Apple with equal prominence.
- Digital goods in the iOS app use in-app purchase; no external checkout links there.
- Loading, empty and error states everywhere; no placeholders, dead links or "coming soon".
- Works from 320 px; fixed bars pad env(safe-area-inset-*); tap targets >= 44 px.
- OAuth never in popups or new windows (the Social Login Helper handles Google).
Done means
- Lint, tests and build pass; works in a desktop browser and at 320 px; native calls sit
behind isNativeApp(); the summary lists what must be tested on a real phone.
¡Estoy muy feliz de haber comprado esta aplicación! Documentación extremadamente fácil y excelente. Estaba en contacto con el servicio al cliente, respondieron muy rápido y de forma muy amigable. Resolvieron mi pregunta en un día. 10/10 lo recomendaría".
Cada archivo tiene unas pocas líneas; las líneas que empiezan por ==> solo marcan dónde empieza un archivo nuevo. Para Gemini CLI puedes prescindir de GEMINI.md y poner en su lugar "AGENTS.md" en context.fileName dentro de .gemini/settings.json.
markdown
==> CLAUDE.md
@AGENTS.md
## Claude Code only
- Use plan mode before changes to auth, payments or account deletion.
==> .cursor/rules/mobile-ui.mdc
---
description: Mobile layout rules for screens shown in the native WebView apps
globs: src/components/**/*.tsx, src/app/**/*.tsx, src/**/*.css
alwaysApply: false
---
- No horizontal overflow at 320 px; tap targets >= 44 px; inputs >= 16 px font size.
- Fixed bars pad env(safe-area-inset-top) and env(safe-area-inset-bottom).
- No hover-only interactions.
==> .github/copilot-instructions.md
Follow the "Native app (WebViewGold)" section in AGENTS.md for every change.
In code review, flag any change that breaks the store invariants listed there.
==> GEMINI.md
@AGENTS.md
Configúralo en cuatro pasos
Quince minutos, y a partir de ahí todos los agentes trabajan con las mismas reglas.
Haz inventario de lo que tienes
Enumera todos los archivos de instrucciones del repositorio: AGENTS.md, CLAUDE.md, .claude/rules, .cursor/rules, .cursorrules, .github/copilot-instructions.md, .github/instructions, GEMINI.md, .windsurfrules, .windsurf/rules, .devin/rules. Los archivos antiguos se siguen cargando aunque te hayas olvidado de ellos.
Fusiónalo todo en AGENTS.md
Pega la sección común, pasa a ella los comandos de compilación y las convenciones de los archivos antiguos y resuelve las contradicciones. El prompt de abajo hace el trabajo pesado.
Sustituye los archivos de cada herramienta por adaptadores
CLAUDE.md importa AGENTS.md; Cursor conserva solo reglas .mdc con alcance limitado; Copilot recibe un archivo breve que remite a AGENTS.md; Gemini recibe una importación o el ajuste context.fileName.
Comprueba que cada herramienta lo carga
Claude Code: ejecuta /context y mira en Memory files. Gemini CLI: /memory show. Copilot Chat en GitHub.com: el archivo de instrucciones aparece en las referencias de la respuesta. Cursor y Devin Desktop: pide al agente que te repita las invariantes de las tiendas.
Prompt: unifica tus archivos de instrucciones
Funciona en Claude Code, Codex, Cursor, el modo agente de Copilot o Devin Desktop. Pega al final la sección común de esta página.
Pégalo en cualquier agente de programación en la raíz del repositorio
Unifica los archivos de instrucciones para agentes de IA de este repositorio para que todas las herramientas reciban las mismas reglas sobre la app nativa. Es una app web que también se publica como apps de iOS y Android mediante WebViewGold, que carga nuestra URL de producción en un WebView nativo.
1. Encuentra todos los archivos de instrucciones: AGENTS.md (en cualquier carpeta), CLAUDE.md, .claude/CLAUDE.md, .claude/rules/, .cursor/rules/, .cursorrules, .github/copilot-instructions.md, .github/instructions/, GEMINI.md, .windsurfrules, .windsurf/rules/, .devin/rules/. Muéstrame una tabla: archivo, qué contiene, conflictos con otros archivos.
2. Crea o actualiza el AGENTS.md de la raíz: descripción del proyecto, comandos, convenciones y la sección "Native app (WebViewGold)" que pego abajo. Pregúntame por los conflictos en lugar de adivinar.
3. Sustituye los archivos específicos de cada herramienta por adaptadores mínimos: un CLAUDE.md que importe @AGENTS.md más notas solo para Claude; .cursor/rules/*.mdc solo para reglas con alcance por globs; un .github/copilot-instructions.md que remita a AGENTS.md y pida a la revisión de código que compruebe las invariantes de las tiendas; un GEMINI.md que importe @AGENTS.md. Elimina .cursorrules y .windsurfrules después de trasladar su contenido.
4. Deja fuera de todos estos archivos los secretos, los tokens y las URL personales.
5. Muestra el diff final y dime cómo comprobar que cada herramienta carga las reglas.
Sección de la app nativa:
[pega aquí la sección de esta página]
Checklist
La sección de la app nativa solo existe en AGENTS.md; todos los demás archivos la importan o remiten a ella.
La URL de producción y el marcador del user agent coinciden con Config.swift y Config.java.
CLAUDE.md importa AGENTS.md; si no, Claude Code ignora AGENTS.md por defecto.
Todas las reglas de Cursor usan .mdc; las reglas de Bugbot están en .cursor/BUGBOT.md si usas Bugbot.
Los archivos respetan las recomendaciones de cada herramienta: CLAUDE.md por debajo de unas 200 líneas, reglas de Cursor por debajo de 500.
Ningún secreto, token ni contraseña de staging en ningún archivo de instrucciones.
Errores típicos
Deriva por copiar y pegar: tres copias de las reglas de las tiendas, dos de ellas desactualizadas. Los agentes siguen la copia que leen.
Un CLAUDE.md sin la línea de importación. Entonces Claude Code ignora AGENTS.md por defecto.
Los archivos .md normales en .cursor/rules se ignoran; solo cuentan los archivos .mdc.
Archivos antiguos que se siguen cargando: .windsurfrules y .windsurf/rules en Devin Desktop, y un viejo .cursorrules que quizá todavía se lea. Las contradicciones antiguas vuelven a colarse.
Pegar toda la referencia de WebViewGold en las instrucciones. Los archivos largos reducen el grado de cumplimiento; enumera los esquemas que usas y enlaza llms-full.txt para el resto.
Depender de memorias generadas automáticamente (la auto memory de Claude Code, las memorias de Windsurf) para las reglas del equipo. Viven en un solo equipo y no viajan con el repositorio.
Preguntas frecuentes
¿Necesito todos estos archivos?
No. Si solo usas una herramienta, basta con su archivo propio. Con dos o más herramientas, haz de AGENTS.md la fuente y añade adaptadores solo para las herramientas que los necesiten.
¿Claude Code ya lee AGENTS.md?
Sí. Las versiones actuales de Claude Code leen AGENTS.md cuando no hay un CLAUDE.md en el directorio de trabajo ni en los superiores. Si tienes un CLAUDE.md, añade una importación @AGENTS.md para que se usen ambos.
¿GEMINI.md sigue siendo relevante?
Menos que antes. En 2026 Google sustituyó Gemini CLI por Antigravity CLI, que sigue leyendo GEMINI.md por compatibilidad pero recomienda AGENTS.md. GitHub Copilot también acepta un único GEMINI.md en la raíz.
¿Dónde encajan las reglas de Windsurf?
Windsurf ahora es Devin Desktop. Lee AGENTS.md como regla siempre activa, además de .devin/rules y los antiguos .windsurf/rules y .windsurfrules, así que la configuración con AGENTS.md lo cubre.
¿Enlace simbólico o importación?
Ambos funcionan. Las importaciones (CLAUDE.md y GEMINI.md admiten la sintaxis @file) son explícitas y sobreviven a los checkouts de Windows; los enlaces simbólicos no se ven en la revisión de código y se rompen con facilidad.
¿Las reglas de las tiendas van en el archivo de instrucciones o en un checklist?
En ambos. El archivo de instrucciones mantiene conforme cada cambio futuro; un checklist o un skill de preparación ejecuta la auditoría completa antes de cada envío.
Tres formas de llevar tu app a las tiendas
El mismo resultado, con distinta cantidad de trabajo por tu parte. Las tres incluyen la garantía de aprobación y soporte humano 24/7.
Hazlo tú mismo
$109 por plataforma, pago único
La licencia de WebViewGold: un proyecto de Xcode o Android Studio listo para usar. Pega tu URL, define nombre e icono, activa funciones, compila y envía. Actualizaciones gratuitas para siempre.
Sin Mac, sin Xcode, sin Android Studio: configura en el navegador, compilamos ambas apps en la nube y las entregamos a App Store Connect y a Play Console.
Envíanos tu URL y tu icono. Nuestro equipo configura, compila y entrega tu app en 72 horas, en marca blanca y con los proyectos fuente. Ambas plataformas por $1,158.
Los reembolsos se conceden bajo las condiciones indicadas en nuestras FAQ: un rechazo por motivos ajenos al contenido por parte de Apple y/o Google, reclamado dentro de los 14 días posteriores a la compra.