Règles

Contrôle le comportement du modèle Agent avec des instructions réutilisables et à portée définie.

Les règles fournissent des instructions de 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 :

Project Rules

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

User Rules

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

AGENTS.md

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

.cursorrules (Legacy)

Toujours pris en charge, mais obsolète. Utilise plutôt les Project Rules.

Comment fonctionnent les règles

Les grands modèles de langage ne gardent pas de mémoire entre les complétions. 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 indications cohérentes pour générer du code, interpréter des modifications ou aider sur des workflows.

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 système de 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 répertoire .cursor/rules limité à ce dossier.

Utilise les règles du projet pour :

• Encoder des connaissances spécifiques à ton domaine concernant ta base de code
• Automatiser des workflows ou des templates propres 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 gère les métadonnées et le contenu. Contrôle comment les règles sont appliquées via le menu déroulant du type, qui modifie les propriétés description, globs, alwaysApply.

Type de règle	Description
Always	Toujours inclus dans le contexte du modèle
Auto Attached	Inclus quand des fichiers correspondant à un motif glob sont référencés
Agent Requested	Mis à disposition de l’IA, qui décide de l’inclure ou non. Doit fournir une description
Manual	Inclus uniquement lorsqu’il est explicitement mentionné avec @ruleName

---
description: RPC Service boilerplate
globs:
alwaysApply: false
---

- Utilise notre pattern RPC interne pour définir les services
- Utilise toujours snake_case pour les noms de services.

@service-template.ts

Règles imbriquées

Organise les règles en les plaçant dans des répertoires .cursor/rules partout dans ton projet. Les règles imbriquées s’attachent automatiquement quand des fichiers de leur répertoire sont référencés.

project/
  .cursor/rules/        # Règles pour tout le 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 en allant dans 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 état.

Génération de règles

Génère des règles directement dans les conversations avec la commande /Generate Cursor Rules. Pratique quand t’as défini le comportement de l’agent et que tu veux le 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
• Divise les grandes règles en plusieurs règles composables
• Fournis des exemples concrets ou des fichiers de référence
• Évite les consignes vagues. Écris les règles comme une doc interne claire
• Réutilise les règles quand tu répètes des prompts dans le chat

Exemples

Standards pour les composants frontend et la validation des API

Cette règle définit des standards pour les composants frontend :

Quand tu travailles dans le répertoire components :

• Utilise toujours Tailwind pour le style
• Utilise Framer Motion pour les animations
• Suis les conventions de nommage des composants

Cette règle impose la validation pour les endpoints d’API :

Dans le répertoire api :

• Utilise zod pour toute la validation
• Définit les types de retour avec des schémas zod
• Exporte les types générés à partir des schémas

Modèles pour les services Express et les composants React

Cette règle fournit un template pour les services Express :

Utilise ce template quand tu crées un service Express :

• Suis les principes RESTful
• Inclue un middleware de gestion des erreurs
• Mets en place une journalisation appropriée

@express-service-template.ts

Cette règle définit la structure des composants React :

Les composants React doivent suivre cette structure :

• Interface des props en haut
• Composant en export nommé
• Styles en bas

@component-template.tsx

Automatisation des workflows de développement et génération de documentation

Cette règle automatise l’analyse de l’app :

Quand on te demande d’analyser l’app :

1. Lance le serveur de dev avec npm run dev
2. Récupère les logs depuis la console
3. Suggère des améliorations de performance

Cette règle aide à générer la documentation :

Aide à rédiger la doc en :

• Extrayant les commentaires de code
• Analysant README.md
• Générant de la documentation Markdown

Ajouter un nouveau réglage dans Cursor

Commence par créer une propriété à bascule dans @reactiveStorageTypes.ts.

Ajoute une valeur par défaut dans INIT_APPLICATION_USER_PERSISTENT_STORAGE dans @reactiveStorageService.tsx.

Pour les fonctionnalités bêta, ajoute le toggle dans @settingsBetaTab.tsx, sinon ajoute-le dans @settingsGeneralTab.tsx. Les toggles peuvent être ajoutés en tant que <SettingsSubSection> pour les cases à cocher générales. Regarde le reste du fichier pour des exemples.

<SettingsSubSection
				label="Your feature name"
				description="Your feature description"
				value={
					vsContext.reactiveStorageService.applicationUserPersistentStorage
						.myNewProperty ?? false
				}
				onChange={(newVal) => {
					vsContext.reactiveStorageService.setApplicationUserPersistentStorage(
						'myNewProperty',
						newVal
					);
				}}
			/>

Pour l’utiliser dans l’app, importe reactiveStorageService et utilise la propriété :

const flagIsEnabled = vsContext.reactiveStorageService.applicationUserPersistentStorage.myNewProperty

De nombreux exemples sont disponibles auprès des fournisseurs et des 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 les instructions des agents. Place-le à la racine de ton projet comme alternative à .cursor/rules pour des cas d’usage simples.

Contrairement aux Project Rules, AGENTS.md est un fichier Markdown 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

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 sont idéales pour définir un style de communication préféré ou des 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 sera bientôt abandonné. On te recommande de migrer vers les Project Rules pour plus de contrôle, de flexibilité et de visibilité.

FAQ

Pourquoi ma règle n’est-elle pas appliquée ?

Vérifie le type de règle. Pour Agent Requested, assure-toi qu’une description est définie. Pour Auto Attached, assure-toi que le motif de fichier correspond aux fichiers référencés.

Les règles peuvent-elles référencer d’autres règles ou fichiers ?

Oui. Utilise @filename.ts pour inclure des fichiers dans le contexte de ta règle.

Puis-je créer une règle depuis le chat ?

Oui, génère des règles de projet depuis le chat avec la commande /Generate Cursor Rules. Si Memories est activé, les mémoires sont générées automatiquement.

Les règles ont-elles un impact sur Cursor Tab ou d’autres fonctionnalités d’IA ?

Non. Les règles s’appliquent uniquement à Agent et Inline Edit.