CursorCONVENTIONS COMMIT ET
Prérequis
- Dépôt Git avec branche feature active et diff reviewable
- Convention d’équipe documentée ou prête à être formalisée (types, scopes)
- GitHub CLI (`gh`) installé si vous créez les PR en ligne de commande
- Rule Git dans `.cursor/rules/` ou AGENTS.md mentionnant la politique de commit
Des commits intitulés « fix » et des PR sans contexte de test ralentissent la review et obscurcissent l’historique Git. En versionnant une rule `git-conventions.mdc` et en utilisant des prompts agent cadrés, vous standardisez le format des messages et le contenu des PR sans renoncer à la validation humaine.
Cadrer la rule git-conventions
Créez `.cursor/rules/git-conventions.mdc` avec `alwaysApply: false`. Listez les types autorisés : `feat`, `fix`, `docs`, `chore`, `refactor`, `test`. Définissez les scopes alignés sur votre arborescence : `form`, `seo`, `academy`, `ui`.
Interdisez les messages vagues (« update », « WIP », « fix bug »). Incluez un template PR : ## Summary, ## Test plan avec cases à cocher. Rappelez dans AGENTS.md : pas de `git config` modifié, pas de `--no-verify`, pas de force push sur main.
Générer le message de commit
Stagez uniquement les fichiers d’un sujet logique. Dans Cursor Agent, prompt : « Rédige un message de commit pour le diff staged, format conventional commits, scope adapté. Un seul sujet. » Relisez avant `git commit`.
Rédiger la PR avec l’agent
Prompt : « Rédige le body d’une PR pour la branche actuelle : résumé en 2–3 phrases, plan de test concret. Format markdown GitHub. » Créez via `gh pr create` en collant le texte édité.
Erreurs fréquentes
Commit fourre-tout mélangeant refactor SEO et fix formulaire : impossible à revert proprement.
Message généré en anglais alors que l’équipe commite en français : incohérence de l’historique.
PR sans plan de test : le reviewer ne sait pas valider sur preview.
Laisser l’agent lancer `git commit` sans relecture du staging.
Copier le body PR sans adapter les URLs de preview Vercel.
Ce qu’il faut retenir
Rule `git-conventions.mdc` versionnée = même format pour toute l’équipe.
Staging ciblé + un sujet par commit + message relu humain.
PR testable : résumé, plan de test, liens preview.
L’agent rédige ; vous validez staging, message et ouverture de PR.
FAQ
Recommandé pour un historique lisible et des changelogs automatisables. Adaptez les types et scopes à votre flux agence ; l’essentiel est la cohérence, pas le dogme.
Oui avec `gh` et les permissions adéquates. Gardez la relecture du title et du body ; les reviewers et le lien ticket restent manuels.
Les conventions d’équipe vivent dans `.cursor/rules/` versionné. Les User rules locales ne remplacent pas le dépôt : précisez-le en onboarding.
ChatGPT