alliance-boreale/docs/engineering/git-conventions.md

Conventions Git — Alliance Boréale

Branches

• {type}/{scope}-{description}
• kebab-case, ASCII simple, 50–60 caractères max
• Durée de vie courte; suppression après merge
• Pas de commits directement sur main (branches protégées)

Types (rappel)

feat, fix, docs, ci, refactor, perf, test, chore, security, hotfix, release

Commits

• Titre ≤ 72 chars
• Corps : motivation, contexte, liens, breaking changes
• revert: autorisé (réf. au commit original)

Rebase / Merge

• Préférez Squash & Merge (historique lisible)
• Rebase interactif autorisé avant PR pour nettoyer

Tags / Releases (optionnel)

• SemVer : vX.Y.Z
• Changelog généré depuis Conventional Commits (outil libre au choix)

Hooks (optionnel)

• pre-push : validation nom de branche & scan rapide
• prepare-commit-msg : pré-remplir le modèle de commit

Voir scripts/check_branch.sh et templates/.gitmessage.txt.