Objetivo: eliminar commits gigantes (“semanais”), facilitar o Code Review e transforma o histórico do Git em uma documentação útil do projeto.

Um histórico de Git limpo não é apenas estética — é comunicação.

Se é preciso abrir o código para entender o que um commit fez, a mensagem do commit falhou.

1. Regra de Ouro: Granularidade e Frequência

O fim do “Commit Semanal”

O maior erro é acumular dias de trabalho em um único commit. Isso:

• gera conflitos de merge;
• dificulta code review;
• torna reversões arriscadas (ou impossíveis) sem perder trabalho relevante.

O que fazer — Commit Atômico

Um commit deve conter apenas uma mudança lógica.

• Corrigiu um bug e formatou o código? → Faça 2 commits
• Criou uma função e escreveu o teste dela? → Pode ser 1 commit (mesma unidade de trabalho)
• Commite cedo, commite sempre: terminou uma sub-tarefa e testou? Commit.

O que não fazer

• Commitar código incompleto na branch principal.