Config GC — Coleta de Lixo para Configurações de Código Claude

Emprestado da coleta de lixo em tempo de execução: escaneie periodicamente objetos que não são mais referenciados, redundantes, expirados ou de baixo valor, e recupere o espaço. A diferença crucial: aqui, a coleta requer um humano no ciclo. Nunca delete autonomamente.

Quando Ativar

• O usuário pede para limpar, auditar ou reduzir a configuração do Claude Code
• O usuário reclama de muitas skills, hooks barulhentos ou inicialização lenta da sessão
• Uma revisão mensal/periódica da configuração está agendada
• Após instalar um grande pacote de skills (ex: este repositório), para reconciliar sobreposições com a configuração existente

NÃO ative para: limpar código-fonte de projetos (isso é refatoração), limpar histórico de chat ou desinstalar o próprio Claude Code.

Filosofia de Design

1. Configurações "append-only" vazam. Skills, arquivos de memória, hooks e entradas de permissão só são adicionados. Sem revisão periódica, eles apodrecem silenciosamente.
2. Auditorias regulares batem purgas únicas. Escaneie a cada ~30 dias, proponha um pequeno lote de candidatos a cada vez.
3. Estratégias por canal. Cada tipo de acúmulo (skills, hooks, permissões, ...) tem seus próprios sinais de obsolescência — não aplique uma regra em todos os lugares.
4. Soft-delete primeiro. Renomeie para .disabled > mova para ~/.claude/_gc_trash/ > exclusão real. Sempre mantenha um caminho de desfazer.
5. Humano no ciclo forçado. Cada candidato recebe sua própria confirmação [y/n/skip]. Sem atalho "sim para todos".
6. Mantenha um log. Cada execução de GC adiciona ao ~/.claude/gc_log.md: o que foi tocado, por quê e como desfazer.

Canais de Escaneamento

Fluxo de Trabalho

1. Escanear todos os canais (ou o subconjunto nomeado pelo usuário). Coletar candidatos com: caminho, canal, sinal que o marcou, tamanho, data da última modificação.
2. Classificar por confiança (quebrado/órfão = alto; meramente antigo = baixo) e apresentar como uma tabela numerada. Limitar cada execução a ~20 candidatos — GC é periódico, não exaustivo.
3. Confirmar um por um. Para cada candidato, mostrar a evidência e perguntar [y/n/skip]. O usuário pode parar a qualquer momento.
4. Soft-delete os itens confirmados: preferir renomear .disabled para skills/hooks e mover _gc_trash/<date>/ para arquivos. Entradas de permissão vivem em JSON (sem comentários possíveis): fazer backup do arquivo de configurações, registrar cada entrada removida literalmente em gc_log.md, e então removê-la do array allow com jq. Somente excluir permanentemente quando o usuário pedir explicitamente.
5. Registrar a execução em ~/.claude/gc_log.md: timestamp, itens acionados, instruções de desfazer.
6. Relatar: tamanho recuperado, canais ainda saudáveis, data sugerida para a próxima revisão.

Exemplos de Comandos de Escaneamento

Scripts de hook órfãos (canal 3) — scripts no disco que nenhum config de hook referencia:

for f in ~/.claude/hooks/*; do
  name=$(basename "$f")
  grep -rq "$name" ~/.claude/settings.json ~/.claude/settings.local.json 2>/dev/null \
    || echo "ORPHAN: $f"
done

Entradas de permissão redundantes (canal 4) — duplicatas e concessões específicas ofuscadas por um curinga:

jq -r '.permissions.allow[]' ~/.claude/settings.local.json | sort | uniq -d

…