claude-reflect (Claude Skill) — Cas d'usage, Installer & Démo en direct

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

Installer

Choisissez votre client

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "claude-reflect-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/BayramAnnakov/claude-reflect",
        "~/.claude/skills/claude-reflect"
      ],
      "_inferred": true
    }
  }
}

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "claude-reflect-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/BayramAnnakov/claude-reflect",
        "~/.claude/skills/claude-reflect"
      ],
      "_inferred": true
    }
  }
}

Cursor utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "claude-reflect-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/BayramAnnakov/claude-reflect",
        "~/.claude/skills/claude-reflect"
      ],
      "_inferred": true
    }
  }
}

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "claude-reflect-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/BayramAnnakov/claude-reflect",
        "~/.claude/skills/claude-reflect"
      ],
      "_inferred": true
    }
  }
}

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "claude-reflect-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/BayramAnnakov/claude-reflect",
        "~/.claude/skills/claude-reflect"
      ]
    }
  ]
}

Continue utilise un tableau d'objets serveur plutôt qu'une map.

~/.config/zed/settings.json

{
  "context_servers": {
    "claude-reflect-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/BayramAnnakov/claude-reflect",
          "~/.claude/skills/claude-reflect"
        ]
      }
    }
  }
}

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

claude mcp add claude-reflect-skill -- git clone https://github.com/BayramAnnakov/claude-reflect ~/.claude/skills/claude-reflect

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : claude-reflect

Faire évoluer CLAUDE.md sans curation manuelle

👤 Développeurs solo qui détestent maintenir des fichiers de documentation ⏱ ~5 min beginner

Quand l'utiliser : Vous voulez que CLAUDE.md suive vos préférences sans être une corvée d'écriture.

Prérequis

Skill installé — git clone https://github.com/BayramAnnakov/claude-reflect ~/.claude/skills/claude-reflect
Réflexion activée — Ajouter use claude-reflect au préambule de votre CLAUDE.md de projet

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

Combiner avec : filesystem

Construire des conventions IA d'équipe depuis les corrections collectives

👤 Tech leads standardisant les workflows IA ⏱ ~60 min intermediate

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

Combiner avec : github

Auditer et élaguer les règles périmées dans CLAUDE.md

👤 Utilisateurs longue durée de CLAUDE.md ⏱ ~25 min intermediate

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

claude-reflect-skill + pro-workflow-skill

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é

claude-reflect-skill + github

Changements de règles revus via PR

Each Friday, claude-reflect opens a PR with proposed CLAUDE.md edits for human review.✓ Copié

Outils

Ce que ce MCP expose

Outil	Entrées	Quand appeler
watch_session	—	Processus en arrière-plan toujours actif
review_candidates	since?	Boucle d'approbation quotidienne / hebdomadaire
consolidate	scope?	Dédoublonnage périodique / résolution de contradictions
score_rules	—	Audit pré-élagage
apply_to_files	approved_ids[], files[]	Intégrer les candidats approuvés dans CLAUDE.md / AGENTS.md

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é

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills