/si:promote — Transformer les apprentissages en règles
Déplace un modèle éprouvé de la mémoire automatique de Claude vers le système de règles du projet, où il devient une instruction contraignante plutôt qu'une simple note de fond.
Utilisation
/si:promote <description du modèle> # Détection automatique de la meilleure cible
/si:promote <modèle> --target claude.md # Promouvoir vers CLAUDE.md
/si:promote <modèle> --target rules/testing.md # Promouvoir vers une règle ciblée
/si:promote <modèle> --target rules/api.md --paths "src/api/**/*.ts" # Ciblée avec chemins
Workflow
Étape 1 : Comprendre le modèle
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 modèle dans la mémoire automatique
# Rechercher des entrées liées dans MEMORY.md
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 dire.
Étape 3 : Déterminer la bonne cible
| Portée du modèle | Cible | Exemple |
|---|---|---|
| S'applique à l'ensemble du projet | ./CLAUDE.md | "Utiliser pnpm, pas npm" |
| S'applique à des types de fichiers spécifiques | .claude/rules/<sujet>.md | "Les gestionnaires API ont besoin de validation" |
| S'applique à tous vos projets | ~/.claude/CLAUDE.md | "Privilégier la gestion explicite des erreurs" |
Si l'utilisateur n'a pas précisé 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 la mémoire automatique vers le format d'instruction de CLAUDE.md :
Avant (MEMORY.md — descriptif) :
Le projet utilise les workspaces pnpm. Quand j'ai essayé d'installer avec npm, 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 et dépendances
- Gestionnaire de paquets : pnpm (pas npm). Utiliser `pnpm install`.
Règles pour la distillation :
- Une règle par ligne si possible
- Voix impérative ("Utiliser X", "Toujours Y", "Jamais Z")
- Inclure la commande ou l'exemple, pas seulement le concept
- Pas d'historique — seulement l'instruction
Étape 5 : Écrire dans la cible
Pour CLAUDE.md :
- Lire le fichier 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 les
pathssi la règle est ciblée - É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 les schémas Zod
- Utiliser la classe `ApiError` pour les réponses d'erreur (pas l'objet Error brut)
- Inclure des commentaires JSDoc OpenAPI sur les fonctions de gestionnaire
Étape 6 : Nettoyer la mémoire automatique
Après la promotion, supprimez ou marquez l'entrée originale dans MEMORY.md :
# Afficher ce qui sera supprimé
grep -n "<modèle>" "$MEMORY_DIR/MEMORY.md"
Demandez à l'utilisateur de confirmer la suppression. Modifiez ensuite 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
Ce modèle est désormais une instruction contraignante. Claude le suivra dans toutes les sessions futures.
Guide de décision pour la promotion
Promouvoir quand :
- Le modèle est apparu 3 fois ou plus dans la mémoire automatique
- Vous avez corrigé Claude à ce sujet plus d'une fois
- Il s'agit d'une convention de projet que tout contributeur devrait connaître
- Cela évite une erreur récurrente
Ne pas promouvoir quand :
- Il s'agit d'une note de débogage ponctuelle (laisser dans la mémoire automatique)
- C'est un contexte spécifique à une session (la mémoire de session gère cela)
- Cela risque de changer bientôt (par exemple lors d'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 | Modèles spécifiques à un type de fichier |
| Commandes de build | Conventions de test |
| Décisions architecturales | Règles de conception d'API |
| Conventions d'équipe | Pièges spécifiques à un framework |
Conseils
- Garder CLAUDE.md sous 200 lignes — utiliser rules/ pour le surplus
- Une règle par ligne est plus facile à maintenir que des paragraphes
- Inclure la commande concrète, pas seulement le concept
- Réviser les règles promues trimestriellement — supprimer ce qui n'est plus pertinent