/ Verzeichnis / Playground / claude-reflect
← Alle Server ↗ GitHub
● Community BayramAnnakov ⚡ Sofort

claude-reflect

von BayramAnnakov · BayramAnnakov/claude-reflect

Claude Code, der still aus deinen Korrekturen lernt — Regeln, Präferenzen und Lob erfasst und in CLAUDE.md / AGENTS.md schreibt.

claude-reflect läuft im Hintergrund von Claude Code Sitzungen und achtet auf Momente, in denen du korrigierst, lobst oder Präferenzen neu formulierst. Es destilliert das zu dauerhaften Regeln und aktualisiert CLAUDE.md und AGENTS.md damit zukünftige Sitzungen sie übernehmen. Leichtgewichtige Alternative zur manuellen Pflege einer Anweisungsdatei.

▶ Demo ansehen 📦 Installieren 💡 Anwendungsfälle

Warum nutzen

Hauptfunktionen

Live-Demo

In der Praxis

bereit

Installation

Repository des Autors · Offizielle Dokumentation zu Claude Skills

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.

Ablauf
  1. Normal arbeiten
    Just code with Claude as usual. Correct it when wrong, praise it when right.✓ Kopiert
    → Skill erfasst still — du merkst es nicht
  2. 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)
  3. 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
  1. 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
  2. Sitzungen zusammenführen
    Use claude-reflect consolidate. Find rules captured by ≥2 people; promote those to AGENTS.md.✓ Kopiert
    → Gemeinsamer-Nenner-Regelwerk
  3. 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
  1. Relevanz bewerten
    Use claude-reflect. Score each rule by recency-of-last-application and current-codebase-fit.✓ Kopiert
    → Pro-Regel-Punkte
  2. Löschungen vorschlagen
    Suggest 30 rules to remove (stale or obsolete).✓ Kopiert
    → Löschliste mit Begründung
  3. 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

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

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

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

AlternativeWann stattdessenKompromiss
pro-workflow-skillExplizites Erfassen und Worktree-Orchestrierung bevorzugtManueller; leistungsfähiger für parallele Arbeit
Manual CLAUDE.md curationDiszipliniert genug, Regeln selbst zu schreibenHäufig vernachlässigt; beruht auf Willenskraft

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen