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
| Tipo | Uso |
|---|---|
feat | Nova funcionalidade |
fix | Correção de bug |
docs | Mudança em documentação |
refactor | Refatoração sem mudar comportamento |
test | Adição/ajuste de testes |
chore | Tarefas de manutenção |
build | Mudanças no build/dependências |
ci | Mudanç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.