Pular para o conteúdo principal

Conventional Commits

Usamos Conventional Commits em português (Brasil) para padronizar as mensagens de commit e permitir versionamento semântico automático.

Formato

<tipo>(<escopo>): <descrição>

[corpo opcional]

Tipos principais

TipoUso
featNova funcionalidade
fixCorreção de bug
docsMudança em documentação
refactorRefatoração sem mudar comportamento
testAdição/ajuste de testes
choreTarefas de manutenção
buildMudanças no build/dependências
ciMudanças em CI

Exemplos

feat: adiciona página de onboarding
fix(backend): corrige validação de e-mail
docs: atualiza glossário com termo oauth2-proxy
refactor: simplifica função de deploy

Regras

  • Uma mudança lógica por commit — nada de misturar assuntos.
  • Descrição no imperativo e em pt-BR.
  • O escopo é opcional, mas útil quando a mudança é específica de uma área.