| name | semantic-commit |
| version | 1.0.0 |
| description | Cria commits semanticos no padrao Conventional Commits (feat, fix, chore, docs, refactor, test, ci). Use quando precisar commitar mudancas com mensagem estruturada e rastreavel. Nao use para revisar ou implementar codigo — apenas para a acao de commit. |
Commit Semantico
Procedimentos
Etapa 1: Analisar mudancas
- Confirmar que o contrato de carga base definido em
AGENTS.md foi cumprido.
- Executar
git diff --cached --stat para ver o que esta staged.
- Se nada estiver staged, executar
git status e listar arquivos nao staged.
- Identificar o tipo da mudanca:
feat, fix, docs, refactor, test, chore, ci, perf.
- Identificar o escopo (modulo, pacote, servico afetado).
Etapa 2: Compor a mensagem
- Formato:
<tipo>(<escopo>): <descricao em imperativo>
- Descricao: ≤72 caracteres, sem ponto final, em ingles ou portugues conforme padrao.
- Body opcional: separado por linha em branco, explicando por que (nao o que).
- Footer:
BREAKING CHANGE: quando houver quebra de compatibilidade; Closes #nn para issues.
Etapa 3: Executar o commit
- Confirmar com o usuario o texto final da mensagem antes de commitar.
- Executar
git commit -m "$(cat <<'EOF'\n<mensagem>\nEOF\n)".
- Nunca usar
--no-verify ou --no-gpg-sign a menos que explicitamente solicitado.
Tratamento de Erros
- Se pre-commit hook falhar, diagnosticar a causa e corrigir antes de retentar — nao contornar o hook.
- Se nada estiver staged e o usuario quiser commitar tudo, perguntar quais arquivos incluir antes de
git add.
- Nao fazer amend de commits ja publicados no remoto.
