/si:promote — Erkenntnisse in Regeln überführen
Wandelt ein bewährtes Muster aus Claudes automatischem Speicher in das Regelwerk des Projekts um, wo es zu einer durchsetzbaren Anweisung wird und nicht nur eine Hintergrundnotiz bleibt.
Verwendung
/si:promote <Musterbeschreibung> # Bestes Ziel automatisch erkennen
/si:promote <Muster> --target claude.md # In CLAUDE.md überführen
/si:promote <Muster> --target rules/testing.md # In bereichsspezifische Regel überführen
/si:promote <Muster> --target rules/api.md --paths "src/api/**/*.ts" # Bereichsspezifisch mit Pfaden
Arbeitsablauf
Schritt 1: Das Muster verstehen
Analysiere die Beschreibung des Benutzers. Bei Unklarheit eine gezielte Rückfrage stellen:
- "Welches spezifische Verhalten soll Claude befolgen?"
- "Gilt dies für alle Dateien oder nur für bestimmte Pfade?"
Schritt 2: Das Muster im automatischen Speicher finden
# Durchsuche MEMORY.md nach relevanten Einträgen
MEMORY_DIR="$HOME/.claude/projects/$(pwd | sed 's|/|%2F|g; s|%2F|/|; s|^/||')/memory"
grep -ni "<Schlüsselwörter>" "$MEMORY_DIR/MEMORY.md"
Zeige die passenden Einträge an und bestätige, dass sie gemeint sind.
Schritt 3: Das richtige Ziel bestimmen
| Musterumfang | Ziel | Beispiel |
|---|---|---|
| Gilt für das gesamte Projekt | ./CLAUDE.md | „pnpm verwenden, nicht npm“ |
| Gilt für bestimmte Dateitypen | .claude/rules/<thema>.md | „API-Handler benötigen Validierung“ |
| Gilt für alle Ihre Projekte | ~/.claude/CLAUDE.md | „Explizite Fehlerbehandlung bevorzugen“ |
Wenn der Benutzer kein Ziel angegeben hat, empfehle eines basierend auf dem Umfang.
Schritt 4: In eine prägnante Regel destillieren
Wandle die Erkenntnis aus dem Notizformat des automatischen Speichers in das Anweisungsformat von CLAUDE.md um:
Vorher (MEMORY.md — beschreibend):
Das Projekt verwendet pnpm-Workspaces. Als ich npm install versuchte, schlug es fehl. Die Sperrdatei ist pnpm-lock.yaml. Es muss pnpm install für Abhängigkeiten verwendet werden.
Nachher (CLAUDE.md — vorschreibend):
## Build & Abhängigkeiten
- Paketmanager: pnpm (nicht npm). Verwende `pnpm install`.
Regeln für die Destillation:
- Eine Regel pro Zeile, wenn möglich
- Imperativ („Verwende X“, „Immer Y“, „Nie Z“)
- Den Befehl oder das Beispiel angeben, nicht nur das Konzept
- Keine Hintergrundgeschichte — nur die Anweisung
Schritt 5: Ins Ziel schreiben
Für CLAUDE.md:
- Vorhandene CLAUDE.md lesen
- Den passenden Abschnitt finden (oder erstellen)
- Die neue Regel unter der richtigen Überschrift anhängen
- Wenn die Datei 200 Zeilen überschreiten würde, stattdessen
.claude/rules/vorschlagen
Für .claude/rules/:
- Die Datei erstellen, falls sie nicht existiert
- YAML-Frontmatter mit
pathshinzufügen, wenn bereichsspezifisch - Den Regeltext schreiben
---
paths:
- "src/api/**/*.ts"
- "tests/api/**/*"
---
# API-Entwicklungsregeln
- Alle Endpunkte müssen Eingaben mit Zod-Schemas validieren
- Für Fehlerantworten die Klasse `ApiError` verwenden (nicht raw Error)
- OpenAPI-JSDoc-Kommentare an Handler-Funktionen einfügen
Schritt 6: Automatischen Speicher bereinigen
Nach der Überführung den ursprünglichen Eintrag in MEMORY.md entfernen oder markieren:
# Anzeigen, was entfernt wird
grep -n "<Muster>" "$MEMORY_DIR/MEMORY.md"
Den Benutzer um Bestätigung bitten. Dann MEMORY.md bearbeiten, um den überführten Eintrag zu entfernen. Dies schafft Platz für neue Erkenntnisse.
Schritt 7: Bestätigen
✅ Überführt nach {{Ziel}}
Regel: „{{destillierte Regel}}“
Quelle: MEMORY.md Zeile {{n}} (entfernt)
MEMORY.md: {{Zeilen}}/200 Zeilen verbleibend
Das Muster ist jetzt eine durchsetzbare Anweisung. Claude wird es in allen zukünftigen Sitzungen befolgen.
Entscheidungsleitfaden zur Überführung
Überführen, wenn:
- Das Muster 3+ Mal im automatischen Speicher aufgetaucht ist
- Sie Claude mehr als einmal dazu korrigiert haben
- Es sich um eine Projektkonvention handelt, die jeder Mitwirkende kennen sollte
- Es einen wiederkehrenden Fehler verhindert
Nicht überführen, wenn:
- Es sich um eine einmalige Debugging-Notiz handelt (im automatischen Speicher belassen)
- Es sich um sitzungsspezifischen Kontext handelt (Sitzungsspeicher übernimmt dies)
- Es sich bald ändern könnte (z. B. während einer Migration)
- Es bereits durch bestehende Regeln abgedeckt ist
CLAUDE.md vs. .claude/rules/
| CLAUDE.md verwenden für | .claude/rules/ verwenden für |
|---|---|
| Globale Projektregeln | Dateityp-spezifische Muster |
| Build-Befehle | Testkonventionen |
| Architekturentscheidungen | API-Entwurfsregeln |
| Teamkonventionen | Framework-spezifische Fallstricke |
Tipps
- CLAUDE.md unter 200 Zeilen halten — für Überlauf
rules/verwenden - Eine Regel pro Zeile ist einfacher zu warten als Absätze
- Den konkreten Befehl angeben, nicht nur das Konzept
- Überführte Regeln vierteljährlich überprüfen — entfernen, was nicht mehr relevant ist