logo hsb.horse
← Retour au blog

Blog

Procédure d'adoption de lefthook: exécuter Biome automatiquement en pre-commit et pre-push

Procédure concrète pour configurer lefthook et exécuter automatiquement le formatage et le lint Biome au commit et au push. Le guide couvre l'ADR, la configuration, l'installation et la vérification.

Publié: Mis à jour:

On oublie le formatage avant le commit, puis le lint bloque juste avant le push. Quand cela se répète, on perd du temps avant même la revue.

Automatiser le formatage et les vérifications statiques avec les Git Hooks réduit ces oublis manuels. Ici, lefthook lance Biome au moment du commit et du push.

Objectif

Exécuter automatiquement le formatage et le lint Biome au commit et au push.

Prérequis

  • bun doit être disponible
  • Travailler à la racine du dépôt

Procédure d’introduction

  1. Créer un ADR (en japonais) pour formaliser la politique
  2. Créer une note de procédure dans ailog/
  3. Ajouter lefthook comme dépendance de développement
  4. Créer lefthook.yml et configurer formatage/lint pour pre-commit et pre-push
  5. Ajouter le script prepare (lefthook install) dans package.json
  6. Exécuter bun run prepare pour installer les Git Hooks
  7. Vérifier avec lefthook run pre-commit et lefthook run pre-push
  8. Corriger la configuration en cas de problème
  9. Après l’introduction, créer un brouillon d’article dans ailog/
  10. Traduire l’ADR dans les autres langues (en / de / fr / ko)

Checklist de vérification

  • lefthook.yml existe et définit pre-commit / pre-push
  • bun run prepare réussit
  • lefthook run pre-commit réussit
  • lefthook run pre-push réussit

Notes d’exécution

pre-commit cible les fichiers staged et exécute biome format --write {staged_files} puis biome check --write {staged_files}.

pre-push cible aussi les fichiers staged et exécute biome format --write {staged_files} puis biome check --write {staged_files}.

En gardant la configuration des Git Hooks dans le dépôt, l’exploitation reste cohérente entre environnements. Pour réduire les diffs de revue non essentiels, ce point doit être verrouillé dès le début.