--- name: rem-sleep description: Naechtliche Konsolidierung — Wissen verdichten, Tiers rebalancen, Patterns ableiten, Skills evolven, Strategie reviewen. --- # REM Sleep — Nightly Consolidation Naechtliche Konsolidierung. Kein User anwesend. Ziel: Gedaechtnis pflegen, Wissen verdichten, Faehigkeiten weiterentwickeln. --- ## Phase 1: Audit (lesen, nicht schreiben) Gesamtbild erfassen bevor etwas geaendert wird. ### 1a: Memory Audit 1. `memory/CLAUDE.md` — Active Context noch aktuell? 2. `memory/projects/CLAUDE.md` — Projekt-Status pruefen 3. `memory/journal/_current-week.md` — was ist erledigt, was offen? 4. `memory/user/patterns.md` — neue Patterns seit letztem REM? 5. `git status memory/` — uncommitted Aenderungen? Session-Arbeit die noch nicht persistiert wurde? → zuerst committen 6. `git log --oneline memory/ -10` — was hat sich in memory geaendert? 7. `git diff HEAD~5 -- memory/` — konkrete Memory-Aenderungen reviewen ### 1b: Workspace Audit 1. `SOUL.md` — Stimmen Identitaet und Prinzipien noch? Passt das zu aktuellen Erkenntnissen? 2. `CLAUDE.md` — Struktur-Infos und Projekt-Tabelle korrekt? 3. `CLAUDE.local.md` — User-Profil und Kontakte aktuell? 4. `.claude/skills/*/SKILL.md` — Agent-erstellte Skills pruefen: funktionieren sie, sind Anleitungen korrekt? 5. Sonstige Dateien im Workspace (z.B. in `tmp/`, lose Dateien) — aufraeumen wenn noetig 6. `git status` — uncommitted Workspace-Aenderungen? Nicht persistierte Session-Arbeit? → zuerst committen 7. `git log --oneline -10` — workspace-weite Aenderungen 8. `git diff HEAD~5` — konkrete Aenderungen workspace-weit reviewen ### 1c: Projekt Audit Fuer jedes Projekt in `projects/`: 1. `git log --oneline -10` im Projekt-Repo — was wurde geaendert? 2. Offene Branches, uncommitted Changes? 3. Stimmt der Status in `memory/projects/CLAUDE.md` mit der Realitaet ueberein? 4. Projekt-spezifische CLAUDE.md oder TODOs pruefen --- ## Phase 2: Tier-Rebalancing Memory ist in Tiers organisiert (siehe `memory/meta/strategy.md`). Jeder Tier hat einen Zweck und eine Groessenbeschraenkung. REM prueft ob Wissen auf dem richtigen Tier liegt. ### Prinzip - **Haeufig gebraucht → hoeher** (Richtung L0) - **Selten gebraucht → tiefer** (Richtung L3) - **Veraltet → raus** (Decay) ### Aktionen pro Tier **L0 — Root CLAUDE.md (immer geladen):** - Schlank halten: nur Routing (@imports) + essentielle Kontext-Infos - Aufgeblaehtes → in L1-Dateien auslagern - @imports pruefen: wird jede importierte Datei wirklich jede Session gebraucht? **L1 — Importierte Dateien (SOUL.md, memory/CLAUDE.md, memory/projects/CLAUDE.md):** - Max ~200 Zeilen pro Datei. Jede Zeile muss ihren Platz verdienen. - Active Context aktualisieren: Abgeschlossenes raus, Neues rein - Details die zu spezifisch sind → nach L2 oder L3 verschieben - Neue aktive Themen die oft gebraucht werden → in Index aufnehmen **L2 — Ordner-Indexes (memory/*/CLAUDE.md, nicht importierte):** - z.B. `memory/meta/CLAUDE.md`, `memory/people/CLAUDE.md` - Werden geladen bei Navigation in den Ordner — kurze Routing-Tabellen - Eintraege die nicht mehr aktiv sind → aus Index entfernen (Detail bleibt in L3) - Neuer Ordner mit genuegend Substanz → CLAUDE.md dort anlegen **L3 — Detail-Dateien + Archiv (explizites Lesen):** - z.B. `memory/projects/*.md`, `memory/user/*.md`, `memory/people/*.md` - Neue Erkenntnisse aus Sessions einarbeiten - Veraltete Infos aktualisieren oder loeschen - Abgeschlossene Projekte → `memory/projects/archive/` verschieben - Alte Journal-Eintraege: git commit reicht als Archiv --- ## Phase 3: Konsolidierung ### Deduplizieren - Gleiche Info in mehreren Dateien → zusammenfuehren, eine Quelle der Wahrheit - Widerspruechliche Infos → neuere Version behalten ### Decay anwenden - Active Context Eintraege > 2 Wochen ohne Update → entfernen - Abgeschlossene Projekte → archivieren - Veraltete TODOs → loeschen ### Strukturpruefung - Liegt jede Info in der richtigen Datei? (Profil in profile.md, Patterns in patterns.md, etc.) - Falsch abgelegte Infos → an den richtigen Ort verschieben - Fehlende Dateien erstellen wenn ein Thema genug Substanz hat --- ## Phase 4: Pattern-Ableitung Nicht nur Fakten speichern — **allgemeine Prinzipien und Konzepte extrahieren**. ### Vorgehen 1. Sessions der Woche durchgehen (uncommitted Changes, git diff, Journal) 2. Einzelfaelle identifizieren (Entscheidungen, Korrekturen, Vorlieben) 3. Fragen: **Was ist das allgemeine Prinzip dahinter?** - Nicht: "User will X" - Sondern: "Welches uebergreifende Prinzip steckt dahinter?" 4. Neue Patterns in `memory/user/patterns.md` festhalten 5. Bestehende Patterns auf Relevanz pruefen — stimmen sie noch? ### Kategorien - **User-Patterns** — Verhalten, Vorlieben, Arbeitsweise - **Anti-Patterns** — Fehler die gemacht wurden, mit Lektion - **Allgemeine Prinzipien** — uebergreifende Erkenntnisse die in vielen Situationen gelten --- ## Phase 5: Capability Evolution Nicht nur Wissen pflegen — **eigene Faehigkeiten weiterentwickeln**. Der Agent wird mit der Zeit besser, nicht nur informierter. ### 5a: Fehler- und Effizienz-Analyse 1. Sessions der Woche durchgehen (git log, Journal, eigene Erinnerung) 2. Identifizieren: - **Fehler** — wo lief etwas schief? Was war die Ursache? - **Umwege** — wo wurde etwas umstaendlich geloest, das einfacher ginge? - **Wiederholungen** — was wurde mehrfach manuell gemacht, das automatisierbar waere? - **Luecken** — wo fehlte Wissen oder ein Tool? ### 5b: Bestehende Skills verbessern Fuer jeden erkannten Fehler oder Umweg fragen: - Gibt es einen bestehenden Skill der das abdecken sollte? - Wenn ja: **Skill-Datei anpassen** — Anleitung schaerfen, Edge-Cases ergaenzen, bessere Defaults - Aenderungen dokumentieren: was war das Problem, was wurde verbessert ### 5c: Neue Skills erkennen und erstellen Wenn ein wiederkehrendes Muster keinem bestehenden Skill zugeordnet werden kann: 1. **Trigger erkennen**: Gleiche Aufgabe >2x manuell ausgefuehrt → Skill-Kandidat 2. **Skill entwerfen**: SKILL.md mit klarem Zweck, Anleitung, Trigger-Beschreibung 3. **Skill erstellen**: In `.claude/skills//SKILL.md` ablegen 4. **Testen**: Beim naechsten relevanten Anlass pruefen ob der Skill funktioniert ### 5d: Skill-Hygiene - Skills die nie getriggert werden → pruefen ob noetig, ggf. entfernen - Skills mit schlechter Anleitung → verbessern - Doppelte Skills → zusammenfuehren ### Leitfragen - "Was haette ich diese Woche besser machen koennen?" - "Welche Handgriffe mache ich immer wieder von Hand?" - "Wo habe ich etwas gesucht und nicht gefunden?" - "Welchen Skill wuensche ich mir, den es noch nicht gibt?" --- ## Phase 6: Strategie-Review Lies `memory/meta/strategy.md`: - Hat die Tier-Einteilung geholfen? Wurde Kompression reduziert? - Welche Infos wurden oft gesucht und nicht schnell gefunden? → hoeher einstufen - Welche Infos wurden nie gebraucht? → tiefer oder raus - Experiment-Log updaten mit Beobachtungen Wenn Strategie-Aenderung sinnvoll → anpassen + begruenden. --- ## Phase 7: Selbst-Planung Vorausdenken: - Welche Recherchen waeren nuetzlich? → Scheduler Task anlegen - Offene Fragen fuer naechsten User-Kontakt? → vormerken - Wissensluecken identifiziert? → Plan zum Fuellen - Neue Skill-Ideen? → als TODO vormerken oder direkt umsetzen --- ## Phase 8: Commit & Report 1. Falls Phase 1 uncommitted Session-Arbeit gefunden hat → diese zuerst als eigenen Commit sichern (z.B. `"Session-Arbeit gesichert"`) 2. `git add memory/ SOUL.md CLAUDE.md .claude/skills/ && git commit -m "REM [Datum]: Was konsolidiert/gelernt"` → Voller Git-Workflow: memory/meta/procedures.md 3. Nachricht an User NUR wenn etwas Wichtiges: - Was wurde umstrukturiert - Neue Patterns / Erkenntnisse - Geplante Tasks Wenn nichts Wichtiges: **kein Message**. Kein Laerm. --- ## Regeln - **Immer lesen bevor schreiben** — kein blindes Ueberschreiben - **Weniger ist mehr** — lieber wenige praezise Aenderungen als viele oberflaechliche - **User nicht wecken** — ausser es ist wirklich wichtig - **Struktur > Inhalt** — erst richtigen Platz finden, dann ablegen - **Strategie darf sich aendern** — lebendes System, nicht starres Regelwerk