Fluxo de trabalho
- Inspecione o estado do repositório:
git status --short, git diff --cached e git diff. Verifique também git log --oneline -10 para corresponder ao estilo existente.
- Se nada estiver em staging, coloque as alterações relevantes em staging por caminho explícito (evite
git add -A se houver arquivos não relacionados ou sensíveis). Nunca coloque .env, segredos ou .venv em staging.
- Se as alterações contiverem preocupações claramente não relacionadas, divida-as em commits separados.
- Escreva a mensagem seguindo o formato abaixo, depois faça o commit com
git commit.
- Execute
git status para verificar se o commit foi bem-sucedido.
- Faça push apenas se o usuário passou
--push: execute git push (use git push -u origin <branch> se não houver upstream definido). Nunca force push.
Formato da mensagem
<tipo>(<escopo opcional>): <descrição>
<corpo opcional>
<rodapé opcional>
- Tipos:
feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert.
- Descrição: modo imperativo, minúscula, sem ponto final, máximo ~72 caracteres.
- Escopo: substantivo curto para a área afetada (ex.:
cli, server, translate); omita se não estiver claro.
- Corpo: explique o porquê, quebrado em ~72 caracteres; omita para alterações triviais.
- Mudanças de quebra (breaking changes): adicione
! após o tipo/escopo e um rodapé BREAKING CHANGE:.
Regras
- Não faça amend, rebase ou reescreva o histórico a menos que solicitado.
- Não pule hooks (
--no-verify).
- Se um hook falhar, corrija o problema e crie um novo commit.
- Não faça commit quando não houver alterações; em vez disso, informe isso.