Conventional Commits — o que é, pra que serve, por que, como e quando usar

O que é

Conventional Commits é um padrão simples para escrever mensagens de commit no Git. Em vez de mensagens soltas, ele sugere um formato claro — por exemplo: feat: adicionar busca por nome ou fix: corrigir erro no login.

Para que serve

Serve para deixar o histórico do projeto organizado e fácil de entender. Com mensagens padronizadas, fica mais simples saber o que mudou, gerar changelogs automáticos, identificar versões (semântica) e automatizar processos de release e integração contínua.

Por que usar

• Clareza: qualquer pessoa entende o propósito do commit só de ler a primeira linha.

• Produtividade: ferramentas conseguem ler as mensagens e automatizar tarefas (versão, changelog, deploy).

• Colaboração: equipes grandes mantêm um histórico consistente; revisões e buscas ficam mais rápidas.

• Rastreabilidade: facilita encontrar quando e por que uma mudança foi feita.

Como usar (de forma prática e simples)

1. Comece a mensagem com um tipo: os mais comuns são feat (nova funcionalidade), fix (correção), docs (documentação), style (formatação), refactor, test, chore.

2. Adicione um escopo opcional: entre parênteses, para indicar o módulo ou área: feat(auth): adicionar reset de senha.

3. Escreva uma descrição curta e direta: depois dos dois pontos, uma frase curta no imperativo: fix(api): tratar erro 500 ao buscar usuário.

4. Se necessário, acrescente um corpo: linhas em branco e mais detalhes sobre o porquê da mudança, como testar, ou links para issues.

5. Marque breaking changes quando houver: use BREAKING CHANGE: no corpo para mudanças que quebram compatibilidade.

Quando usar

Use sempre que fizer commits no repositório, especialmente em projetos colaborativos, bibliotecas e aplicações que tenham releases automatizados. Em projetos pequenos, pode parecer formal demais no começo, mas a consistência compensa quando o projeto cresce.

Exemplos rápidos

• feat(ui): botão de salvar com loading

• fix(cart): corrigir cálculo de desconto

• docs(readme): atualizar instruções de instalação

• chore(deps): atualizar dependências

• Corpo opcional:
  Corrige problema X que causava Y.
Testes: rodar npm test e verificar rota /cart.
BREAKING CHANGE: rota /old-endpoint removida.

Dica prática para começar hoje

Combine o padrão com um commit hook (husky) e um linter de mensagens (commitlint). Assim a equipe adota o formato sem esforço e o histórico já nasce organizado.

Em resumo Conventional Commits é uma forma pequena de disciplina que traz grande retorno: menos confusão, releases previsíveis e um histórico que conta a história do projeto de forma clara. Experimente no próximo commit e veja a diferença.