● Communauté
BayramAnnakov
⚡ Instantané
claude-reflect
par BayramAnnakov · BayramAnnakov/claude-reflect
Claude Code qui apprend silencieusement de vos corrections — capturant règles, préférences et approbations, puis les inscrivant dans CLAUDE.md / AGENTS.md.
claude-reflect s'exécute en arrière-plan des sessions Claude Code, observant les moments où vous corrigez, approuvez ou reformulez des préférences. Il distille ceux-ci en règles durables et met à jour CLAUDE.md et AGENTS.md afin que les sessions futures en héritent. Alternative légère à la curation manuelle d'un fichier d'instructions.
Pourquoi l'utiliser
Fonctionnalités clés
- Détecte les corrections implicites («en fait, fais-le comme ça») et les signaux positifs
- Rédige des ajouts de règles ; vous approuvez avant qu'ils atterrissent dans CLAUDE.md
- Les mêmes règles apparaissent dans AGENTS.md pour les outils non-Claude
- Consolidation périodique supprime les règles contradictoires ou périmées
- Mises à jour basées sur les diffs maintiennent l'historique git lisible
Démo en direct
Aperçu en pratique
prêt
Cas d'usage
Usages concrets : claude-reflect
Quand l'utiliser : Vous voulez que CLAUDE.md suive vos préférences sans être une corvée d'écriture.
Déroulement
-
Travailler normalement
Just code with Claude as usual. Correct it when wrong, praise it when right.✓ Copié
→ Le skill capture silencieusement — vous ne le remarquez pas
-
Revue en fin de journée
Use claude-reflect. Show me today's drafted rule additions. Approve or skip each.✓ Copié
→ 5–10 règles candidates avec provenance (quelle session, quel prompt)
-
Committer le diff
Apply approved rules and commit CLAUDE.md.✓ Copié
→ Diff git propre ; règles maintenant en vigueur
Résultat : CLAUDE.md qui grandit avec vous, sans coût de maintenance manuelle.
Pièges
- Le skill capture du contexte ponctuel comme règles durables — Toujours relire les candidats quotidiens ; rejeter tout ce qui est situationnel
Quand l'utiliser : Plusieurs développeurs corrigent Claude sur les mêmes choses ; vous voulez un ensemble de règles partagé.
Déroulement
-
Collecter les brouillons par développeur
Each dev runs claude-reflect daily and pushes their candidate rules to a shared review branch.✓ Copié
→ Branche avec N brouillons en attente
-
Fusionner les sessions
Use claude-reflect consolidate. Find rules captured by ≥2 people; promote those to AGENTS.md.✓ Copié
→ Ensemble de règles de terrain commun
-
Déployer
Merge to main. New AGENTS.md applies to everyone.✓ Copié
→ L'équipe utilise la même baseline ; les règles locales par développeur restent
Résultat : Standardisation bottom-up sans comité de processus.
Pièges
- Les développeurs bavards dominent ; les profils des plus discrets sont manqués — S'assurer que tout le monde exécute le skill ; pondérer par événements de réflexion, pas par éditions de fichiers
Quand l'utiliser : Votre CLAUDE.md fait maintenant 600 lignes et le contexte de Claude est gonflé.
Déroulement
-
Évaluer la pertinence
Use claude-reflect. Score each rule by recency-of-last-application and current-codebase-fit.✓ Copié
→ Score par règle
-
Proposer des suppressions
Suggest 30 rules to remove (stale or obsolete).✓ Copié
→ Liste de suppressions avec justification
-
Diff + committer
Apply approved removals; commit with message 'reflect: prune stale rules'.✓ Copié
→ CLAUDE.md allégé
Résultat : CLAUDE.md réellement lu, pas parcouru en diagonale.
Pièges
- Supprimer une règle qui n'était pas appliquée parce que Claude la respectait — En cas de doute, conserver — mais marquer avec «dernière vérification» pour re-vérifier au prochain trimestre
Combinaisons
Associez-le à d'autres MCPs pour un effet X10
pro-workflow pour la capture explicite, claude-reflect pour le passif — apprentissage à deux canaux
Use pro-workflow when you say 'remember this'; let claude-reflect catch the rest in the background.✓ Copié
Changements de règles revus via PR
Each Friday, claude-reflect opens a PR with proposed CLAUDE.md edits for human review.✓ Copié
Coût et limites
Coût d'exécution
- Quota d'API
- Aucun — local
- Tokens par appel
- La capture en arrière-plan est gratuite ; revue/consolidation utilise un LLM local si configuré
- Monétaire
- Gratuit
- Astuce
- Approuver les candidats de manière conservatrice — qualité > quantité
Sécurité
Permissions, secrets, portée
Portées minimales : filesystem-write
Stockage des identifiants : État du skill dans .claude/reflect/ ; committer dans le dépôt si vous voulez le partager
Sortie de données : Aucun par défaut
- Les logs de réflexion peuvent contenir des extraits de code sensibles — ajouter le log brut dans .gitignore ; committer uniquement les règles distillées
Dépannage
Erreurs courantes et correctifs
Aucun candidat capturé
Vérifier que le skill est invoqué dans le préambule CLAUDE.md ; vérifier les entrées dans .claude/reflect/log
Les candidats sont du bruit
Resserrer la sensibilité du déclencheur ; capturer uniquement depuis les corrections explicites, pas le chat générique
AGENTS.md diverge de CLAUDE.md
Exécuter consolidate périodiquement ; l'outil est conçu pour les maintenir synchronisés mais les modifications manuelles les font diverger
Prompt d'approbation accablant
Exécuter review avec --limit 5 quotidiennement ; construire une habitude plutôt que d'en faire 50 d'un coup
Alternatives
claude-reflect vs autres
| Alternative | Quand l'utiliser | Compromis |
|---|
| pro-workflow-skill | Vous préférez une capture explicite et l'orchestration de worktrees | Plus manuel ; plus puissant pour le travail parallèle |
| Curation manuelle de CLAUDE.md | Vous êtes assez discipliné pour écrire les règles vous-même | Souvent négligé ; repose sur la volonté |