CommunityCodierung & Entwicklunggithub.com

Speicher-Synchronisation

Halte das Gedächtnis warm und klein. Hydriere beim Start, destilliere am Ende.

Was ist Speicher-Synchronisation?

Diese Fähigkeit verhindert, dass KI-Agenten-Sitzungen mit kaltem Gedächtnis beginnen. Sie organisiert das Gedächtnis in einer klaren Verzeichnisstruktur mit kuratierten Dateien (MEMORY.md, SOUL.md, USER.md), Sitzungsnotizen und Entscheidungsprotokollen (ADRs) sowie einem abgestuften System aus heißen, warmen und kalten Speichertiern. Beim Start werden nur die wesentlichen Dateien geladen, um die Token-Nutzung zu minimieren und die Antwortzeit unter 15 Sekunden zu halten. Am Ende einer Sitzung destilliert sie das Sitzungsprotokoll in MEMORY.md, entfernt veraltete Informationen und erstellt bei Bedarf Architektur-Entscheidungsprotokolle (ADRs). Die Fähigkeit wird über CLI-Befehle wie `harness memory sync` gesteuert und unterstützt Plattformen wie Claude Code, Cursor und Codex. Sie ist ideal für Entwickler, die langfristige Projekte mit vielen Sitzungen verwalten und sicherstellen möchten, dass der Agent seinen Kontext und seine Historie effizient nutzt, ohne an Token-Limits zu stoßen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/TheElephantCoder/agent-harness/tree/main/skills/memory-sync

Installed? Explore more Codierung & Entwicklung skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht Speicher-Synchronisation?

Verhindert, dass Sitzungen kalt starten.

Aufbau

speicher/
  MEMORY.md        # kuratiert, immer geladen, unter 8k Tokens halten
  SOUL.md          # wer der Agent ist
  USER.md          # wer du bist
  sitzungen/       # rohe Notizen pro Sitzung, nach ~30 Tagen bereinigt
  entscheidungen/  # kurze ADRs (Architektur-Entscheidungsprotokolle)
  stufen/
    heiss.md       # immer geladen
    warm.md        # bei Schlüsselwort geladen
    kalt/          # nur explizit lesen

Lebenszyklus

Start: Lese MEMORY.md und stufen/heiss.md. Optional stufen/warm.md, falls die Aufgabe dazu passt. Lese nicht sitzungen/, es sei denn, du gräbst in der Historie. Sollte insgesamt unter 15 Sekunden dauern.

Ende: Führe harness memory sync aus oder lasse den Exit-Hook die Aufgabe übernehmen. Dabei wird das Sitzungsprotokoll in MEMORY.md destilliert, alte Einträge werden beschnitten und ein ADR wird hinzugefügt, falls eine echte Entscheidung getroffen wurde.

Tipps

  • MEMORY.md ist kuratiert, nicht nur zum Anhängen gedacht. Halte es unter 8k Tokens und bearbeite es chirurgisch.
  • Wenn du 2 oder mehr Ansätze in Betracht gezogen und einen ausgewählt hast, schreibe ein kurzes entscheidungen/ADR-###.md.
  • Keine Geheimnisse im Gedächtnis – es wird ohnehin redigiert.

Befehle:

harness memory show
harness memory edit
harness memory prune --dry-run
harness memory sync --auto

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Verwandte Skills