Bibliothèque de Règles Cursor

Ce que contient ce pack

Les Project Rules de Cursor (fichiers .mdc dans .cursor/rules/) sont le levier le plus haut pour figer le style, l'architecture et les attentes de processus d'un codebase. L'installation Cursor par défaut ne livre pas de règles ; les équipes les écrivent de zéro (lent, avec drift) ou collent le même boilerplate dans chaque projet (sans maintenance partagée). Ce pack rassemble les neuf packs .mdc qui couvrent 80% de ce que la plupart des équipes veulent vraiment, plus un générateur MDC qui construit des règles sur mesure depuis vos docs existantes.

Pourquoi c'est important

L'agent Cursor sans règles est un généraliste. Avec règles, c'est un coéquipier avec une opinion qui connaît déjà votre stack, vos idiomes et vos garde-fous. Trois gains concrets rapportés par les équipes après installation de ce pack :

1. L'onboarding passe de jours à heures. Le Cmd-K d'un nouvel ingénieur produit du code qui ressemble déjà au reste du codebase, parce que Cursor lit le même doc de conventions que l'humain lit au jour un.
2. La fatigue de review tombe. Les reviewers cessent d'attraper les mêmes cinq remarques style/architecture sur chaque PR — les règles les attrapent à la génération. Les reviews se concentrent sur la logique et les compromis, là où les humains ajoutent le plus de valeur.
3. L'overreach IA est borné. Les règles mode-ingénieur Devin établissent "planifie d'abord, édite minimalement, ne refactorise pas le code non lié." Cette seule règle prévient l'échec le plus courant de Cursor : un fix de bug d'une ligne qui se transforme en 200 lignes d'"améliorations" non sollicitées.

Installer en une commande

# Installer le pack entier dans le projet actuel
tokrepo install pack/cursor-rules-library

# Ou choisir un seul langage/framework
tokrepo install python-cursor-rules
tokrepo install react-cursor-rules
tokrepo install devin-engineer-mode

Le TokRepo CLI écrit les fichiers .mdc dans .cursor/rules/ de votre repo. Cursor les prend au prochain prompt — pas de redémarrage. Pour régénérer les règles depuis vos docs existantes :

tokrepo run mdc-generator --input ./docs --output ./.cursor/rules/project.mdc

Pièges fréquents

• Une méga-règle qui couvre tout. Cursor charge les règles correspondantes par requête sur la base du scoping glob. Un unique .mdc de 2000 lignes fait sauter votre budget de contexte sur chaque prompt. Découpez par domaine : règles de langage dans un fichier, architecture dans un autre, sécurité dans un troisième.
• Pas de scoping glob. Une règle backend qui se déclenche sur chaque fichier frontend gaspille des tokens et embrouille l'agent. Utilisez globs: dans le frontmatter pour limiter les règles à **/*.py, app/**/*.tsx, etc.
• Oublier le mode ingénieur Devin pour les outils non-Devin. Cette règle n'est en fait pas spécifique à Devin — c'est un manuel d'opération générique "comporte-toi comme un ingénieur senior." Elle fonctionne aussi bien dans Cursor, Claude Code, Codex CLI et Cline (utilisez le convertisseur du pack Skills Ecosystem).
• Traiter les règles comme statiques. Quand votre stack évolue, les règles doivent évoluer. Versionnez le dossier .cursor/rules/ et revoyez les changements en PR comme tout autre code. Le générateur MDC peut ré-émettre les règles quand vos docs changent.
• Coller des exemples de code qui dérivent de la réalité. Une règle qui dit "utilisez fooBar() pour X" et votre code utilise bar_foo() est pire qu'aucune règle. Soit gardez les exemples minimaux et abstraits, soit générez-les depuis du code réel via le générateur MDC.

Quand ce pack seul ne suffit pas

Si vous utilisez à la fois Cursor et un autre outil IA (Claude Code, Codex CLI, etc.), écrire .mdc directement vous enferme dans Cursor. Le pack Skills Ecosystem vous laisse écrire une fois dans le format canonique de skill et émettre .mdc pour Cursor plus AGENTS.md pour Codex CLI, subagents pour Claude Code, etc. Utilisez ce pack Cursor Rules Library si vous êtes Cursor-only ; basculez vers les skills si vous êtes multi-outils.

Pour les power-users purs de Cursor : associez ce pack à la comparaison AI Code Editor Showdown pour comprendre où Cursor gagne et perd face à Zed, Cody, Continue, Morphic et OpenCode — utile pour défendre Cursor en interne ou décider quand changer.