repo-cleanup

Repo Cleanup Skill

Remove lixo acumulado em repositórios de forma segura e interativa. Detecta artefatos legados, apresenta em batches por categoria, e só deleta após confirmação explícita.

Core Principle

Repositórios acumulam lixo silenciosamente. O .gitignore protege o que nunca deveria entrar, mas arquivos já commitados (screenshots de teste antigos, docs de features removidas, scripts abandonados) só saem com intervenção manual. Essa skill faz a arqueologia, você aprova.

Segurança primeiro: in_degree=0 mente. Re-export chains, dynamic imports, CI YAML references, scripts npm run — tudo escapa de uma busca ingênua. Sempre verificar referências antes de propor deleção — busque em todo o repo com grep/ripgrep (basename, caminho da pasta e imports dinâmicos).

Code Search Order (busca por referências)

Antes de propor git rm em qualquer arquivo de código, módulo, ou pasta legada, procure referências no repositório inteiro com grep/ripgrep:

Pergunta	Como verificar
"<file> tem importadores?"	grep -rn "modulo" --include='*.ts' --include='*.tsx' (teste basename E caminho relativo)
"Quem usa <symbol> exportado?"	grep -rn "<symbol>" no repo inteiro
"Asset /public/foo.png é referenciado?"	grep -rn "foo.png" (assets carregam por string, não import)
Docs órfãs (.md sem links em outros .md)	grep -rn "nome-do-doc" (links são plain-text)
Scripts em package.json/CI YAML	grep -rn "nome-do-script" (configs são plain-text)

Atenção com imports indiretos: git rm em arquivo com re-export chain ou dynamic import quebra runtime sem aviso (CI passa, prod cai). grep por basename perde import X from './foo' quando o arquivo se chama foo/index.ts — então busque também pelo caminho da pasta e por imports dinâmicos (import(, require(). Na dúvida, não delete: liste para revisão manual.

Fluxo Geral

0. BASELINE              → lista de arquivos TRACKED pelo git (fonte única de verdade)
1. DETECTAR stack        → adapta heurísticas ao projeto
2. SCAN por categoria    → coleta candidatos (operando SEMPRE sobre o baseline)
3. VERIFICAR references  → grep cruzado antes de marcar lixo
4. APRESENTAR em batches → user aprova/rejeita/refina por categoria
5. EXECUTAR deleções     → git rm em commits separados por categoria
6. RELATÓRIO final       → resumo do que foi removido + bytes liberados