Les règles fournissent des instructions au niveau système à Agent et Inline Edit. Considérez-les comme du contexte persistant, des préférences ou des flux de travail pour vos projets. Cursor prend en charge trois types de règles :

Règles de Projet

Stockées dans .cursor/rules, contrôlées par version et délimitées à votre base de code.

Règles Utilisateur

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

.cursorrules (Hérité)

Toujours pris en charge, mais obsolète. Utilisez les Règles de Projet à la place.

Comment fonctionnent les règles

Les grands modèles de langage ne conservent pas de mémoire entre les complétions. Les règles fournissent un contexte persistant et réutilisable au niveau de l’invite. Lorsqu’elles sont appliquées, le contenu des règles est inclus au début du contexte du modèle. Cela donne à l’IA des conseils cohérents pour générer du code, interpréter les modifications ou aider avec les flux de travail.
Règle appliquée dans le contexte avec le chat
Les règles s’appliquent au Chat et à l’Édition en ligne. Les règles actives s’affichent dans la barre latérale Agent.

Règles de projet

Les règles de projet se trouvent dans .cursor/rules. Chaque règle est un fichier et est versionnée. Elles peuvent être délimitées en utilisant des motifs de chemin, invoquées manuellement, ou incluses selon leur pertinence. Les sous-répertoires peuvent inclure leur propre répertoire .cursor/rules délimité à ce dossier. Utilisez les règles de projet pour :
  • Encoder des connaissances spécifiques au domaine sur votre base de code
  • Automatiser des flux de travail 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 supportant les métadonnées et le contenu. Contrôlez comment les règles sont appliquées depuis le menu déroulant de 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 seulement quand explicitement mentionnée en utilisant @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
Les fichiers référencés comme @service-template.ts sont inclus comme contexte supplémentaire quand la règle se déclenche.

Règles imbriquées

Organisez les règles en les plaçant dans des répertoires .cursor/rules à travers votre projet. Les règles imbriquées s’attachent automatiquement quand des fichiers dans leur répertoire 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éez des règles en utilisant la commande New Cursor Rule ou en allant dans Cursor Settings > Rules. Cela crée un nouveau fichier de règle dans .cursor/rules. Depuis les paramètres, vous pouvez voir toutes les règles et leur statut.
Comparaison entre règles concises et longues

Générer des règles

Générez des règles directement dans les conversations en utilisant la commande /Generate Cursor Rules. Utile quand vous avez pris des décisions sur le comportement de l’agent et voulez les réutiliser.

Meilleures pratiques

Les bonnes règles sont ciblées, exploitables et bien délimitées.
  • Gardez les règles sous 500 lignes
  • Divisez les grandes règles en plusieurs règles composables
  • Fournissez des exemples concrets ou des fichiers de référence
  • Évitez les conseils vagues. Rédigez les règles comme une documentation interne claire
  • Réutilisez les règles lors de la répétition d’invites dans le chat

Exemples

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

Règles utilisateur

Les règles utilisateur sont des préférences globales définies dans Cursor Settings → Rules qui s’appliquent à tous les projets. Elles sont en texte brut et parfaites pour définir un style de communication préféré ou des conventions de codage :
Veuillez répondre de manière concise. Évitez les répétitions inutiles ou le langage de remplissage.

.cursorrules (Hérité)

Le fichier .cursorrules dans la racine de votre projet est toujours pris en charge mais sera déprécié. Nous recommandons de migrer vers les Règles de Projet pour plus de contrôle, de flexibilité et de visibilité.

FAQ