AGENTS.md vs CLAUDE.md vs .cursor/rules vs copilot-instructions.md vs GEMINI.md pour les projets d'app
Chaque agent de code a son propre fichier d'instructions, mais la plupart lisent désormais aussi AGENTS.md. Pour une web app publiée en apps iOS et Android, la configuration propre consiste en une seule section partagée sur l'app native dans AGENTS.md, plus des fichiers d'outil légers qui y renvoient. Voici qui lit quoi, et la section à copier.
Dès $109 en paiement unique par plateforme, ou notre équipe s'occupe de tout dès $698.
Garantie d'approbation – ou remboursement sous 14 jours
Aucun codage requis
Paiement unique, mises à jour gratuites
Support humain 24/7
Conçu en Allemagne depuis 2014 · ISO 27001
9:41
Votre app
Votre appDésormais dans votre poche
App Store · Google Play Approuvée
Qui lit quel fichier (en novembre 2026)
Fichier
Lu par
Emplacement et portée
Bon à savoir
AGENTS.md
Codex, Cursor, GitHub Copilot (agent cloud, code review, VS Code), Devin Desktop (anciennement Windsurf), Jules, Zed, Aider et d'autres ; Claude Code quand il n'existe pas de CLAUDE.md
Markdown simple, sans front matter. Racine et sous-dossiers ; le fichier le plus proche du code modifié l'emporte
Format ouvert, désormais piloté par l'Agentic AI Foundation au sein de la Linux Foundation
CLAUDE.md
Claude Code ; GitHub Copilot accepte aussi un unique CLAUDE.md à la racine
./CLAUDE.md ou ./.claude/CLAUDE.md, CLAUDE.local.md personnel, ~/.claude/CLAUDE.md pour tous vos projets ; règles par chemin dans .claude/rules/
Imports avec @path ; visez moins de 200 lignes. S'il existe, Claude Code le lit à la place d'AGENTS.md, sauf s'il importe AGENTS.md
.cursor/rules/*.mdc
L'agent de Cursor
Front matter description, globs, alwaysApply ; types Always Apply, Apply Intelligently, Apply to Specific Files, Apply Manually
Extension .mdc obligatoire ; moins de 500 lignes par règle. Bugbot les ignore et lit .cursor/BUGBOT.md
.github/copilot-instructions.md
GitHub Copilot : VS Code, Chat sur GitHub.com, agent cloud, code review
Pour tout le dépôt ; ajoutez .github/instructions/*.instructions.md avec des globs applyTo pour cibler des chemins
excludeAgent tient un fichier ciblé à l'écart de la code review ou de l'agent cloud (guide Copilot)
GEMINI.md
Gemini CLI et son successeur de 2026, Antigravity CLI (rétrocompatible) ; GitHub Copilot accepte un unique GEMINI.md à la racine
~/.gemini/GEMINI.md global, plus les fichiers du workspace et de ses dossiers parents ; imports avec @file.md
Gemini CLI peut charger AGENTS.md via le réglage context.fileName ; Antigravity CLI recommande de renommer en AGENTS.md
.devin/rules/*.md
Devin Desktop (anciennement Windsurf)
Front matter trigger : always_on, glob, model_decision, manual
Les anciens .windsurf/rules et .windsurfrules se chargent encore ; AGENTS.md est lu comme une règle toujours active (guide Windsurf)
La recommandation : une seule source, des adaptateurs légers
Écrivez une seule fois les connaissances sur l'app native, dans AGENTS.md, car presque tous les agents le lisent. Donnez ensuite à chaque outil uniquement ce qu'il ne peut pas y trouver : à Claude Code une ligne d'import, à Cursor une règle ciblée pour les fichiers d'interface, à Copilot un court fichier de dépôt, à Gemini un import ou un réglage.
Pourquoi garder les fichiers supplémentaires ? Pour deux raisons. Certains outils préfèrent leur propre fichier quand les deux existent (Claude Code lit CLAUDE.md à la place d'AGENTS.md s'il en trouve un), et le ciblage dépend de l'outil : globs, applyTo et les règles par chemin n'existent que dans les formats natifs. Une règle qui ne se charge que lorsque l'agent modifie un composant est le meilleur endroit pour la checklist de mise en page mobile.
Les liens symboliques fonctionnent aussi (le site AGENTS.md suggère de renommer l'ancien fichier et de recréer un lien vers lui), mais ils cassent facilement sur les checkouts Windows et sont invisibles en code review. Les imports et les courts fichiers de renvoi disent ce qu'ils font. Pour savoir comment les agents doivent lire la référence WebViewGold elle-même, consultez le guide llms.txt.
La section partagée sur l'app native (à coller dans AGENTS.md)
Remplacez l'URL, le marqueur et le chemin du helper, et supprimez les schémas que vous n'utilisez pas. Chaque schéma présenté ici provient de la documentation WebViewGold iOS et Android. Des versions plus longues, propres à chaque outil : le modèle CLAUDE.md, le modèle AGENTS.md pour Codex et le modèle de règles Cursor.
markdown
## 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.
Je suis très content d'avoir acheté cette application ! Extrêmement facile et excellente documentation. J'ai été en contact avec le service client, ils ont répondu très rapidement et très amicalement. Ils ont résolu ma question en un jour. 10/10 recommanderaient.
Chaque fichier ne fait que quelques lignes ; les lignes qui commencent par ==> indiquent seulement où commence un nouveau fichier. Pour Gemini CLI, vous pouvez vous passer de GEMINI.md et indiquer à la place "AGENTS.md" dans context.fileName, dans .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
Mise en place en quatre étapes
Un quart d'heure, et chaque agent travaille ensuite avec les mêmes règles.
Faites l'inventaire de l'existant
Listez chaque fichier d'instructions du dépôt : AGENTS.md, CLAUDE.md, .claude/rules, .cursor/rules, .cursorrules, .github/copilot-instructions.md, .github/instructions, GEMINI.md, .windsurfrules, .windsurf/rules, .devin/rules. Les anciens fichiers continuent de se charger, même quand vous les avez oubliés.
Fusionnez dans AGENTS.md
Collez la section partagée, déplacez-y les commandes de build et les conventions des anciens fichiers, et résolvez les contradictions. Le prompt ci-dessous fait le gros du travail.
Remplacez les fichiers d'outil par des adaptateurs
CLAUDE.md importe AGENTS.md ; Cursor ne garde que des règles .mdc ciblées ; Copilot reçoit un court renvoi ; Gemini reçoit un import ou le réglage context.fileName.
Vérifiez que chaque outil le charge
Claude Code : lancez /context et regardez sous Memory files. Gemini CLI : /memory show. Copilot Chat sur GitHub.com : le fichier d'instructions apparaît dans les références de la réponse. Cursor et Devin Desktop : demandez à l'agent de vous citer les invariants des stores.
Prompt : regroupez vos fichiers d'instructions
Fonctionne dans Claude Code, Codex, Cursor, le mode agent de Copilot ou Devin Desktop. Collez à la fin la section partagée de cette page.
À coller dans n'importe quel agent de code, à la racine du dépôt
Regroupez les fichiers d'instructions pour agents IA de ce dépôt afin que chaque outil reçoive les mêmes règles sur l'app native. Il s'agit d'une web app également publiée sous forme d'apps iOS et Android via WebViewGold, qui charge notre URL de production dans une WebView native.
1. Trouvez chaque fichier d'instructions : AGENTS.md (dans n'importe quel dossier), CLAUDE.md, .claude/CLAUDE.md, .claude/rules/, .cursor/rules/, .cursorrules, .github/copilot-instructions.md, .github/instructions/, GEMINI.md, .windsurfrules, .windsurf/rules/, .devin/rules/. Montrez-moi un tableau : fichier, contenu, conflits avec d'autres fichiers.
2. Créez ou mettez à jour le fichier AGENTS.md racine : présentation du projet, commandes, conventions, et la section « Native app (WebViewGold) » collée ci-dessous. Interrogez-moi sur les conflits au lieu de deviner.
3. Remplacez les fichiers propres aux outils par des adaptateurs légers : un CLAUDE.md qui importe @AGENTS.md plus des notes réservées à Claude ; des .cursor/rules/*.mdc uniquement pour les règles ciblées par des globs ; un .github/copilot-instructions.md qui renvoie à AGENTS.md et demande à la code review de vérifier les invariants des stores ; un GEMINI.md qui importe @AGENTS.md. Supprimez .cursorrules et .windsurfrules après avoir déplacé leur contenu.
4. Gardez les secrets, les jetons et les URL personnelles hors de tous ces fichiers.
5. Montrez le diff final et expliquez-moi comment vérifier que chaque outil charge les règles.
Section sur l'app native :
[collez ici la section de cette page]
Checklist
La section sur l'app native n'existe que dans AGENTS.md ; tous les autres fichiers l'importent ou y renvoient.
L'URL de production et le marqueur user agent correspondent à Config.swift et Config.java.
CLAUDE.md importe AGENTS.md ; sinon, Claude Code ignore AGENTS.md par défaut.
Chaque règle Cursor utilise .mdc ; les règles Bugbot se trouvent dans .cursor/BUGBOT.md si vous utilisez Bugbot.
Les fichiers respectent les recommandations des outils : CLAUDE.md sous environ 200 lignes, règles Cursor sous 500.
Aucun secret, jeton ou mot de passe de staging dans un fichier d'instructions.
Pièges
La dérive du copier-coller : trois copies des règles des stores, dont deux périmées. Les agents suivent la copie qu'ils lisent.
Un CLAUDE.md sans la ligne d'import. Claude Code ignore alors AGENTS.md par défaut.
Les simples fichiers .md dans .cursor/rules sont ignorés ; seuls les fichiers .mdc comptent.
Des fichiers historiques qui se chargent encore : .windsurfrules et .windsurf/rules dans Devin Desktop, et un ancien .cursorrules qui peut encore être lu. Les vieilles contradictions reviennent en douce.
Coller toute la référence WebViewGold dans les instructions. Les fichiers longs sont moins bien suivis ; listez les schémas que vous utilisez et mettez un lien vers llms-full.txt pour le reste.
Compter sur des memories générées automatiquement (auto memory de Claude Code, memories de Windsurf) pour les règles d'équipe. Elles vivent sur une seule machine et ne voyagent pas avec le dépôt.
Questions fréquentes
Ai-je besoin de tous ces fichiers ?
Non. Si vous n'utilisez qu'un seul outil, son fichier natif suffit. Avec deux outils ou plus, faites d'AGENTS.md la source et n'ajoutez des adaptateurs que pour les outils qui en ont besoin.
Claude Code lit-il désormais AGENTS.md ?
Oui. Les versions actuelles de Claude Code lisent AGENTS.md lorsqu'il n'y a pas de CLAUDE.md dans le répertoire de travail ni au-dessus. Si vous avez un CLAUDE.md, ajoutez-y un import @AGENTS.md pour que les deux soient utilisés.
GEMINI.md est-il encore pertinent ?
Moins qu'avant. En 2026, Google a remplacé Gemini CLI par Antigravity CLI, qui lit encore GEMINI.md par rétrocompatibilité mais recommande AGENTS.md. GitHub Copilot accepte aussi un unique GEMINI.md à la racine.
Où se placent les règles Windsurf ?
Windsurf s'appelle désormais Devin Desktop. Il lit AGENTS.md comme une règle toujours active, ainsi que .devin/rules et les anciens fichiers .windsurf/rules et .windsurfrules : la configuration avec AGENTS.md le couvre donc.
Lien symbolique ou import ?
Les deux fonctionnent. Les imports (CLAUDE.md et GEMINI.md prennent en charge la syntaxe @file) sont explicites et survivent aux checkouts Windows ; les liens symboliques sont invisibles en code review et faciles à casser.
Les règles des stores doivent-elles vivre dans le fichier d'instructions ou dans une checklist ?
Les deux. Le fichier d'instructions garde chaque modification future conforme ; une checklist ou un skill de conformité lance l'audit complet avant chaque soumission.
Trois façons de mettre votre app dans les stores
Même résultat, charge de travail différente de votre côté. Les trois formules incluent la garantie d'approbation et le support humain 24/7.
Faites-le vous-même
$109 par plateforme, paiement unique
La licence WebViewGold : un projet Xcode ou Android Studio prêt à l'emploi. Collez votre URL, définissez le nom et l'icône, activez les fonctionnalités, compilez et soumettez. Mises à jour gratuites à vie.
Ni Mac, ni Xcode, ni Android Studio : configurez dans le navigateur, nous compilons les deux apps dans le cloud et les transmettons à App Store Connect et à la Play Console.
Envoyez-nous votre URL et votre icône. Notre équipe configure, compile et livre votre app sous 72 heures, en marque blanche, projets sources inclus. Les deux plateformes pour $1,158.
Les remboursements sont accordés aux conditions indiquées dans notre FAQ : un refus non lié au contenu par Apple et/ou Google, demandé dans les 14 jours suivant l'achat.