/si:promote — Gelerntes in Regeln überführen
Überführt ein bewährtes Muster aus Claudes automatischem Gedächtnis in das Regelsystem des Projekts, wo es zu einer durchgesetzten Anweisung wird – nicht nur zu einer Hintergrundnotiz.
Verwendung
/si:promote <Musterbeschreibung> # Ziel automatisch erkennen
/si:promote <Muster> --target claude.md # Nach CLAUDE.md befördern
/si:promote <Muster> --target rules/testing.md # Nach bereichsbezogener Regel befördern
/si:promote <Muster> --target rules/api.md --paths "src/api/**/*.ts" # Bereichsbezogen mit Pfaden
Arbeitsablauf
Schritt 1: Das Muster verstehen
Analysiere die Beschreibung des Benutzers. Falls vage, stelle eine klärende Frage:
- „Welches spezifische Verhalten soll Claude befolgen?“
- „Gilt dies für alle Dateien oder nur für bestimmte Pfade?“
Schritt 2: Das Muster im automatischen Gedächtnis finden
# Durchsuche MEMORY.md nach passenden 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 das gemeinte Muster sind.
Schritt 3: Das richtige Ziel bestimmen
| Musterreichweite | 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“ |
Falls der Benutzer kein Ziel angegeben hat, empfehle eines basierend auf der Reichweite.
Schritt 4: In eine prägnante Regel destillieren
Wandle das Gelernte aus dem Notizformat des automatischen Gedächtnisses 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 Lock-Datei ist pnpm-lock.yaml. Für Abhängigkeiten muss pnpm install verwendet werden.
Nachher (CLAUDE.md – vorschreibend):
## Build & Abhängigkeiten
- Paketmanager: pnpm (nicht npm). Verwende `pnpm install`.
Regeln für die Destillation:
- Wenn möglich eine Regel pro Zeile
- Imperativ formulieren („Verwende X“, „Immer Y“, „Nie Z“)
- Den Befehl oder das Beispiel angeben, nicht nur das Konzept
- Keine Vorgeschichte – nur die Anweisung
Schritt 5: In das Ziel schreiben
Für CLAUDE.md:
- Vorhandene CLAUDE.md lesen
- Den passenden Abschnitt finden (oder einen erstellen)
- Die neue Regel unter der richtigen Überschrift anhängen
- Falls 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, falls bereichsbezogen - Den Regelinhalt schreiben
---
paths:
- "src/api/**/*.ts"
- "tests/api/**/*"
---
# API-Entwicklungsregeln
- Alle Endpunkte müssen Eingaben mit Zod-Schemas validieren
- Verwende die `ApiError`-Klasse für Fehlerantworten (nicht raw Error)
- Füge OpenAPI-JSDoc-Kommentare zu Handler-Funktionen hinzu
Schritt 6: Automatisches Gedächtnis bereinigen
Nach der Beförderung den ursprünglichen Eintrag in MEMORY.md entfernen oder markieren:
# Zeige, was entfernt wird
grep -n "<Muster>" "$MEMORY_DIR/MEMORY.md"
Bitte den Benutzer um Bestätigung der Entfernung. Bearbeite dann MEMORY.md, um den beförderten Eintrag zu löschen. Dadurch wird Platz für neue Lernerfahrungen geschaffen.
Schritt 7: Bestätigung
✅ Nach {{Ziel}} befördert
Regel: „{{destillierte Regel}}“
Quelle: MEMORY.md Zeile {{n}} (entfernt)
MEMORY.md: {{Zeilen}}/200 Zeilen verbleibend
Das Muster ist jetzt eine durchgesetzte Anweisung. Claude wird es in allen zukünftigen Sitzungen befolgen.
Entscheidungshilfe zur Beförderung
Befördern, wenn:
- Das Muster 3-mal oder öfter im automatischen Gedächtnis aufgetaucht ist
- Du Claude mehr als einmal dazu korrigiert hast
- Es sich um eine Projektkonvention handelt, die jeder Mitwirkende kennen sollte
- Es einen wiederkehrenden Fehler verhindert
Nicht befördern, wenn:
- Es sich um eine einmalige Debugging-Notiz handelt (im automatischen Gedächtnis belassen)
- Es sich um sitzungsspezifischen Kontext handelt (Sitzungsspeicher kümmert sich darum)
- 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-Designregeln |
| Teamkonventionen | Frameworkspezifische Fallstricke |
Tipps
- CLAUDE.md unter 200 Zeilen halten – bei Überlauf
rules/verwenden - Eine Regel pro Zeile ist einfacher zu warten als Absätze
- Den konkreten Befehl angeben, nicht nur das Konzept
- Beförderte Regeln vierteljährlich überprüfen – entfernen, was nicht mehr relevant ist