Our review

This protocol guides users in performing safe Git merges and resolving common issues, especially for GitHub Pages.

Strengths

Provides a step-by-step protocol to avoid incomplete merges.
Includes specific solutions for GitHub Pages cache problems.
Offers troubleshooting techniques for stuck states (rebase, locks).

Limitations

Does not cover advanced conflict resolution strategies.
GitHub Pages cache solutions may be temporary.
Some commands require administrative privileges on the file system.

When to use it

Use this protocol when performing a merge between branches or encountering update issues with GitHub Pages.

When not to use it

Do not use for very simple merges with no complex history or when you consistently use a rebase workflow.

Examples

Merge incomplet

J'ai fusionné une branche feature dans main, mais tous les commits ne sont pas arrivés. Comment puis-je vérifier et corriger cela ?

Cache GitHub Pages

Mon site GitHub Pages ne montre pas les dernières modifications après un merge. Que puis-je faire pour forcer une mise à jour ?

Rebase bloqué

Git est bloqué en mode rebase après une tentative de rebase avortée. Comment le réinitialiser proprement ?

🚀 Skill: Git Merge Mastery - Evitar Problemas de Merge

Objetivo

Prevenir e resolver problemas comuns de git merge, especialmente com GitHub Pages.

Problemas Comuns Identificados

Merge incompleto - Commits da feature branch não chegam no main
Cache do GitHub Pages - HTML antigo persiste mesmo após updates
Conflitos de arquivos binários - HTML/CSS com conflitos complexos
Rebase travado - Git em estado inconsistent

📋 Protocolo de Merge Seguro

1. PRÉ-MERGE (Preparação)

# Verificar diferenças entre branches
git diff main..feature/nova-feature --name-only

# Verificar histórico
git log --oneline --graph --all --decorate -10

# Ensure clean working directory
git status
git checkout .

2. MERGE CORRETO (Passo a passo)

# 1. Atualizar main
git checkout main
git pull origin main

# 2. Fazer merge explícito
git merge feature/nova-feature --no-ff -m "feat: merge completo de feature/nova-feature"

# 3. Verificar conflitos
git status

# 4. Resolver conflitos se necessário
git checkout --theirs arquivo-conflitante.html
git add arquivo-conflitante.html

# 5. Finalizar merge
git commit -m "resolve: conflitos do merge"

3. PÓS-MERGE (Validação)

# Verificar se TODOS os commits chegaram
git log --oneline -5

# Verificar arquivos específicos
git show HEAD --name-only

# Testar localmente antes do push
python -m http.server 8000  # Verificar se funciona

🎯 Solução Para GitHub Pages Cache

Quando o GitHub Pages não atualiza:

# 1. Mudar nome do arquivo principal (FORÇA rebuild)
mv docs/index.html docs/dashboard-NOVO.html

# 2. Criar redirect simples
echo "<!DOCTYPE html><html><head><meta http-equiv='refresh' content='0; URL=./dashboard-NOVO.html'></head><body>Redirecting...</body></html>" > docs/index.html

# 3. Commit e push
git add docs/index.html docs/dashboard-NOVO.html
git commit -m "fix: força rebuild GitHub Pages com redirect"
git push

# 4. Após 5min, restaurar nome original
mv docs/dashboard-NOVO.html docs/index.html
git add docs/index.html
git commit -m "fix: restaura nome original após rebuild"
git push

🔧 Troubleshooting de Estados Travados

Git em rebase/interactive mode:

# Abortar rebase
git rebase --abort

# Resetar para estado limpo
git reset --hard origin/main

# Remover locks se necessário
rm -f .git/index.lock

Processos git travados (Windows):

# Matar processos git
taskkill /f /im git*

taskkill /f /im GitHubDesktop.exe

📊 Verificação de Sucesso

Após merge, verificar:

✅ GitHub Actions passando
✅ GitHub Pages atualizado (aguardar 2-5min)
✅ Testar URL atual com Ctrl+Shift+R (hard refresh)
✅ Confirmar que todos os arquivos da feature estão no main

⚠️ Checklists de Segurança

ANTES de fazer merge:

[ ] Backup dos arquivos importantes
[ ] Verificar diferenças entre branches
[ ] Testar feature branch localmente
[ ] Coordenar com time se aplicável

APÓS merge:

[ ] Verificar se build passa
[ ] Testar produção
[ ] Documentar mudanças
[ ] Informar stakeholders

🚨 Casos Especiais

Merge de grandes refactors:

# Fazer merge gradual
git merge feature/refactor --no-commit
# Verificar arquivo por arquivo
git status
git diff --cached
# Commit apenas quando confirmado
git commit -m "feat: merge seguro de refactor grande"

Rollback seguro:

# Reverter merge específico
git revert -m 1 MERGE_COMMIT_HASH

# Ou reset hard (cuidado!)
git reset --hard COMMIT_ANTERIOR

Lembrete: Sempre prefira merge --no-ff para manter histórico claro e evitar problemas com GitHub Pages!

Git Merge Mastery - Avoid Merge Problems

Recommended for