1001Ferramentas
💬 Dev

Gerador de Template de Commit

Template de mensagem de commit no padrão Conventional Commits (feat/fix/docs/...), com escopo, breaking change e referência a issue.

Mensagem de commit no formato de Conventional Commits

Conventional Commits padroniza a primeira linha do commit num formato que máquina consegue ler: tipo, escopo opcional, dois pontos e resumo. Isso não é burocracia — é o que permite gerar changelog automaticamente, decidir se a próxima versão é maior, menor ou de correção, e filtrar o histórico por tipo de mudança.

Preencha os campos e a página monta a mensagem completa, com corpo e rodapé quando existem. O marcador de mudança incompatível merece atenção: a exclamação depois do escopo sinaliza que a versão maior precisa subir, e o rodapé com a descrição da quebra é o que as ferramentas leem para montar a seção de avisos do changelog.

Salvo como arquivo e apontado na configuração, o modelo aparece pré-preenchido toda vez que você commita sem mensagem na linha de comando — o que faz o padrão ser seguido por inércia em vez de por disciplina. A convenção pede resumo no imperativo e curto, até uns cinquenta caracteres, porque é ele que aparece na listagem de uma linha e nas interfaces de revisão.

Perguntas frequentes

Quais tipos existem?
A especificação exige apenas feat e fix, que são os que afetam o número da versão. O restante é convenção adotada da mensagem do Angular: docs, style, refactor, perf, test, build, ci e chore. Vale combinar a lista no projeto, porque ferramenta de changelog costuma agrupar por esses nomes.
Como marco uma mudança incompatível?
De duas formas, e o comum é usar as duas: a exclamação logo antes dos dois pontos e o rodapé com a descrição do que quebrou. A exclamação é o que a maioria das ferramentas lê para subir a versão maior; o rodapé é o que vira texto no changelog.
Isso vale para o histórico que já existe?
Não, e reescrever histórico só para padronizar mensagem raramente compensa — muda todos os hashes e complica a vida de quem tem cópia local. O caminho normal é adotar daqui em diante e configurar a ferramenta de changelog para começar a contar de uma tag específica.

Ferramentas Relacionadas