Commits atômicos

Projeto vibe codado gera muito código rápido. Sem disciplina de commit, o histórico vira um único "update" gigante que ninguém consegue revisar. A regra da casa: commits pequenos, um assunto por commit.

O formato

Usamos Conventional Commits:

tipo(escopo): resumo curto

- o que mudou, um fato por linha

Tipos mais comuns: feat (funcionalidade nova), fix (correção), docs (documentação), chore (configuração e ferramentas), refactor (reestruturação sem mudar comportamento), ci (pipelines).

Exemplo real deste site:

feat(Portal): redesign header and footer, add SSO placeholder

- Sticky translucent header with pp symbol and smaller logo
- Disabled 'Entrar - em breve' button with tooltip for future SSO

Como agrupar

• Uma funcionalidade → um commit
• Configuração e ferramentas → commit separado (chore)
• Documentação → commit separado (docs)
• Nunca misture mudança de comportamento com formatação no mesmo commit

Com o Claude

Peça "faça commits atômicos" no fim da sessão — ele agrupa os arquivos alterados em commits lógicos e escreve as mensagens no formato. Revise antes de dar push.