Pousando o Avião
Limpeza pós-merge. Taxi-in metódico: inventário primeiro, decisão seção por seção, nunca destruir trabalho não commitado sem uma decisão explícita por worktree.
Quando usar
- Depois que um PR é mesclado e você quer excluir o branch de funcionalidade local + remoto
- Quando
.worktrees/acumulou múltiplos checkouts obsoletos - No final de uma sessão de desenvolvimento para limpar o ambiente de trabalho
- Quando o usuário diz "pousar o avião", "limpar", "organizar worktrees", "finalizar após merge" ou similar
Fluxo de trabalho
Guie o usuário pela limpeza nesta ordem. Execute o inventário primeiro, depois lide com os itens seção por seção. Seja conciso — diga o que está fazendo e faça apenas as perguntas que precisam de resposta.
1. Inventário
Execute estes comandos em lote e apresente os resultados ao usuário como um único bloco de inventário antes de fazer qualquer coisa destrutiva. Use caminhos absolutos e não assuma o diretório de trabalho atual:
git worktree list
echo '---status por worktree---'
for wt in $(git worktree list --porcelain | awk '/^worktree/ {print $2}' | grep -v "^$(git rev-parse --show-toplevel)$"); do
echo "=== $wt ==="
(cd "$wt" 2>/dev/null && git status --porcelain) || echo "(não foi possível acessar)"
done
echo '---branches locais mesclados (excluindo main)---'
git branch --merged main 2>/dev/null | grep -vE '^\*|main$|master$'
echo '---branches feat/* remotos mesclados---'
gh pr list --state merged --limit 50 --json headRefName,number --search "head:feat/" 2>/dev/null \
| jq -r '.[] | select(.headRefName | startswith("feat/")) | "\(.headRefName) (#\(.number))"' \
| head -20
echo '---refs remotas a podar (dry-run)---'
git remote prune origin --dry-run 2>&1 | grep -E 'would prune|^ ' | head -20
echo '---tamanho de dist/---'
[ -d dist ] && du -sh dist 2>/dev/null || echo "(sem dist/)"
echo '---entradas de memória criadas hoje---'
MEMDIR=$(find ~/.claude/projects -maxdepth 2 -name "memory" -type d -path "*$(basename "$(pwd)")*" 2>/dev/null | head -1)
if [ -n "$MEMDIR" ]; then
find "$MEMDIR" -name '*.md' -mtime -1 -type f 2>/dev/null | grep -v MEMORY.md | head -10 \
|| echo "(sem entradas recentes)"
else
echo "(nenhum diretório de memória específico do projeto encontrado)"
fi
Depois que o inventário for executado, apresente um resumo conciso:
Inventário (candidatos à limpeza):
- Worktrees a considerar: N (M sujas)
- Branches locais mesclados: N
- Branches feat/* remotos mesclados: N
- Refs remotas obsoletas: N
- dist/: ou ausente
- Entradas de memória de hoje: N (apenas informativo)
Prosseguir? (s/N)
Se o usuário disser não/cancelar → pare. Caso contrário, continue para a etapa 2.
2. Worktrees (decisões por worktree)
Para cada worktree que não seja main do inventário:
-
Limpa (status por worktree estava vazio): anuncie "removendo worktree limpa em
<caminho>" e executegit worktree remove <caminho>. Sem confirmação. -
Suja (status por worktree tinha saída): PARE. Mostre ao usuário:
Worktree em
<caminho>tem alterações não commitadas:<cole a saída do porcelain>Opções:
- (s) stash em um stash nomeado (ex.:
pre-cleanup-<branch>), depois remova worktree - (c) commit no branch atual, depois remova worktree
- (d) excluir perdendo alterações (
git worktree remove --force) - (k) manter esta worktree, pular limpeza
- (q) cancelar limpeza completamente
Escolha para
<caminho>?Respeite a escolha do usuário por worktree:
- s:
(cd <caminho> && git stash push -m "pre-cleanup-$(git branch --show-current)")entãogit worktree remove <caminho> - c: peça uma mensagem de commit;
(cd <caminho> && git add -A && git commit -m "<msg>")entãogit worktree remove <caminho> - d:
git worktree remove --force <caminho>(após confirmar mais uma vez — destrutivo) - k: pule; anote no relatório final
- q: pare todo o fluxo, vá para a etapa 6
- (s) stash em um stash nomeado (ex.:
3. Branches locais + remotos (confirmação em lote)
Depois que as worktrees forem tratadas:
- Liste os branches locais mesclados (excluindo
main/master). Pergunte: "Excluir estes N branches locais? (s/N)" — confirmação única, entãogit branch -d <cada um>. Segit branch -drecusar algum branch (commits não mesclados), pause e pergunte ao usuário antes de usar-D. - Liste os branches feat/* remotos mesclados. Pergunte: "Excluir estes N branches remotos? (s/N)" — confirmação única, então
git push origin --delete <branch1> <branch2> ...em um lote. - Depois das exclusões remotas:
git remote prune origin(sem confirmação — implícito na confirmação do usuário).
Se alguma lista estiver vazia, pule sua pergunta.
4. Diretório dist/
Se dist/ existir no inventário, pergunte: "Remover dist/ (tamanho: X)? (s/N)". Se sim, rm -rf dist.
5. Entradas de memória (apenas informativo)
Se o inventário encontrou entradas de memória criadas hoje: liste-as com caminhos. Diga ao usuário:
Estas entradas de memória foram criadas hoje. Revise-as em
<diretório>e remova as que são muito restritas ou específicas da sessão. Não tocarei na memória automaticamente.
NÃO exclua ou modifique nenhum arquivo de memória. Siga em frente.
6. Relatório final
Execute git status e git worktree list. Mostre ao usuário:
Limpeza concluída.
- Worktrees removidas: N (mantidas: M)
- Branches locais excluídos: N
- Branches remotos excluídos: N
- Refs obsoletas podadas: N
- dist/: removido / mantido / ausente
<saída do git status>
Se algo foi mantido (worktrees sujas que o usuário optou por manter, etc.), liste explicitamente para que o usuário saiba o que sobrou.
Composição com outras skills
bones-powers:finishing-a-bones-leaf— após fan-in + git push + merge de PR, passe paraland-the-planelimpar o branch de funcionalidade e worktree.superpowers:finishing-a-development-branch— mesmo padrão de passagem para fluxos que não são bones.
Regras de segurança
- Nunca exclua uma worktree com alterações não commitadas sem o usuário escolher a opção (s/c/d) para aquela worktree específica.
- Nunca force-exclua (
-D) um branch local que não foi mesclado sem confirmação explícita do usuário para aquele branch. - Nunca exclua um branch remoto que não corresponda a
feat/*(ou que sejamain/master). - Nunca modifique arquivos de memória. Apenas liste.
- Se qualquer etapa falhar, exiba o erro na íntegra e pergunte ao usuário antes de tentar novamente ou pular.
Tom
Conciso. Não narre a intenção — apenas diga o que está fazendo e faça a pergunta direcionada. Reforce a metáfora "pousar o avião": fim do voo, taxi-in metódico.