Source de vérité du dépôt pour les messages de commit, lue par les agents IA et par les générateurs natifs (VS Code, Cursor, GitHub Copilot). Si une convention existe déjà ailleurs dans le dépôt, y renvoyer depuis ce fichier plutôt que de la recopier.
type(scope): description
- Langue : anglais, sujet et corps.
- Sujet : impératif, minuscule après
:, sans point final, ≤ 72 caractères. - Corps : le pourquoi utile seulement, ligne ≤ 100 caractères.
- Pied de page : issues, co-auteurs humains,
BREAKING CHANGE:.
Un commit n'a que des auteurs humains. Ne jamais ajouter de trailer
Co-Authored-By pour une IA, ni mentionner l'outil de génération.
feat, fix, docs, style, refactor, perf, test, build, ci,
chore, revert.
Renseigner l'énumération réellement acceptée par l'outillage du dépôt (ex.
scope-enum de commitlint) et la correspondance chemin → scope. Ne jamais
inventer un scope absent de l'énumération ; l'omettre plutôt.
| Fichiers touchés | Scope |
|---|---|
- Sujet :
feat(scope)!: description. - Ou pied de page :
BREAKING CHANGE: description.
- Commande ou hook validant les messages :
- Longueur maximale du sujet imposée par l'outillage :