Voici une situation que vous avez peut-être déjà vécue en pratiquant les guides précédents : préciser, encore et encore, « ne modifie pas style.css » ou « explique d'abord ton plan », au début de presque chaque demande. Une Rule permet d'écrire cette consigne une seule fois, pour qu'elle s'applique automatiquement aux conversations suivantes.

Où vivent les Rules aujourd'hui

Les Project Rules actuelles sont stockées dans un dossier .cursor/rules, à la racine du projet, sous forme de fichiers portant l'extension .mdc. Elles peuvent être versionnées avec Git comme n'importe quel autre fichier du projet, ce qui signifie qu'elles se partagent automatiquement si vous travaillez à plusieurs sur le même dépôt. Un ancien format à fichier unique, .cursorrules à la racine du projet, existe encore par compatibilité, mais est aujourd'hui considéré comme historique : privilégiez le nouveau format pour tout nouveau projet.

Créer le dossier et le fichier de Rule

Dans mon-premier-site, créez un dossier .cursor, puis à l'intérieur un sous-dossier rules. Dans ce dossier, créez un fichier nommé projet.mdc.

Écrire une règle courte et précise

Un fichier .mdc commence par un court en-tête, entre deux lignes de trois tirets, qui précise notamment si la règle doit s'appliquer à toutes les conversations du projet. Suit ensuite le contenu de la règle elle-même, en texte normal.

alwaysApply: true signifie que cette règle s'applique automatiquement à chaque conversation dans ce projet, sans que vous ayez besoin de l'invoquer manuellement. Gardez le contenu court et concret : une règle trop longue ou trop générale perd en clarté, aussi bien pour vous que pour l'Agent qui doit la respecter.

Tester si la Rule est prise en compte

Ouvrez une nouvelle conversation dans le panneau Agent, et faites une demande de modification simple sur index.html, sans répéter vous-même la consigne « explique ton plan ». Si la Rule est bien active, l'Agent doit décrire son intention avant de proposer le changement, sans que vous ayez eu besoin de le lui redemander cette fois.

Vérifier depuis les réglages

Les réglages de Cursor, dans une section consacrée aux règles du projet, affichent généralement la liste des fichiers .mdc détectés, avec leur portée d'application. C'est un bon moyen de confirmer que votre fichier a été correctement repéré, en particulier si le test pratique ci-dessus ne semble pas fonctionner comme prévu.

Une Rule n'est pas une protection absolue

Une Rule guide fortement le comportement de l'Agent, mais elle ne garantit pas à 100 % qu'une consigne sera toujours respectée à la lettre, en particulier sur une tâche complexe ou ambiguë. Continuez à relire les diffs proposés, exactement comme appris au guide 8, même sur un projet équipé de Rules bien écrites.

Vérifiez que vous avez compris

Vous avez créé une Rule avec alwaysApply: true, qui demande à l'Agent de ne jamais modifier un fichier .env. L'Agent propose malgré tout, dans une conversation, une modification de ce fichier. Devez-vous l'accepter parce que la Rule aurait dû l'empêcher ?

Non. Une Rule réduit la probabilité qu'un tel comportement se produise, mais elle ne l'empêche pas de façon absolue. Si une proposition contredit une règle que vous avez explicitement définie, refusez-la et signalez le problème dans la conversation, exactement comme vous le feriez pour n'importe quelle proposition qui ne correspond pas à votre demande.

Chapitre terminé