Git Commit com Commits Convencionais

Visão Geral

Crie commits git padronizados e semânticos usando a especificação Conventional Commits. Analise o diff real para determinar o tipo, escopo e mensagem apropriados.

Formato do Commit Convencional

<type>[optional scope]: <description>

[optional body]

[optional footer(s)]

Tipos de Commit

Breaking Changes

# Exclamation mark after type/scope
feat!: remove deprecated endpoint

# BREAKING CHANGE footer
feat: allow config to extend other configs

BREAKING CHANGE: `extends` key behavior changed

Fluxo de Trabalho

1. Analisar Diff

# If files are staged, use staged diff
git diff --staged

# If nothing staged, use working tree diff
git diff

# Also check status
git status --porcelain

2. Preparar Arquivos (se necessário)

Se nada estiver preparado ou você quiser agrupar as mudanças de forma diferente:

# Stage specific files
git add path/to/file1 path/to/file2

# Stage by pattern
git add *.test.*
git add src/components/*

# Interactive staging
git add -p

Nunca comite segredos (.env, credentials.json, chaves privadas).

3. Gerar Mensagem de Commit

Analise o diff para determinar:

• Tipo: Que tipo de mudança é esta?
• Escopo: Qual área/módulo é afetado?
• Descrição: Resumo em uma linha do que mudou (tempo presente, modo imperativo, <72 caracteres)

4. Executar Commit

# Single line
git commit -m "<type>[scope]: <description>"

# Multi-line with body/footer
git commit -m "$(cat <<'EOF'
<type>[scope]: <description>

<optional body>

<optional footer>
EOF
)"

Melhores Práticas

• Uma mudança lógica por commit
• Tempo presente: "adicionar" não "adicionado"
• Modo imperativo: "corrigir bug" não "corrige bug"
• Referenciar issues: Closes #123, Refs #456
• Manter a descrição com menos de 72 caracteres

Protocolo de Segurança Git

• NUNCA atualize a configuração do git
• NUNCA execute comandos destrutivos (--force, hard reset) sem solicitação explícita
• NUNCA pule hooks (--no-verify) a menos que o usuário peça
• NUNCA force push para main/master
• Se o commit falhar devido a hooks, corrija e crie um NOVO commit (não altere)