config-gc

Config GC — Garbage Collection pour les configurations Claude Code

Emprunté au garbage collection des environnements d'exécution : analyser périodiquement les objets qui ne sont plus référencés, redondants, expirés ou de faible valeur, et récupérer l'espace. La différence cruciale : ici, la collecte nécessite un humain dans la boucle. Ne jamais supprimer de manière autonome.

Quand activer

• L'utilisateur demande de nettoyer, auditer ou réduire la taille de sa configuration Claude Code
• L'utilisateur se plaint d'un trop grand nombre de skills, de hooks bruyants, ou d'un démarrage de session lent
• Une revue mensuelle/périodique de la configuration est due
• Après l'installation d'un pack de skills volumineux (par exemple ce dépôt), pour réconcilier les chevauchements avec la configuration existante

Ne PAS activer pour : nettoyer le code source d'un projet (c'est du refactoring), effacer l'historique des conversations, ou désinstaller Claude Code lui-même.

Philosophie de conception

1. Les configurations en mode ajout-seulement fuient. Les skills, fichiers mémoire, hooks et entrées de permissions ne font que s'ajouter. Sans revue périodique, ils pourrissent en silence.
2. Les audits réguliers valent mieux qu'un nettoyage unique. Scanner tous les ~30 jours, proposer un petit lot de candidats à chaque fois.
3. Stratégies par canal. Chaque type d'accumulation (skills, hooks, permissions, ...) a ses propres signaux d'obsolescence — ne pas appliquer une règle uniforme partout.
4. Suppression douce d'abord. Renommer en .disabled > déplacer vers ~/.claude/_gc_trash/ > vraie suppression. Toujours garder un chemin d'annulation.
5. Humain dans la boucle obligatoire. Chaque candidat reçoit sa propre confirmation [y/n/skip]. Pas de raccourci "oui à tout".
6. Tenir un journal. Chaque exécution de GC ajoute à ~/.claude/gc_log.md : ce qui a été touché, pourquoi, et comment l'annuler.

Canaux d'analyse

#	Canal	Chemin	Signaux d'obsolescence / redondance
1	Skills	~/.claude/skills/*/	Noms fortement redondants ; jamais déclenchés dans les transcriptions récentes ; décalage de domaine avec le travail réel de l'utilisateur ; SKILL.md cassé ou vide
2	Mémoire	~/.claude/**/memory/*.md + son index	Plusieurs entrées d'index pour un même sujet ; contenus contredisant des entrées plus récentes ; dates dépassées ; fichiers orphelins absents de l'index ; fragments de moins de 100 mots qui devraient être fusionnés
3	Hooks	~/.claude/hooks/ + paramètres	Scripts présents sur le disque mais référencés par aucune configuration de hook ; anciennes versions remplacées par des réécritures
4	Permissions	permissions.allow dans settings.json / settings.local.json	Entrées en double ; entrées spécifiques déjà couvertes par un joker (par ex. Bash(git push) quand Bash(*) est autorisé) ; autorisations ponctuelles d'expériences passées
5	Serveurs MCP	~/.claude.json ou .mcp.json du projet	Serveurs qui échouent à se connecter ; doublons fonctionnels ; inutilisés depuis longtemps
6	Rappels programmés / tâches	là où l'utilisateur les conserve	Événements uniques datant de plus de 30 jours ; tâches dont les scripts cibles n'existent plus
7	Historique des projets	~/.claude/projects/*/	Instantanés de transfert obsolètes ; enregistrements de session remplacés par un état plus récent
8	Caches d'exécution	cache/, file-history/, logs/, shell-snapshots/	Trier par taille et date de modification ; proposer les éléments de plus de 30 jours et volumineux

Flux de travail

1. Analyser tous les canaux (ou le sous-ensemble nommé par l'utilisateur). Collecter les candidats avec : chemin, canal, signal qui l'a signalé, taille, dernière modification.
2. Classer par confiance (cassé/orphelin = élevé ; simplement ancien = faible) et présenter sous forme de tableau numéroté. Limiter chaque exécution à ~20 candidats — GC est périodique, pas exhaustif.
3. Confirmer un par un. Pour chaque candidat, montrer les preuves, puis demander [y/n/skip]. L'utilisateur peut s'arrêter à tout moment.
4. Supprimer en douceur les éléments confirmés : préférer le renommage en .disabled pour les skills et hooks, et le déplacement vers _gc_trash/<date>/ pour les fichiers. Les entrées de permissions vivent dans du JSON (pas de commentaires possibles) : sauvegarder le fichier de paramètres, enregistrer chaque entrée supprimée textuellement dans gc_log.md, puis la retirer du tableau allow avec jq. Ne supprimer définitivement que si l'utilisateur le demande explicitement.
5. Journaliser l'exécution dans ~/.claude/gc_log.md : horodatage, éléments traités, instructions d'annulation.
6. Rapporter : taille récupérée, canaux encore sains, date de prochaine revue suggérée.

Exemples de commandes d'analyse

Scripts de hooks orphelins (canal 3) — scripts sur le disque qu'aucune configuration de hook ne référence :

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

Entrées de permissions redondantes (canal 4) — doublons, et autorisations spécifiques éclipsées par un joker :

jq -r '.permissions.allow[]' ~/.claude/settings.local.json | sort | uniq -d
if jq -e '.permissions.allow | index("Bash(*)")' ~/.claude/settings.local.json >/dev/null; then
  jq -r '.permissions.allow[]' ~/.claude/settings.local.json \
    | grep '^Bash(' | grep -vF 'Bash(*)'
fi

Plus grands caches obsolètes (canal 8) — utiliser du -k au lieu de find -printf (spécifique à GNU) pour fonctionner sur macOS/BSD :

find ~/.claude/file-history ~/.claude/shell-snapshots -type f -mtime +30 \
  -exec du -k {} + 2>/dev/null | sort -rn | head -20

Suppression douce avec chemin d'annulation (capturer la date une fois pour que le journal ne puisse pas contredire le répertoire) :

gc_date=$(date +%Y-%m-%d)
mkdir -p ~/.claude/_gc_trash/$gc_date
mv ~/.claude/skills/dead-skill ~/.claude/_gc_trash/$gc_date/
echo "$(date -Iseconds) déplacé skills/dead-skill -> _gc_trash/$gc_date/ (annulation : mv retour)" >> ~/.claude/gc_log.md

Supprimer une entrée de permission confirmée comme redondante (JSON n'a pas de commentaires — sauvegarder, journaliser, puis éditer) :

cp ~/.claude/settings.local.json ~/.claude/settings.local.json.bak
echo "$(date -Iseconds) entrée de permission supprimée : Bash(git push) (annulation : restaurer depuis .bak ou rajouter)" >> ~/.claude/gc_log.md
jq '.permissions.allow -= ["Bash(git push)"]' ~/.claude/settings.local.json.bak \
  > ~/.claude/settings.local.json

Anti-patrons

• Approbation en bloc. Demander "supprimer les 15 ? [y/n]" va à l'encontre de la conception. Un élément, une décision.
• Suppression définitive au premier passage. S'il n'y a pas de copie dans _gc_trash/ ou de renommage en .disabled, vous avez fait une erreur.
• Considérer "vieux" comme "mort". Une skill non utilisée depuis 60 jours peut être saisonnière (saison des impôts, revues trimestrielles). L'âge est un signal, pas un verdict — c'est pourquoi un humain confirme.
• Nettoyer la mémoire par troncature. Fusionner deux fichiers mémoire contradictoires nécessite de les lire et de conserver la vérité la plus récente, pas de supprimer le plus long.
• Toucher à quoi que ce soit en dehors de ~/.claude (ou du .claude/ du projet). Config GC ne s'aventure jamais dans les arborescences source.

Bonnes pratiques

• Exécuter après de gros ajouts, pas seulement selon un calendrier : l'installation d'un pack de 50 skills est précisément le moment où des chevauchements avec les skills existants apparaissent.
• Lorsque deux skills se chevauchent, préférer désactiver celle dont la description de déclenchement est la plus faible — c'est celle qui ne se déclenchait probablement jamais de toute façon.
• Le nettoyage des permissions est le canal au meilleur rapport qualité-prix par minute passée : les entrées allow redondantes rendent la revue de sécurité plus difficile.
• Conserver gc_log.md indéfiniment. C'est minuscule, et "quand ai-je désactivé ce hook et pourquoi" revient plus souvent qu'on ne le pense.

Compétences associées

• skill-stocktake — audite la qualité des skills ; config-gc audite l'existence des skills. Exécuter stocktake sur ce qui survit à GC.
• workspace-surface-audit — le pendant additif : recommande ce qu'il faut installer. config-gc est la moitié soustractive du même cycle de vie.
• configure-ecc — après avoir installé des skills avec, exécuter config-gc pour réconcilier les chevauchements avec votre configuration préexistante.
• continuous-learning — produit les fichiers mémoire que cette skill audite ensuite.
• security-review — se marie bien avec le canal des permissions.