/si:promote — Faire passer les apprentissages en règles
Déplace un motif éprouvé de l'auto-mémoire de Claude vers le système de règles du projet, où il devient une instruction exécutoire plutôt qu'une simple note de contexte.
Utilisation
/si:promote <description du motif> # Détection automatique de la meilleure cible
/si:promote <motif> --target claude.md # Promouvoir vers CLAUDE.md
/si:promote <motif> --target rules/testing.md # Promouvoir vers une règle ciblée
/si:promote <motif> --target rules/api.md --paths "src/api/**/*.ts" # Ciblé avec chemins
Workflow
Étape 1 : Comprendre le motif
Analysez la description de l'utilisateur. Si elle est vague, posez une question de clarification :
- "Quel comportement spécifique Claude doit-il suivre ?"
- "Cela s'applique-t-il à tous les fichiers ou à des chemins spécifiques ?"
Étape 2 : Trouver le motif dans l'auto-mémoire
# Rechercher dans MEMORY.md les entrées liées
MEMORY_DIR="$HOME/.claude/projects/$(pwd | sed 's|/|%2F|g; s|%2F|/|; s|^/||')/memory"
grep -ni "<mots-clés>" "$MEMORY_DIR/MEMORY.md"
Affichez les entrées correspondantes et confirmez qu'elles correspondent à ce que l'utilisateur veut.
Étape 3 : Déterminer la bonne cible
| Portée du motif | Cible | Exemple |
|---|---|---|
| S'applique à tout le projet | ./CLAUDE.md | "Utiliser pnpm, pas npm" |
| S'applique à des types de fichiers spécifiques | .claude/rules/<sujet>.md | "Les gestionnaires API nécessitent une validation" |
| S'applique à tous vos projets | ~/.claude/CLAUDE.md | "Préférer la gestion explicite des erreurs" |
Si l'utilisateur n'a pas spécifié de cible, recommandez-en une en fonction de la portée.
Étape 4 : Distiller en une règle concise
Transformez l'apprentissage du format de note de l'auto-mémoire en format d'instruction de CLAUDE.md :
Avant (MEMORY.md — descriptif) :
Le projet utilise des espaces de travail pnpm. Quand j'ai essayé npm install, cela a échoué. Le fichier de verrouillage est pnpm-lock.yaml. Il faut utiliser pnpm install pour les dépendances.
Après (CLAUDE.md — prescriptif) :
## Build & Dépendances
- Gestionnaire de paquets : pnpm (pas npm). Utilisez `pnpm install`.
Règles de distillation :
- Une règle par ligne si possible
- Voix impérative ("Utilisez X", "Toujours Y", "Jamais Z")
- Inclure la commande ou l'exemple, pas seulement le concept
- Pas d'historique — juste l'instruction
Étape 5 : Écrire dans la cible
Pour CLAUDE.md :
- Lire le CLAUDE.md existant
- Trouver la section appropriée (ou en créer une)
- Ajouter la nouvelle règle sous le bon titre
- Si le fichier dépasse 200 lignes, suggérer d'utiliser
.claude/rules/à la place
Pour .claude/rules/ :
- Créer le fichier s'il n'existe pas
- Ajouter le frontmatter YAML avec
pathssi ciblé - Écrire le contenu de la règle
---
paths:
- "src/api/**/*.ts"
- "tests/api/**/*"
---
# Règles de développement API
- Tous les endpoints doivent valider les entrées avec des schémas Zod
- Utiliser la classe `ApiError` pour les réponses d'erreur (pas raw Error)
- Inclure des commentaires JSDoc OpenAPI sur les fonctions gestionnaires
Étape 6 : Nettoyer l'auto-mémoire
Après la promotion, supprimez ou marquez l'entrée originale dans MEMORY.md :
# Afficher ce qui va être supprimé
grep -n "<motif>" "$MEMORY_DIR/MEMORY.md"
Demandez à l'utilisateur de confirmer la suppression. Ensuite, éditez MEMORY.md pour supprimer l'entrée promue. Cela libère de l'espace pour de nouveaux apprentissages.
Étape 7 : Confirmer
✅ Promu vers {{cible}}
Règle : "{{règle distillée}}"
Source : MEMORY.md ligne {{n}} (supprimée)
MEMORY.md : {{lignes}}/200 lignes restantes
Le motif est maintenant une instruction exécutoire. Claude le suivra dans toutes les sessions futures.
Guide de décision pour la promotion
Promouvoir quand :
- Le motif est apparu 3+ fois dans l'auto-mémoire
- Vous avez corrigé Claude à ce sujet plus d'une fois
- C'est une convention de projet que tout contributeur devrait connaître
- Cela évite une erreur récurrente
Ne pas promouvoir quand :
- C'est une note de débogage ponctuelle (laisser dans l'auto-mémoire)
- C'est un contexte spécifique à une session (la mémoire de session gère cela)
- Cela pourrait changer bientôt (par exemple, pendant une migration)
- Cela est déjà couvert par des règles existantes
CLAUDE.md vs .claude/rules/
| Utiliser CLAUDE.md pour | Utiliser .claude/rules/ pour |
|---|---|
| Règles globales du projet | Motifs spécifiques à un type de fichier |
| Commandes de build | Conventions de test |
| Décisions d'architecture | Règles de conception API |
| Conventions d'équipe | Astuces spécifiques au framework |
Astuces
- Gardez CLAUDE.md sous 200 lignes — utilisez rules/ pour le surplus
- Une règle par ligne est plus facile à maintenir que des paragraphes
- Incluez la commande concrète, pas seulement le concept
- Révisez les règles promues tous les trimestres — supprimez ce qui n'est plus pertinent