claude-reflect (Claude Skill) — Anwendungsfälle, Installieren & Live-Demo

Warum nutzen

Hauptfunktionen

Erkennt implizite Korrekturen ("mach es eigentlich so") und positive Signale
Entwirft Regelergänzungen; du genehmigst bevor sie in CLAUDE.md landen
Dieselben Regeln erscheinen in AGENTS.md für Nicht-Claude-Tooling
Periodische Konsolidierung entfernt widersprüchliche oder veraltete Regeln
Diff-basierte Aktualisierungen halten Git-Verlauf lesbar

Live-Demo

In der Praxis

bereit

Installieren

Wählen Sie Ihren 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
    }
  }
}

Öffne Claude Desktop → Settings → Developer → Edit Config. Nach dem Speichern neu starten.

~/.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 nutzt das gleiche mcpServers-Schema wie Claude Desktop. Projektkonfiguration schlägt die 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
    }
  }
}

Klicken Sie auf das MCP-Servers-Symbol in der Cline-Seitenleiste, dann "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
    }
  }
}

Gleiche Struktur wie Claude Desktop. Windsurf neu starten zum Übernehmen.

~/.continue/config.json

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

Continue nutzt ein Array von Serverobjekten statt einer 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"
        ]
      }
    }
  }
}

In context_servers hinzufügen. Zed lädt beim Speichern neu.

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

Einzeiler. Prüfen mit claude mcp list. Entfernen mit claude mcp remove.

Anwendungsfälle

Praxisnahe Nutzung: claude-reflect

CLAUDE.md ohne manuelle Pflege weiterentwickeln

👤 Solo-Entwickler, die Dokumentationsdateien pflegen hassen ⏱ ~5 min beginner

Wann einsetzen: Du willst, dass CLAUDE.md mit deinen Präferenzen Schritt hält ohne Schreibaufwand.

Voraussetzungen

Skill installiert — git clone https://github.com/BayramAnnakov/claude-reflect ~/.claude/skills/claude-reflect
Reflexion aktiviert — use claude-reflect zur CLAUDE.md-Präambel des Projekts hinzufügen

Ablauf

Normal arbeiten

Just code with Claude as usual. Correct it when wrong, praise it when right.✓ Kopiert

→ Skill erfasst still — du merkst es nicht
Tagesend-Review

Use claude-reflect. Show me today's drafted rule additions. Approve or skip each.✓ Kopiert

→ 5–10 Kandidatenregeln mit Herkunft (welche Sitzung, welcher Prompt)
Diff committen

Apply approved rules and commit CLAUDE.md.✓ Kopiert

→ Sauberer Git-Diff; Regeln jetzt in Kraft

Ergebnis: CLAUDE.md, das mit dir wächst, ohne manuellen Pflegeaufwand.

Fallstricke

Skill erfasst Einmalkontext als dauerhafte Regeln — Tägliche Kandidaten immer prüfen; situationsbedingte ablehnen

Kombinieren mit: filesystem

Team-weite KI-Konventionen aus kollektiven Korrekturen aufbauen

👤 Tech-Leads, die KI-Workflows standardisieren ⏱ ~60 min intermediate

Wann einsetzen: Mehrere Entwickler korrigieren Claude auf ähnliche Dinge; du willst ein gemeinsames Regelwerk.

Ablauf

Pro-Entwickler-Entwürfe sammeln

Each dev runs claude-reflect daily and pushes their candidate rules to a shared review branch.✓ Kopiert

→ Branch mit N ausstehenden Entwürfen
Sitzungen zusammenführen

Use claude-reflect consolidate. Find rules captured by ≥2 people; promote those to AGENTS.md.✓ Kopiert

→ Gemeinsamer-Nenner-Regelwerk
Ausrollen

Merge to main. New AGENTS.md applies to everyone.✓ Kopiert

→ Team nutzt dieselbe Baseline; pro-Entwickler lokale Regeln bleiben

Ergebnis: Bottom-up-Standardisierung ohne Prozesskomitee.

Fallstricke

Laute Entwickler dominieren; stille Muster werden übersehen — Sicherstellen, dass alle den Skill ausführen; nach Reflexionsereignissen gewichten, nicht Dateibearbeitungen

Kombinieren mit: github

Veraltete Regeln in CLAUDE.md prüfen und bereinigen

👤 Langjährige CLAUDE.md-Nutzer ⏱ ~25 min intermediate

Wann einsetzen: Deine CLAUDE.md hat nun 600 Zeilen und Claudes Kontext ist aufgebläht.

Ablauf

Relevanz bewerten

Use claude-reflect. Score each rule by recency-of-last-application and current-codebase-fit.✓ Kopiert

→ Pro-Regel-Punkte
Löschungen vorschlagen

Suggest 30 rules to remove (stale or obsolete).✓ Kopiert

→ Löschliste mit Begründung
Diff + Commit

Apply approved removals; commit with message 'reflect: prune stale rules'.✓ Kopiert

→ Schlankere CLAUDE.md

Ergebnis: CLAUDE.md die tatsächlich gelesen wird, nicht überflogen.

Fallstricke

Regel löschen, die nicht angewendet wurde weil Claude sie respektiert hat — Im Zweifelsfall behalten — aber mit 'zuletzt überprüft' markieren damit nächstes Quartal neu bewertet wird

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

claude-reflect-skill + pro-workflow-skill

pro-workflow für explizites Erfassen, claude-reflect für passives — zwei-Kanal-Lernen

Use pro-workflow when you say 'remember this'; let claude-reflect catch the rest in the background.✓ Kopiert

claude-reflect-skill + github

Regeländerungen per PR prüfbar machen

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

Werkzeuge

Was dieses MCP bereitstellt

Werkzeug	Eingaben	Wann aufrufen
watch_session	—	Always-on Hintergrundprozess
review_candidates	since?	Tägliche / wöchentliche Genehmigungsschleife
consolidate	scope?	Periodische Deduplizierung / Widerspruchsauflösung
score_rules	—	Pre-Bereinigung-Audit
apply_to_files	approved_ids[], files[]	Genehmigte Kandidaten in CLAUDE.md / AGENTS.md übertragen

Kosten & Limits

Was der Betrieb kostet

API-Kontingent: Keine — lokal
Tokens pro Aufruf: Hintergrunderfassung kostenlos; Review/Konsolidierung nutzt lokales LLM falls konfiguriert
Kosten in €: Kostenlos
Tipp: Kandidaten konservativ genehmigen — Qualität > Quantität

Sicherheit

Rechte, Secrets, Reichweite

Minimale Scopes: filesystem-write

Credential-Speicherung: Skill-Zustand in .claude/reflect/; ins Repo committen wenn geteilt gewünscht

Datenabfluss: Standardmäßig keine

Reflexionslogs können sensible Code-Snippets enthalten — Rohlog gitignoren; nur destillierte Regeln committen

Fehlerbehebung

Häufige Fehler und Lösungen

Keine Kandidaten erfasst

Prüfen ob Skill in CLAUDE.md-Präambel aufgerufen wird; .claude/reflect/log auf Einträge prüfen

Kandidaten sind Rauschen

Auslöseempfindlichkeit verringern; nur aus expliziten Korrekturen erfassen, nicht allgemeinem Chat

AGENTS.md driftet von CLAUDE.md

Periodisch konsolidieren; Tool ist darauf ausgelegt sie synchron zu halten, aber manuelle Bearbeitungen divergieren sie

Genehmigungsprompt überwältigend

Review mit --limit 5 täglich ausführen; Gewohnheit aufbauen statt 50 auf einmal zu machen

Alternativen

claude-reflect vs. andere

Alternative	Wann stattdessen	Kompromiss
pro-workflow-skill	Explizites Erfassen und Worktree-Orchestrierung bevorzugt	Manueller; leistungsfähiger für parallele Arbeit
Manual CLAUDE.md curation	Diszipliniert genug, Regeln selbst zu schreiben	Häufig vernachlässigt; beruht auf Willenskraft

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen