netresearch/claude-coach-plugin

Coach – Selbstverbesserndes Lernsystem

Coach ermöglicht es Claude, aus Reibungspunkten zu lernen und sich kontinuierlich zu verbessern. Es erkennt Lernmöglichkeiten (Benutzerkorrekturen, wiederholte Anweisungen, Tool-Fehler, Tonfall-Eskalation), extrahiert verwertbare Verbesserungsvorschläge und schlägt Änderungen vor, die eine explizite Benutzerzustimmung erfordern.

Kernprinzip: Keine stillen Schreibvorgänge. Alle Verbesserungen erfordern die Zustimmung des Benutzers über /coach approve.

Aktivierungsauslöser

Aktivieren bei: Benutzerkorrekturen ("nein", "stopp", "nicht"), wiederholten Anweisungen, Tool-/Befehlsfehlern, Tonfall-Eskalation (GROSSBUCHSTABEN, "!!!"), Fähigkeitsergänzungen ("denk auch an..."), Warnungen zu veralteten Tools, expliziten /coach-Befehlen oder Sitzungsende.

Signalkategorien (Prioritätsreihenfolge)

1. COMMAND_FAILURE (Höchste) – Exit-Code ungleich null, stderr-Muster
2. USER_CORRECTION (Hoch) – Explizite Korrektursprache
3. SKILL_SUPPLEMENT (Hoch) – Zusätzliche Anleitung für eine Fähigkeit
4. VERSION_ISSUE (Mittel-Hoch) – Warnungen zu veralteten/überholten Inhalten
5. REPETITION (Mittel) – Semantisch ähnliche Anweisung wiederholt
6. TONE_ESCALATION (Niedrig) – Frustrationsindikatoren

Kandidatentypen

Typ	Beschreibung	Beispiel
rule	Stabile Einschränkung	"Generierte Dateien niemals bearbeiten"
checklist	Arbeitsschritt	"Tests nach Codeänderung ausführen"
snippet	Wiederholbarer Befehl	"Preflight-Check-Skript"
skill	Vorschlag zur Fähigkeitsaktualisierung	"Füge X-Anleitung zu Y-Fähigkeit hinzu"
antipattern	Nie zu tun	"Nie annehmen, dass Tool existiert"

Arbeitsablauf-Zusammenfassung

1. Erkennung – Hooks erfassen Ereignisse → ~/.claude-coach/events.sqlite
2. Generierung – Signale zu Vorschlägen aggregieren (Fingerabdrücke deduplizieren)
3. Umfang – Projekt vs. global pro Pfad/Sprache
4. Prüfung – /coach review genehmigt/lehnt ab/bearbeitet
5. Anwenden – Genehmigte Regeln → CLAUDE.md
6. Retrospektive – /coach retro ordnet manuelle Arbeit Fähigkeitslücken zu, erstellt PRs in Quell-Repositories

Dateiverzeichnisse

~/.claude-coach/
├── events.sqlite      # Rohe Reibungsereignisse
├── candidates.json    # Ausstehende Vorschläge
└── ledger.sqlite      # Repo-übergreifende Fingerabdrücke

~/.claude/ oder <repo>/.claude/
├── CLAUDE.md          # Ziel für Regeln
├── checklists/        # Arbeitsablauf-Checklisten
└── snippets/          # Wiederverwendbare Befehle

Skripte

Ausführen von ${CLAUDE_PLUGIN_ROOT}/scripts/:

Skript	Zweck
init_coach.py	Coach-System initialisieren
detect_signals.py	Mustererkennung für Reibungspunkte
aggregate.py	Signale in Kandidaten umwandeln
skill_analyzer.py	Fähigkeiten analysieren und auf veraltete Tools prüfen
apply.py	Genehmigte Vorschläge anwenden

Proaktive Befehle

• /coach scan – Auf veraltete CLI-Tools und Abhängigkeiten prüfen
• /coach retro – Sitzungsretrospektive: manuelle Arbeit analysieren, PRs erstellen, um Fähigkeiten im Quellcode zu verbessern

Detaillierte Architektur, Schemata und Muster finden Sie im Verzeichnis references/.