lefthook-Einführungsablauf: Biome in pre-commit und pre-push automatisch ausführen

Vor dem Commit wird das Formatieren vergessen, direkt vor dem Push blockiert dann der Lint. Wenn sich das wiederholt, geht Zeit verloren, bevor das Review überhaupt beginnt.

Mit Git Hooks lassen sich Formatierung und statische Checks automatisieren und manuelle Auslassungen reduzieren. In diesem Setup führt lefthook Biome bei Commit und Push aus.

Ziel

Biome-Formatierung und Linting bei Commit und Push automatisch ausführen.

Voraussetzungen

• bun ist verfügbar
• Arbeiten im Repository-Root

Einführungsablauf

1. Ein ADR (auf Japanisch) erstellen und die Richtlinie dokumentieren
2. Die Verfahrensnotiz unter ailog/ anlegen
3. lefthook als Entwicklungsabhängigkeit hinzufügen
4. lefthook.yml erstellen und Formatierung/Linting für pre-commit und pre-push konfigurieren
5. Das prepare-Skript (lefthook install) in package.json ergänzen
6. Mit bun run prepare die Git Hooks installieren
7. Mit lefthook run pre-commit und lefthook run pre-push verifizieren
8. Bei Problemen die Konfiguration korrigieren
9. Nach Abschluss einen Entwurf im ailog/ erstellen
10. Das ADR in weitere Sprachen übersetzen (en / de / fr / ko)

Verifikations-Checkliste

• lefthook.yml existiert und definiert pre-commit / pre-push
• bun run prepare ist erfolgreich
• lefthook run pre-commit ist erfolgreich
• lefthook run pre-push ist erfolgreich

Ausführungsnotizen

pre-commit zielt auf staged Dateien und führt biome format --write {staged_files} sowie biome check --write {staged_files} aus.

pre-push zielt ebenfalls auf staged Dateien und führt biome format --write {staged_files} sowie biome check --write {staged_files} aus.

Wenn die Git-Hook-Konfiguration im Repository liegt, bleibt der Ablauf über Umgebungen hinweg konsistent. Wer unnötige Review-Diffs reduzieren will, sollte diesen Teil früh festziehen.