Aterrizaje
Limpieza posterior a la fusión. Taxeo metódico: primero inventario, luego decidir sección por sección, nunca destruir cambios no confirmados sin una decisión explícita por worktree.
Cuándo usar
- Después de que un PR se haya fusionado y quieras eliminar la rama de características local y remota
- Cuando
.worktrees/ha acumulado múltiples checkouts obsoletos - Al final de una sesión de desarrollo para limpiar el entorno de trabajo
- Cuando el usuario dice "aterrizar el avión", "limpiar", "ordenar worktrees", "finalizar después de fusionar" o similar
Flujo de trabajo
Guía al usuario a través de la limpieza en este orden. Ejecuta el inventario primero, luego maneja los elementos sección por sección. Sé conciso: di lo que estás haciendo y solo haz las preguntas que necesitan respuesta.
1. Inventario
Ejecuta estos comandos en un lote y presenta los resultados al usuario como un bloque de inventario único antes de hacer algo destructivo. Usa rutas absolutas y no asumas el directorio de trabajo actual (cwd):
git worktree list
echo '---estado 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 "(no se puede acceder)"
done
echo '---ramas locales fusionadas (excluyendo main)---'
git branch --merged main 2>/dev/null | grep -vE '^\*|main$|master$'
echo '---ramas remotas feat/* fusionadas---'
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 (simulación)---'
git remote prune origin --dry-run 2>&1 | grep -E 'would prune|^ ' | head -20
echo '---tamaño de dist/---'
[ -d dist ] && du -sh dist 2>/dev/null || echo "(no hay dist/)"
echo '---entradas de memoria creadas hoy---'
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 "(no hay entradas recientes)"
else
echo "(no se encontró directorio de memoria específico del proyecto)"
fi
Después de ejecutar el inventario, presenta un resumen conciso:
Inventario (candidatos a limpiar):
- Worktrees a considerar: N (M sucios)
- Ramas locales fusionadas: N
- Ramas remotas feat/* fusionadas: N
- Refs remotas obsoletas: N
- dist/: <tamaño> o ausente
- Entradas de memoria de hoy: N (solo informativo)
¿Proceder? (s/N)
Si el usuario dice no/abortar → detener. De lo contrario, continuar con el paso 2.
2. Worktrees (decisiones por worktree)
Para cada worktree que no sea main del inventario:
-
Limpio (el estado del worktree estaba vacío): anuncia "eliminando worktree limpio en
<ruta>" y ejecutagit worktree remove <ruta>. Sin aviso. -
Sucio (el estado del worktree tenía salida): DETENTE. Muestra al usuario:
El worktree en
<ruta>tiene cambios no confirmados:<pegar la salida porcelain>Opciones:
- (s) guardar en un stash con nombre (ej.
pre-cleanup-<rama>), luego eliminar worktree - (c) hacer commit en la rama actual, luego eliminar worktree
- (d) eliminar perdiendo cambios (
git worktree remove --force) - (k) conservar este worktree, omitir limpieza
- (q) abortar la limpieza por completo
¿Elección para
<ruta>?Respeta la elección del usuario por worktree:
- s:
(cd <ruta> && git stash push -m "pre-cleanup-$(git branch --show-current)")luegogit worktree remove <ruta> - c: pide un mensaje de commit;
(cd <ruta> && git add -A && git commit -m "<mensaje>")luegogit worktree remove <ruta> - d:
git worktree remove --force <ruta>(después de confirmar una vez más — destructivo) - k: omitir; anotar en el informe final
- q: detener todo el flujo, saltar al paso 6
- (s) guardar en un stash con nombre (ej.
3. Ramas locales y remotas (confirmación por lotes)
Después de manejar los worktrees:
- Lista las ramas locales fusionadas (excluyendo
main/master). Pregunta: "¿Eliminar estas N ramas locales? (s/N)" — confirmación única, luegogit branch -d <cada_una>. Sigit branch -drechaza alguna rama (commits no fusionados), pausa y pregunta al usuario antes de usar-D. - Lista las ramas remotas feat/* fusionadas. Pregunta: "¿Eliminar estas N ramas remotas? (s/N)" — confirmación única, luego
git push origin --delete <rama1> <rama2> ...en un solo lote. - Después de las eliminaciones remotas:
git remote prune origin(sin aviso — implícito en la confirmación del usuario).
Si alguna lista está vacía, omite su aviso.
4. Directorio dist/
Si dist/ existe del inventario, pregunta: "¿Eliminar dist/ (tamaño: X)? (s/N)". Si sí, rm -rf dist.
5. Entradas de memoria (solo informativo)
Si el inventario encontró entradas de memoria creadas hoy: listarlas con rutas. Dile al usuario:
Estas entradas de memoria fueron creadas hoy. Revísalas en
<dir>y elimina las que sean demasiado específicas o de una sesión. No tocaré la memoria automáticamente.
NO eliminar ni modificar ningún archivo de memoria. Continuar.
6. Informe final
Ejecuta git status y git worktree list. Muestra al usuario:
Limpieza completa.
- Worktrees eliminados: N (conservados: M)
- Ramas locales eliminadas: N
- Ramas remotas eliminadas: N
- Refs obsoletas podadas: N
- dist/: eliminado / conservado / ausente
<salida de git status>
Si algo se conservó (worktrees sucios que el usuario optó por mantener, etc.), listarlo explícitamente para que el usuario sepa qué queda.
Composición con otras habilidades
bones-powers:finalizando-una-hoja-bones— después de fan-in + git push + fusión de PR, pasar aaterrizar-el-aviónpara limpiar la rama de características y el worktree.superpowers:finalizando-una-rama-de-desarrollo— mismo patrón de traspaso para flujos de trabajo que no son bones.
Reglas de seguridad
- Nunca eliminar un worktree con cambios no confirmados sin que el usuario elija la opción (s/c/d) para ese worktree específico.
- Nunca forzar la eliminación (
-D) de una rama local que no esté fusionada sin confirmación explícita del usuario para esa rama. - Nunca eliminar una rama remota que no coincida con
feat/*(o seamain/master). - Nunca modificar archivos de memoria. Solo listar.
- Si algún paso falla, mostrar el error textualmente y preguntar al usuario antes de reintentar u omitir.
Tono
Conciso. No narrar la intención — solo decir lo que se está haciendo y hacer la pregunta específica. Usar el marco de "aterrizar el avión": fin del vuelo, taxeo metódico.