Les règles fournissent des instructions au niveau système pour Agent et Inline Edit. Vois-les comme un contexte persistant, des préférences ou des workflows pour tes projets. Cursor prend en charge quatre types de règles :

Règles de projet

Stockées dans .cursor/rules, versionnées et limitées à ta base de code.

Règles utilisateur

Globales à ton environnement Cursor. Définies dans les paramètres et toujours appliquées.

AGENTS.md

Instructions d’Agent au format Markdown. Alternative simple à .cursor/rules.

.cursorrules (Legacy)

Toujours pris en charge, mais obsolète. Utilise plutôt les règles de projet.

Comment fonctionnent les règles

Les grands modèles de langage ne conservent pas de mémoire d’une complétion à l’autre. Les règles fournissent un contexte persistant et réutilisable au niveau du prompt. Lorsqu’elles sont appliquées, le contenu des règles est inclus au début du contexte du modèle. Ça donne à l’IA des consignes cohérentes pour générer du code, interpréter des modifications ou aider dans des workflows.
Règle appliquée dans le contexte avec le chat
Les règles s’appliquent à Chat et à Inline Edit. Les règles actives s’affichent dans la barre latérale de l’Agent.

Règles du projet

Les règles du projet se trouvent dans .cursor/rules. Chaque règle est un fichier et est suivie par le contrôle de version. Elles peuvent être ciblées via des motifs de chemin, invoquées manuellement ou incluses en fonction de leur pertinence. Les sous-répertoires peuvent inclure leur propre dossier .cursor/rules limité à ce répertoire. Utilise les règles du projet pour :
  • Encoder des connaissances métier propres à ta base de code
  • Automatiser des workflows ou des modèles spécifiques au projet
  • Standardiser les décisions de style ou d’architecture

Anatomie d’une règle

Chaque fichier de règle est écrit en MDC (.mdc), un format qui prend en charge les métadonnées et le contenu. Contrôle comment les règles sont appliquées depuis le menu déroulant du type, qui modifie les propriétés description, globs, alwaysApply.
Type de règleDescription
AlwaysToujours incluse dans le contexte du modèle
Auto AttachedIncluse quand des fichiers correspondant à un motif glob sont référencés
Agent RequestedDisponible pour l’IA, qui décide de l’inclure ou non. Doit fournir une description
ManualIncluse uniquement quand elle est mentionnée explicitement via @ruleName
---
description: RPC Service boilerplate
globs:
alwaysApply: false
---

- Use our internal RPC pattern when defining services
- Always use snake_case for service names.

@service-template.ts

Règles imbriquées

Organise les règles en les plaçant dans des dossiers .cursor/rules à travers ton projet. Les règles imbriquées s’attachent automatiquement quand des fichiers de leur dossier sont référencés.
project/
  .cursor/rules/        # Règles à l’échelle du projet
  backend/
    server/
      .cursor/rules/    # Règles spécifiques au backend
  frontend/
    .cursor/rules/      # Règles spécifiques au frontend

Créer une règle

Crée des règles avec la commande New Cursor Rule ou via Cursor Settings > Rules. Ça crée un nouveau fichier de règle dans .cursor/rules. Depuis les paramètres, tu peux voir toutes les règles et leur statut.
Comparaison entre des règles concises et détaillées

Générer des règles

Génère des règles directement dans les conversations avec la commande /Generate Cursor Rules. Pratique quand t’as pris des décisions sur le comportement de l’agent et que tu veux les réutiliser.

Bonnes pratiques

De bonnes règles sont ciblées, actionnables et bien délimitées.
  • Garde les règles en dessous de 500 lignes
  • Scinde les règles volumineuses en plusieurs règles composables
  • Fournis des exemples concrets ou des fichiers de référence
  • Évite les consignes vagues. Rédige les règles comme une doc interne claire
  • Réutilise les règles quand tu répètes des prompts dans le chat

Exemples

De nombreux exemples sont disponibles auprès de fournisseurs et de frameworks. Des règles proposées par la communauté se trouvent dans des collections et des dépôts collaboratifs en ligne.

AGENTS.md

AGENTS.md est un simple fichier Markdown pour définir des instructions d’agent. Place-le à la racine de ton projet comme alternative à .cursor/rules pour des cas d’usage simples. Contrairement aux règles de projet, AGENTS.md est un fichier Markdown brut sans métadonnées ni configurations complexes. C’est parfait pour les projets qui ont besoin d’instructions simples et lisibles, sans la lourdeur de règles structurées.
# Project Instructions

## Code Style
- Use TypeScript for all new files
- Prefer functional components in React
- Use snake_case for database columns

## Architecture
- Follow the repository pattern
- Keep business logic in service layers

Limites actuelles

  • Uniquement à la racine : AGENTS.md doit être placé à la racine de ton projet (v1.5)
  • Pas de scope : les instructions s’appliquent globalement à ton projet
  • Fichier unique : contrairement à .cursor/rules, tu ne peux pas répartir les instructions sur plusieurs fichiers
La prise en charge d’AGENTS.md imbriqués dans des sous-répertoires est prévue pour la v1.6.

Règles utilisateur

Les règles utilisateur sont des préférences globales définies dans Cursor Settings → Rules et appliquées à tous les projets. Elles sont en texte brut et idéales pour définir ton style de communication préféré ou tes conventions de code :
Please reply in a concise style. Avoid unnecessary repetition or filler language.

.cursorrules (Ancien)

Le fichier .cursorrules à la racine de ton projet est toujours pris en charge, mais il va être déprécié. On te recommande de migrer vers les Project Rules pour plus de contrôle, de flexibilité et de visibilité.

FAQ