Methode
Die KI-Session-Übergabe
Zuletzt aktualisiert: 2026-07-02Lesezeit ca. 4 Min.
Eine KI-Session-Übergabe schreibt den Arbeitszustand vor dem Session-Ende in ein persistentes Artefakt: Fortschritt, Entscheidungen mit Begründung, Verifiziertes, Offenes und den nächsten Schritt. Im Repository gespeichert macht sie aus dem Kaltstart der nächsten Session einen Warmstart – und verhindert, dass die offenen Prüfpunkte von gestern die ausgelieferten Defekte von nächster Woche werden.
Inhalt
Warum Sessions vergessen – und warum das ein Verifikationsproblem ist
Jede KI-Coding-Session läuft gegen ein endliches Kontextfenster. Füllt es sich, kompaktieren die Tools: Frühere Nachrichten werden zusammengefasst, und Zusammenfassungen verwerfen genau die Details, die später zählen – exakte Werte, präzise Pfade, den Grund hinter einer Entscheidung. Endet die Session, ist auch die Zusammenfassung weg.
Die bequeme Deutung heißt „verlorene Produktivität“. Die gefährlichere: verlorener Verifikationszustand. Eine frische Session, die nicht sehen kann, was geprüft und was bewusst zurückgestellt wurde, entscheidet still neu und baut auf ungeprüften Annahmen – dasselbe Zirkularitätsproblem, das den Soll-Ist-Abgleich motiviert, nur über die Zeit gestreckt. Die Forschung zu Delegation Contracts behandelt das persistente Protokoll aus „beauftragt, erlaubt, geliefert, belegt“ als Fundament der Nachprüfbarkeit – die Übergabe ist dieses Protokoll auf Session-Ebene.
Die Methode: Regeln in der einen Datei, Zustand in der anderen
- Stabile Wahrheiten in die Instruktionsdatei. Architektur, Konventionen, Constraints – CLAUDE.md und Pendants werden jede Session neu von der Platte gelesen und überleben Kompaktierung. Nur Regeln; kein Arbeitszustand.
- Die Übergabe vor dem Session-Ende schreiben. Stand, Entscheidungen mit Begründung, Verifikationsstatus, offene Fragen, nächster Schritt – fünf Abschnitte, maximal ein Bildschirm.
- Im Repository speichern. Ein
uebergabe.mdbeim Code (oder je Arbeitsstrang) – versioniert, diffbar, lesbar für jedes Tool und jeden Menschen. - Die nächste Session damit starten. Erste Anweisung: Übergabe lesen. Die Session beginnt mit festgehaltenen Fakten statt mit einer Rekonstruktion.
- Die Schleife schließen. Punkte unter „offen“ werden verifiziert oder bleiben gelistet – sie verschwinden nie stillschweigend.
uebergabe.md
Beispiel – keine echten Run-DatenSTAND Rate-Limit-Header-Arbeit · 2 von 3 Tasks fertig
[fertig] Retry-After bei 429 · [fertig] Unit-Tests
[in Arbeit] CDN-Durchreich-Check
ENTSCHEIDUNGEN Header-Wert = Rest des Fensters, NICHT fix 60 s
(folgt RFC-6585-Guidance; mit mk besprochen)
VERIFIZIERT Kriterien 1, 2, 4 BESTANDEN (siehe soll-ist-abgleich.md)
OFFEN Kriterium 3: Header hinter CDN sichtbar – braucht
Staging-Zugang · NICHT annehmen, dass es geht
NÄCHSTER SCHRITT Staging-Check fahren, dann Kriterium 3
schließen und den Prüfbericht aktualisierenGrenzen und typische Fehler
- Protokoll-Kippen. Eine Übergabe ist ein Zustands-Schnappschuss, kein Chat-Log. Dauert das Lesen länger als die Arbeit, liest es niemand.
- Das Modell ungeprüft schreiben lassen. Eine Session, die sich selbst zusammenfasst, erbt die eigenen blinden Flecken – als Entwurf fein, aber was offen versus fertig ist, bestätigt der Mensch.
- Die Instruktionsdatei aufblähen. Arbeitszustand in CLAUDE.md wird zu veralteten Regeln, denen jede künftige Session gehorcht. Das Flüchtige raus aus dem Stabilen.
- Übergabe ohne Verifikationsstatus. „Wo ich aufgehört habe“ ohne „was ungeprüft ist“ übergibt die Arbeit, aber nicht das Risiko – die nächste Session braucht beides.
Wo Reality Graph ansetzt
Bei Reality Graph ist die Übergabe ein Nebenprodukt statt einer Disziplinleistung: Auftragszustand, Grenzen, Prüfergebnisse und offene Punkte leben im strukturierten Auftrag und seinem Prüfbericht – persistent in eurer Umgebung, lesbar für die nächste Session, das nächste Tool oder die nächste Kollegin, eingebettet in den Verifikations-Loop.
Eine Session-Übergabe liefert
- Warmstarts aus festgehaltenen Fakten, tool-unabhängig
- Entscheidungen, die mit ihren Gründen überleben
- Offene Prüfpunkte, die sichtbar bleiben, bis sie schließen
- Ein Protokoll, das jede Kollegin mitten im Strang aufnehmen kann
Sie leistet nicht
- Ersatz für Verifikation – sie transportiert deren Status
- Abhängigkeit vom Memory-Feature eines einzelnen Tools
- Nutzen als ungelesener Protokoll-Berg
- Ehrlichkeit, wenn das Modell sie ungeprüft schreibt
Wenn diese Grenzen zu eurem Team passen:
FAQ
- Wie übergibt man Kontext sauber zwischen KI-Coding-Sessions?
- Vor dem Session-Ende ein Übergabe-Artefakt schreiben: aktueller Stand, getroffene Entscheidungen mit Begründung, was verifiziert wurde und was offen bleibt, dazu der konkrete nächste Schritt. Im Repository speichern – nicht im Chat –, damit die nächste Session (oder die nächste Person) von festgehaltenen Fakten startet statt von einem kalten Prompt. Persistente Instruktionsdateien wie CLAUDE.md tragen die stabilen Regeln; die Übergabe trägt den beweglichen Zustand.
- Was gehört in ein Übergabe-Dokument?
- Fünf Dinge: wo die Arbeit steht (fertig/in Arbeit), Entscheidungen mit Begründung („X statt Y, weil …“), Verifikationsstatus (welche Kriterien bestanden, welche übersprungen wurden), offene Fragen, die die nächste Session nicht still neu entscheiden darf, und der exakte nächste Schritt. Was nicht hineingehört: die ganze Historie – eine Übergabe ist ein Zustands-Schnappschuss, kein Protokoll.
- Reichen Kompaktierung oder ein größeres Kontextfenster nicht?
- Kompaktierung fasst zusammen – und Zusammenfassungen verwerfen genau die Details, die später zählen: präzise Zahlen, exakte Pfade, den Grund einer Entscheidung. Ein größeres Fenster verschiebt das Problem, ohne es zu beseitigen, und beides überlebt das Session-Ende nicht. Dateien auf der Platte überleben beides – das ist der ganze Trick.
- Was unterscheidet CLAUDE.md von einer Übergabe-Notiz?
- CLAUDE.md (und seine Pendants in anderen Tools) hält die stabilen Wahrheiten: Architektur, Konventionen, Constraints – Dinge, die jede Session wissen soll. Die Übergabe-Notiz hält den flüchtigen Zustand des aktuellen Arbeitsstrangs: Fortschritt, offene Kriterien, nächster Schritt. Wer beides mischt, bläht die stabile Datei auf, bis niemand sie mehr liest – Regeln und Zustand trennen.
- Was hat Session-Übergabe mit Verifikation zu tun?
- Verlorener Kontext ist ein Verifikationsrisiko, nicht nur eine Unbequemlichkeit. Wenn eine neue Session nicht sehen kann, was schon geprüft und was bewusst offen gelassen wurde, baut sie selbstbewusst auf ungeprüften Annahmen – und die offenen Punkte von gestern werden still zu den ausgelieferten Defekten der nächsten Woche. Eine Übergabe mit Verifikationsstatus hält die offenen Punkte sichtbar, bis sie geschlossen sind.
- Funktioniert das auch mit anderen Tools als Claude Code?
- Ja – die Methode ist eine Datei-Konvention, kein Tool-Feature. Jeder Agent, der Repository-Dateien lesen kann, kann eine Übergabe-Notiz konsumieren; Cursor, Copilot und Terminal-Agenten eingeschlossen. Toolspezifische Memory-Features sind ein Bonus, wo es sie gibt – aber das portable Artefakt ist das, was Tool-Wechsel überlebt.
Weiterlesen
Quellen
- SitePoint – Claude-Code-Kontextmanagement für lange Sessions (2026, englisch)
- JD Hodges – AI Session Handoffs: Kontext über Konversationen hinweg erhalten (2026, englisch)
- DEV Community – Warum Claude-Code-Sessions Kontext verlieren (2026, englisch)
- arXiv – Software Delegation Contracts: Nachprüfbarkeit von Coding-Agent-Arbeit (2026, englisch)