artubss Finalizando uma Branch de Desenvolvimento
Visão Geral
Guie a conclusão do trabalho de desenvolvimento apresentando opções claras e executando o fluxo escolhido.
Princípio central: Verificar testes → Apresentar opções → Executar escolha → Limpar.
Anuncie no início: "Estou usando a skill finishing-a-development-branch para completar este trabalho."
O Processo
Etapa 1: Verificar Testes
Antes de apresentar opções, verifique se os testes passam:
# Executar suite de testes do projeto
npm test / cargo test / pytest / go test ./...
Se os testes falharem:
Testes falhando (<N> falhas). Deve-se corrigir antes de completar:
[Mostrar falhas]
Não é possível prosseguir com merge/PR até que os testes passem.
Pare. Não prossiga para a Etapa 2.
Se os testes passarem: Prossiga para a Etapa 2.
Etapa 2: Determinar Branch Base
# Tentar branches base comuns
git merge-base HEAD main 2>/dev/null || git merge-base HEAD master 2>/dev/null
Ou pergunte: "Esta branch foi criada a partir de main - isso está correto?"
Etapa 3: Apresentar Opções
Apresente exatamente estas 4 opções:
Implementação completa. O que você gostaria de fazer?
1. Fazer merge de volta para <base-branch> localmente
2. Fazer push e criar um Pull Request
3. Manter a branch como está (vou lidar depois)
4. Descartar este trabalho
Qual opção?
Não adicione explicações - mantenha as opções concisas.
Etapa 4: Executar Escolha
Opção 1: Fazer Merge Localmente
# Mudar para branch base
git checkout <base-branch>
# Atualizar
git pull
# Fazer merge da branch de feature
git merge <feature-branch>
# Verificar testes no resultado do merge
<comando de teste>
# Se os testes passarem
git branch -d <feature-branch>
Depois: Limpar worktree (Etapa 5)
Opção 2: Fazer Push e Criar PR
# Fazer push da branch
git push -u origin <feature-branch>
# Criar PR
gh pr create --title "<título>" --body "$(cat <<'EOF'
## Resumo
<2-3 bullets do que mudou>
## Plano de Teste
- [ ] <passos de verificação>
EOF
)"
Depois: Limpar worktree (Etapa 5)
Opção 3: Manter Como Está
Relatar: "Mantendo branch . Worktree preservada em ."
Não limpe a worktree.
Opção 4: Descartar
Confirme primeiro:
Isso vai deletar permanentemente:
- Branch <nome>
- Todos os commits: <lista-de-commits>
- Worktree em <caminho>
Digite 'descartar' para confirmar.
Aguarde a confirmação exata.
Se confirmado:
git checkout <base-branch>
git branch -D <feature-branch>
Depois: Limpar worktree (Etapa 5)
Etapa 5: Limpar Worktree
Para Opções 1, 2, 4:
Verificar se está em worktree:
git worktree list | grep $(git branch --show-current)
Se sim:
git worktree remove <caminho-worktree>
Para Opção 3: Manter worktree.
Referência Rápida
| Opção | Merge | Push | Manter Worktree | Limpar Branch |
|---|---|---|---|---|
| 1. Fazer merge localmente | ✓ | - | - | ✓ |
| 2. Criar PR | - | ✓ | ✓ | - |
| 3. Manter como está | - | - | ✓ | - |
| 4. Descartar | - | - | - | ✓ (force) |
Erros Comuns
Pular verificação de testes
- Problema: Fazer merge de código quebrado, criar PR com falhas
- Solução: Sempre verificar testes antes de oferecer opções
Perguntas abertas
- Problema: "O que faço agora?" → ambíguo
- Solução: Apresentar exatamente 4 opções estruturadas
Limpeza automática de worktree
- Problema: Remover worktree quando você pode precisar dela (Opções 2, 3)
- Solução: Limpar apenas para Opções 1 e 4
Sem confirmação para descartar
- Problema: Deletar trabalho acidentalmente
- Solução: Exigir confirmação digitada "descartar"
Sinais de Alerta
Nunca:
- Prosseguir com testes falhando
- Fazer merge sem verificar testes no resultado
- Deletar trabalho sem confirmação
- Fazer força de push sem solicitação explícita
Sempre:
- Verificar testes antes de oferecer opções
- Apresentar exatamente 4 opções
- Obter confirmação digitada para Opção 4
- Limpar worktree apenas para Opções 1 & 4
Integração
Chamada por:
- subagent-driven-development (Etapa 7) - Após todas as tarefas completarem
- executing-plans (Etapa 5) - Após todos os batches completarem
Funciona com:
- using-git-worktrees - Limpa a worktree criada por aquela skill