Procedimento de adoção do lefthook: executar Biome automaticamente em pre-commit e pre-push

Você esquece a formatação antes do commit e o lint bloqueia logo antes do push. Quando isso se repete, perde-se tempo antes mesmo da revisão.

Automatizar formatação e checks estáticos com Git Hooks reduz essas falhas manuais. Nesta configuração, o lefthook executa o Biome no commit e no push.

Objetivo

Executar automaticamente formatação e lint do Biome no commit e no push.

Pré-requisitos

• bun disponível
• Trabalhar na raiz do repositório

Passos de adoção

1. Criar um ADR (em japonês) e formalizar a diretriz
2. Criar a nota de procedimento em ailog/
3. Adicionar lefthook como dependência de desenvolvimento
4. Criar lefthook.yml e configurar formatação/lint para pre-commit e pre-push
5. Adicionar o script prepare (lefthook install) ao package.json
6. Executar bun run prepare para instalar os Git Hooks
7. Validar com lefthook run pre-commit e lefthook run pre-push
8. Se houver problemas, corrigir a configuração
9. Após concluir a adoção, criar um rascunho de artigo em ailog/
10. Traduzir o ADR para outros idiomas (en / de / fr / ko)

Checklist de validação

• lefthook.yml existe e define pre-commit / pre-push
• bun run prepare executa com sucesso
• lefthook run pre-commit executa com sucesso
• lefthook run pre-push executa com sucesso

Notas de execução

pre-commit usa arquivos staged e executa biome format --write {staged_files} e biome check --write {staged_files}.

pre-push também usa arquivos staged e executa biome format --write {staged_files} e biome check --write {staged_files}.

Com a configuração de Git Hooks versionada no repositório, a operação fica consistente entre ambientes. Se o objetivo é reduzir diffs não essenciais na revisão, vale travar isso cedo.