Das Problem: Context-Vergessen nach Session-Resets
Du kennst es vielleicht: Ein KI-Agent arbeitet sich tief in ein Thema ein, dann kommt ein Session-Reset und plötzlich ist der rote Faden weg. Entscheidungen, offene Fragen und der aktuelle Arbeitsstand sind nicht mehr präsent.
Genau das war bei uns im Alltag spürbar. Ohne stabilen Kontext mussten wir regelmäßig Schritte wiederholen, statt sauber weiterzubauen.
Die Lösung: Rolling Window Context Manager
Unser Ansatz speichert den Projektkontext kontinuierlich und stellt ihn beim nächsten Start gezielt wieder her. Statt „alles oder nichts“ wird nur das mitgenommen, was für die Fortsetzung wirklich wichtig ist.
Die Architektur basiert auf drei Säulen:
1. JSON State Files ({project}.state.json)
Der aktuelle Maschinenzustand wird strukturiert gespeichert. So kann ein Agent beim Neustart schnell und deterministisch rehydrieren.
2. Lesbare Logs ({project}.log.md)
Parallel schreiben wir ein menschenlesbares Protokoll. Das hilft bei Reviews, Übergaben und Fehleranalysen.
3. Rolling Window der kritischen Punkte
Das Rolling Window hält gezielt nur den „operativen Kern“ im Fokus:
- Aktueller Task: Was läuft gerade?
- Offene Fragen: Was muss entschieden werden?
- Letzte Checkpoints: Wo sind wir stehengeblieben?
- Nächste Schritte: Was kommt als Nächstes?
Redis vs. Qdrant vs. Files
- Redis: Kurzzeit-State (sehr schnell, TTL-basiert)
- Qdrant: Langzeitgedächtnis (semantische Suche, ohne klassische TTL)
- Files: Nachvollziehbarkeit für Menschen (Markdown, Git-versionierbar)
Der entscheidende Unterschied
Das Rolling Window ist keine einzelne Datenbank, sondern eine Context-Management-Schicht. Sie verbindet Speichern, Verdichten und Wiederherstellen über den gesamten Session-Lebenszyklus hinweg.
- lädt vor dem Start den letzten validen Zustand,
- sichert während der Session inkrementell,
- schreibt am Ende einen konsistenten Abschluss-Checkpoint,
- stellt bei Problemen gezielt den letzten stabilen Punkt wieder her.
Fazit
Mit dem Rolling Window verschwindet das „Alles weg nach Reset“-Gefühl. KI-Agenten arbeiten robuster weiter, Entscheidungen bleiben nachvollziehbar, und Teams verlieren weniger Zeit durch Kontextverlust.
Unser Mantra: Context ist nur dann wertvoll, wenn er zuverlässig erhalten bleibt.