CursorSETUP CURSOR RULES
Prérequis
- Cursor installé (dernière version stable) et dépôt cloné localement
- Droits d’écriture sur le repository pour committer `.cursor/rules/` et `AGENTS.md`
- Stack et conventions projet documentées (lint, tests, structure des dossiers)
- 30 à 45 minutes pour le setup initial rules + AGENTS.md
Sans cadre explicite, l’agent Cursor improvise : mauvais patterns, commits hors convention, oubli des contraintes Next.js du dépôt. Posez des rules versionnées et un fichier AGENTS.md dès le kick-off pour que chaque développeur et chaque session partagent le même référentiel.
AGENTS.md et project rules : complémentarité
Cursor propose `AGENTS.md` (instructions markdown) et les project rules `.cursor/rules/*.mdc` (frontmatter YAML : description, globs, `alwaysApply`). Combinez les deux : vision globale dans AGENTS.md, conventions techniques ciblées dans les rules.
Évitez le legacy `.cursorrules`. Vérifiez que chaque rule `.mdc` possède un frontmatter valide — un `.md` sans métadonnées est ignoré.
Créer les rules et renseigner AGENTS.md
Créez `.cursor/rules/` et un fichier par sujet : `typescript-standards.mdc` avec `globs: **/*.ts,**/*.tsx`. Privilégiez des exemples / tirés de votre codebase.
Rédigez `AGENTS.md` avec stack, scripts (`lint`, `typecheck`), chemins clés et interdits (pas de commit sans demande). Un `AGENTS.md` nested dans `src/content/` peut porter le schéma `AcademyTutorial`.
Skills, @codebase et gouvernance équipe
Les Agent Skills encapsulent des workflows multi-étapes. Les conventions quotidiennes restent dans les rules `.mdc`. Versionnez rules, AGENTS.md et skills dans Git avec revue PR.
Les User rules restent locales : précisez en onboarding qu’elles ne remplacent pas les project rules partagées.
Erreurs fréquentes
Un seul fichier rule de 200+ lignes : difficile à maintenir et mal ciblé par les globs.
Globs trop larges (`**/*`) avec `alwaysApply: true` : contexte saturé, réponses génériques.
Copier-coller la doc Next.js dans les rules : doublon lourd ; préférez un lien et les patterns spécifiques au repo.
Oublier de committer `.cursor/rules/` : chaque développeur a un agent désaligné.
Mélanger français opérationnel et anglais technique sans règle de langue : incohérence des commits.
Ce qu’il faut retenir
AGENTS.md = vision et garde-fous globaux ; `.cursor/rules/*.mdc` = conventions ciblées par globs.
Rules courtes, exemplifiées, versionnées en Git et revues en PR.
Skills pour les workflows ; rules pour les standards quotidiens.
Un setup initial de 30–45 minutes évite des heures de corrections agent sur un projet web long.
FAQ
Commencez par AGENTS.md si l’équipe débute. Ajoutez des `.mdc` dès que des conventions diffèrent selon les dossiers (contenu éditorial vs composants UI vs scripts).
Les project rules dans le dépôt oui, via Git. Les User rules restent locales à chaque machine. Les Team rules (offres entreprise) se synchronisent depuis le dashboard Cursor.
Ouvrez un fichier ciblé par le glob, lancez une tâche agent explicite et vérifiez que les patterns imposés sont respectés. Ajustez le frontmatter si la rule n’apparaît pas dans Cursor Settings → Rules.
ChatGPT