La checklist pour nettoyer Claude Code sans casser ton setup

00 Pourquoi

Chaque instruction doit mériter sa place 🧹

Claude Code charge tes fichiers d’instructions au démarrage. La mémoire automatique rejoint aussi le contexte de chaque session, dans la limite de ses 200 premières lignes ou de 25 Ko. Une règle obsolète ne reste donc pas simplement rangée dans un dossier : elle continue d’influencer le travail.

À garder

À sortir du contexte permanent

Les commandes de build et de test

Les arborescences que Claude peut lire dans le projet

Les conventions propres au projet

Une procédure longue utilisée une fois par mois

Les décisions et leurs raisons

Une règle ajoutée pour corriger un ancien modèle

Les pièges impossibles à deviner dans le code

Une préférence déjà enregistrée dans la mémoire

01 Le diagnostic

Commence par ces trois commandes ⌘

Mets d’abord Claude Code à jour : /skill-doctor demande la version 2.1.252 ou une version plus récente.

claude update

1. 1

   Lance /doctor

   Il vérifie ton installation et signale les éléments de configuration qui prennent de la place ou posent problème.

2. 2

   Lance /skill-doctor

   Il montre le coût de tes skills dans le contexte et repère ceux que tu n’utilises jamais.

3. 3

   Ouvre /memory

   Relis ce que Claude a mémorisé automatiquement et supprime les notes fausses, temporaires ou déjà présentes dans CLAUDE.md.

02 Toutes les quelques semaines

Fais le ménage courant en vingt minutes 🗓️

1. 1

   Relis les propositions de /doctor

   Accepte ce que Claude peut retrouver dans le code. Garde les pièges et les raisons derrière les décisions.

2. 2

   Trie les skills avec /skill-doctor

   Désactive ceux qui ne servent plus. Dans /skills, tu peux aussi les laisser visibles par leur nom seulement.

3. 3

   Nettoie /memory

   Enlève les informations fausses, ponctuelles ou répétées ailleurs.

4. 4

   Regarde /context dans une session neuve

   Tu vois ce qui occupe déjà le contexte avant même d’avoir écrit une demande.

5. 5

   Ouvre /mcp

   Désactive les serveurs que tu n’utilises plus. Les désactiver conserve leur configuration.

6. 6

   Vérifie /permissions

   Supprime les autorisations ponctuelles et resserre les règles trop larges. Une règle Bash(git *) autorise aussi le push.

7. 7

   Contrôle /hooks

   Vérifie que chaque automatisation sert encore et que le script qu’elle appelle existe toujours.

03 Après une mise à jour

Reteste les règles écrites pour l’ancien modèle ↻

1. 1

   Calme les règles qui crient

   Cherche les CRITICAL, YOU MUST, NEVER EVER et les lignes entières en majuscules. Garde un IMPORTANT uniquement si une règle est régulièrement ignorée.

2. 2

   Supprime les rappels de vérification génériques

   Si le nouveau modèle contrôle déjà son travail, une instruction vague du type “vérifie deux fois” peut surtout provoquer des boucles inutiles.

3. 3

   Passe chaque contournement au test de suppression

   Commence par les règles qui citent un ancien modèle ou réparent une erreur qui n’arrive plus.

04 Tous les trois mois

Vérifie la structure complète du setup 🔍

1. 1

   Cherche les contradictions

   Lis ensemble le CLAUDE.md global, celui du projet, les règles et la mémoire. Claude peut choisir arbitrairement entre deux consignes opposées.

2. 2

   Transforme les obligations en mécanismes

   Un formatage automatique, un test avant commit ou une commande interdite doivent être imposés par un hook ou une permission, pas seulement suggérés dans une phrase.

3. 3

   Déplace les procédures dans des skills

   Une méthode utilisée à la demande n’a pas besoin de charger dans chaque session.

4. 4

   Utilise des règles ciblées par chemin

   Une consigne qui concerne uniquement certains fichiers peut aller dans .claude/rules/ avec un champ paths.

5. 5

   Mesure à nouveau

   Relance /context et /skill-doctor pour voir si le nettoyage a réellement réduit le bruit.

05 Le test

Teste une suppression sans rien perdre 🧪

1. 1

   Choisis une seule règle

   Commence par la plus ancienne ou par une règle écrite en majuscules.

2. 2

   Masque-la temporairement

   Entoure-la d’un commentaire HTML. Claude Code retire ces commentaires du contexte, mais tu peux restaurer la règle en deux secondes.

   Copier

   <!-- règle à tester -->

3. 3

   Repars avec /clear

   Redonne à Claude la tâche pour laquelle la règle avait été ajoutée.

4. 4

   Compare le résultat

   Si rien ne change, supprime la règle. Si le résultat baisse, remets-la en la raccourcissant et en expliquant précisément pourquoi elle existe.

claude --safe-mode

06 Le skill

Lance un audit complet en lecture seule ✓

Le fichier proposé fait l’inventaire des instructions, skills, permissions, hooks, serveurs MCP et notes disponibles. Il classe chaque problème en garder, supprimer, fusionner, réécrire, déplacer ou vérifier. Surtout, il ne modifie rien avant que tu répondes avec les numéros précis à appliquer.

1. 1

   Télécharge le fichier SKILL.md

   Le bouton ouvre le fichier brut. Enregistre-le avec ce nom exact.

2. 2

   Crée son dossier

   Place-le dans ~/.claude/skills/claude-code-maintenance/SKILL.md pour le rendre disponible dans tous tes projets.

3. 3

   Lance-le manuellement

   Dans Claude Code, tape /claude-code-maintenance. Le skill est configuré pour ne jamais se déclencher tout seul.

/claude-code-maintenance

07 Le résultat

Lis le rapport avant d’accepter quoi que ce soit 📋

Verdict

Ce que ça veut dire

Garder

L’instruction apporte un contexte utile que Claude ne peut pas déduire seul.

Supprimer

Elle est fausse, dépassée, redondante ou inutilement générique.

Fusionner

Deux règles disent presque la même chose et peuvent devenir une seule consigne.

Réécrire

L’idée est bonne, mais la formulation est vague, agressive ou impossible à vérifier.

Déplacer

La règle serait plus fiable dans un hook, un skill ou une règle limitée à certains chemins.

Vérifier

Le skill manque de preuves et te pose une question au lieu d’inventer une conclusion.