Guide
Règles Cursor : fichiers .mdc, modes d'application et AGENTS.md en 2026
Les règles Cursor sont des instructions réutilisables placées au début du contexte du modèle. Les règles de projet résident dans .cursor/rules sous forme de fichiers .mdc versionnés, avec un en-tête description, globs et alwaysApply. Cursor prend aussi en charge les User Rules (globales), les Team Rules (définies depuis le tableau de bord, offres Team ou Enterprise) et AGENTS.md.
Notre atlas compte deux fiches pour les règles Cursor : la documentation officielle cursor-rules et agents-md, un format Markdown simple et ouvert que Cursor, Codex, Gemini CLI et Windsurf savent lire. La documentation de Cursor recommande de garder les règles sous 500 lignes, et les fichiers .md simples placés dans .cursor/rules sont ignorés.
- Officiel 2
Comment ça marche
- Tapez /create-rule dans le chat Agent et décrivez la règle, ou ouvrez Customize > Rules > Add Rule.
- La règle est enregistrée dans .cursor/rules/<name>.mdc ; renseignez description, globs et alwaysApply dans l'en-tête.
- Il existe quatre modes d'application : Always, Intelligently (selon la description), Specific Files (selon les globs) et Manual (mention avec @).
- Versionnez le dossier .cursor/rules pour que toute l'équipe partage les mêmes règles.
- Pour une configuration plus simple, placez un AGENTS.md à la racine du dépôt ; des AGENTS.md imbriqués servent les paquets d'un monorepo et le plus proche l'emporte.
À quoi ressemble un fichier de règles
Une règle .mdc comporte un en-tête (description, globs, alwaysApply) et des instructions en texte simple. AGENTS.md n'a pas d'en-tête et est lu par plusieurs agents, pas seulement Cursor.
Fichier : .cursor/rules/<name>.mdc (project) · AGENTS.md (repo root)
---
description: Comment nous écrivons les composants React dans ce dépôt
globs: ["src/**/*.tsx"]
alwaysApply: false
---
- Utiliser des composants fonction et des hooks ; pas de composants classe.
- Placer les tests à côté : <Component>.test.tsx.
- Ne jamais importer depuis `../../..` ; utiliser l'alias `@/`.---
globs: src/components/**/*.tsx
alwaysApply: false
---
- Use named exports, not default exports{
"context": {
"fileName": "AGENTS.md"
}
}La liste (2)
| Nom | Auteur | Compatible avec | Licence | Statut | Source |
|---|---|---|---|---|---|
| AGENTS.md Format Markdown ouvert d'instructions projet pour agents de code, lu par Codex, Cursor, G… |
AGENTS.md (Agentic AI Foundation, Linux Foundation) officiel | OpenAI Codex, Cursor, Gemini CLI, Windsurf | — | maintenu | agents.md ↗ |
| Cursor Rules Instructions persistantes pour Cursor Agent : règles .mdc de projet, règles utilisateur, … |
Cursor (Anysphere) officiel | Cursor | — | maintenu | cursor.com ↗ |
Questions fréquentes
Où placer les règles Cursor??
Dans .cursor/rules, sous forme de fichiers .mdc. Les fichiers .md simples de ce dossier sont ignorés ; utilisez .mdc ou AGENTS.md.
Quels sont les modes d'application des règles Cursor??
Always, Intelligently (choisi d'après la description), Specific Files (selon les globs) et Manual (appelé par une mention avec @).
Faut-il utiliser AGENTS.md ou .cursor/rules??
AGENTS.md est une alternative Markdown plus simple, lue aussi par d'autres agents. .cursor/rules vous donne le contrôle par en-tête sur le moment où chaque règle s'applique.
Les règles peuvent-elles imposer une politique??
Non. AGENTS.md est un texte d'orientation, et les prompts explicites du chat prennent le dessus. La documentation de Cursor suggère un linter plutôt que de coller des guides de style entiers dans les règles.