Session Handover – Strukturierte Übergabe bei KI-gestützter Entwicklung

Session Handover bezeichnet die Praxis, am Ende einer KI-Entwicklungssession ein strukturiertes Übergabedokument zu erstellen, das alle relevanten Informationen für die nächste Session festhält. Es ist die Antwort auf ein fundamentales Problem bei der Arbeit mit KI-Assistenten wie Claude oder GPT-4: das Context-Limit.

Jedes Large Language Model hat ein maximales Kontextfenster – eine Obergrenze, wie viel Text es in einer Session gleichzeitig verarbeiten und "erinnern" kann. Bei langen Entwicklungssessions, in denen viele Dateien gelesen, viele Entscheidungen getroffen und viele Änderungen vorgenommen werden, nähert sich dieser Kontext irgendwann seinem Limit. Ohne strukturierte Übergabe gehen alle diese Informationen beim Neustart verloren.

Das Problem: Context-Limits und Informationsverlust

Was ist ein Context-Limit?

KI-Assistenten arbeiten mit einem sogenannten Kontextfenster – dem gesamten Text, den das Modell in einer Interaktion "sehen" kann:

• Dazu gehören alle bisherigen Nachrichten im Chat, alle gelesenen Dateien, alle Tool-Ergebnisse
• Ist das Limit erreicht, fallen ältere Informationen aus dem Kontext heraus
• Bei Claude Code gibt es Auto-Compact: Der Kontext wird automatisch komprimiert, aber dabei gehen Details verloren
• Ein manueller Neustart (neues Chat-Fenster, /clear) setzt den Kontext komplett zurück

Was geht ohne Handover verloren?

Ohne strukturierte Übergabe muss der Entwickler in der nächsten Session von vorne beginnen:

• Getroffene Entscheidungen: "Warum haben wir Ansatz A statt B gewählt?"
• Offene Aufgaben: Welche TODOs sind noch offen, was wurde halbfertig begonnen?
• Geänderte Dateien: Welche Dateien wurden bearbeitet und warum?
• Bekannte Probleme: Welche Bugs wurden entdeckt, die noch nicht behoben sind?
• Nächste Schritte: Was war der geplante nächste Schritt vor dem Session-Ende?
• Technischer Kontext: Welche Architektur-Details sind für das Verständnis wichtig?

Die Folgen ohne Handover

• Der KI-Assistent muss in der nächsten Session erneut viele Dateien lesen, um den Kontext aufzubauen
• Entscheidungen werden möglicherweise nochmals diskutiert oder anders getroffen
• Halbfertige Implementierungen werden nicht korrekt fortgesetzt
• Der Entwickler selbst verliert Überblick bei langen Projekten
• Zeitverlust durch Orientierungsarbeit am Session-Anfang

Die Lösung: Strukturierte Übergabe-Dokumente

Was ein gutes Session-Handover-Dokument enthält

Ein effektives Handover-Dokument ist kompakt, präzise und auf das Wesentliche fokussiert:

• Abgeschlossene Themen: Was wurde in dieser Session fertiggestellt?
• Offene TODOs: Priorisierte Liste der nächsten Aufgaben
• Geänderte Dateien: Welche Dateien wurden bearbeitet, mit kurzem Kontext warum
• Offene Fragen: Entscheidungen, die noch aussstehen oder geklärt werden müssen
• Nächste Schritte: Konkreter nächster Schritt für einen schnellen Einstieg
• Wichtige Erkenntnisse: Learnings, die nicht verloren gehen dürfen
• Bekannte Probleme: Bugs oder Einschränkungen, die bewusst offengelassen wurden

Beispiel: Aufbau eines Session-Handover-Dokuments

Ein typisches Handover-Dokument hat folgende Struktur:

• Datum und Projekt: Wann, welches Projekt, welches Feature
• Zusammenfassung: 2-3 Sätze was getan wurde
• Abgeschlossen: Aufzählung fertiggestellter Aufgaben
• In Arbeit: Aufgaben die angefangen aber noch nicht fertig sind
• TODO (priorisiert): Nummerierte Liste der nächsten Aufgaben
• Geänderte Dateien: Dateipfade mit einzeiligem Kontext
• Nächster Schritt: Konkret und sofort umsetzbar

Session Handover in der Praxis

Wann einen Handover erstellen?

Es gibt mehrere Auslöser für die Erstellung eines Handover-Dokuments:

• Context-Limit nähert sich: Bei Claude Code bei ca. 80-90% Auslastung
• Ende des Arbeitstages: Vor dem Feierabend, um morgen nahtlos weiterzumachen
• Vor einem /clear: Bewusster Neustart des Kontexts
• Wechsel des Entwicklers: Übergabe an einen Kollegen
• Abschluss einer Feature-Phase: Nach Abschluss eines komplexen Features als Dokumentation

Wo werden Handover-Dokumente gespeichert?

Die Ablage sollte systematisch und leicht auffindbar sein:

• Dedizierter Ordner im Projekt: z.B. dokumentation/TODO-fuer-CLEAR/
• Dateinamen mit Datum: 2026-02-27_feature-linkedin-integration.md
• Im Git-Repository versioniert, aber nicht in die Hauptdokumentation eingebettet
• Alternativ: In Projekt-Management-Tools wie Linear oder Jira als Kommentar

Zusammenhang mit CLAUDE.md und Memory Files

Das Drei-Schichten-Modell des Kontexts

Im professionellen Agentic Coding gibt es drei Ebenen persistenter Informationen:

• CLAUDE.md (dauerhaft, projektübergreifend): Projektregeln, Coding-Konventionen, Architektur-Prinzipien, Sicherheitsregeln. Diese Datei wird bei jeder Session automatisch geladen und ändert sich selten.
• Memory Files (dauerhaft, projektspezifisch): Architektur-Entscheidungen, bekannte Probleme, technische Schulden, API-Contracts. Werden manuell oder durch den Agent aktualisiert wenn wichtige Entscheidungen getroffen werden.
• Session Handover (temporär, aufgabenspezifisch): Aktueller Fortschritt, offene TODOs, nächste Schritte. Wird am Session-Ende erstellt und am nächsten Session-Anfang gelesen.

Was gehört wohin?

• CLAUDE.md: "Niemals console.log verwenden, immer Logger", "Vue 3 Composition API ist Pflicht"
• Memory File: "Wir nutzen JWT mit 24h Gültigkeit, weil OAuth zu komplex für den MVP war"
• Session Handover: "Auth-Endpunkt ist fertig, Refresh-Token-Logik ist noch offen – nächster Schritt"

Zusammenspiel in der Praxis

Der typische Ablauf beim Session-Start mit vorhandenem Handover:

• KI-Assistent lädt automatisch CLAUDE.md (Projektregeln)
• Entwickler teilt das Handover-Dokument: "Lies das für den aktuellen Stand"
• KI hat sofort vollständigen Kontext über offene Aufgaben und Entscheidungen
• Keine Orientierungsphase, keine wiederholten Fragen, nahtloser Einstieg

Session Handover bei Claude Code

Auto-Compact

Claude Code verfügt über Auto-Compact: Wenn der Kontext sein Limit erreicht, wird er automatisch komprimiert. Das bedeutet:

• Die Session läuft weiter, ohne manuellen Eingriff
• Ältere, weniger relevante Informationen werden zusammengefasst
• Wichtige aktuelle Informationen bleiben erhalten
• Aber: Details aus frühen Teilen der Session können verloren gehen

Auto-Compact reduziert den Bedarf für häufige Handovers, ersetzt ihn aber nicht vollständig – besonders bei bewusstem /clear oder Tageswechsel.

Skills für Handover-Management

Claude Code unterstützt Skills für strukturierte Handovers:

• /.session-handover-new – Erstellt ein neues Handover-Dokument
• /.session-handover-update – Aktualisiert ein bestehendes Handover
• Die KI erstellt das Dokument selbst, basierend auf dem bisherigen Session-Verlauf

Best Practices für effektive Session Handovers

Vor dem Erstellen des Handovers

• Alle laufenden Änderungen abschließen oder bewusst als "in Arbeit" markieren
• Letzten Build-Check durchführen: npm run build
• Git-Status prüfen: Gibt es uncommittete Änderungen?
• Offene Fragen sammeln, die in der nächsten Session geklärt werden müssen

Beim Schreiben des Handovers

• Konkret statt allgemein: "Datei X, Zeile Y hat noch einen TypeScript-Fehler" statt "gibt noch Probleme"
• Priorisiert: Aufgaben nach Wichtigkeit ordnen, nicht nach Reihenfolge der Entstehung
• Vollständig bei Dateien: Absolute Pfade angeben, nicht nur Dateinamen
• Entscheidungen begründen: "Wir haben X gewählt, weil Y" spart in der nächsten Session Zeit
• Kurz halten: Ein Handover ist kein Roman – Stichpunkte reichen

Zu Session-Beginn

• Handover-Dokument dem KI-Assistenten vorlegen bevor Aufgaben vergeben werden
• Kurze Orientierung: "Fang mit TODO Nummer 1 an"
• Bei Unklarheiten im Handover: Kurz klären bevor die Arbeit beginnt

Häufige Fehler beim Session Handover

Zu vage formulieren

Schlechtes Beispiel: "Auth noch nicht fertig"
Gutes Beispiel: "JWT-Refresh-Token-Endpoint /api/auth/refresh fehlt noch. Logik ist in server/services/authService.js vorbereitet, aber Route in server/index.js noch nicht registriert."

Zu selten erstellen

Wer nur beim kompletten Kontext-Limit einen Handover erstellt, verliert bei jedem Auto-Compact potenziell Informationen. Besser: Am Ende jedes Arbeitstages, auch wenn der Kontext noch nicht voll ist.

Handover nicht im Git versionieren

Handover-Dokumente gehören ins Repository. Sie sind wertvolle Dokumentation des Entwicklungsprozesses und helfen auch Kollegen beim Einstieg in eine laufende Aufgabe.

Entscheidungen nicht dokumentieren

Die häufigste Lücke: Was getan wurde steht im Handover, aber nicht warum. Entscheidungen ohne Begründung führen dazu, dass sie in der nächsten Session nochmals diskutiert werden.

Session Handover als Team-Werkzeug

Session Handovers sind nicht nur für Solo-Entwickler nützlich:

• Übergabe zwischen Entwicklern: Wenn ein Kollege eine Aufgabe übernimmt, hat er sofort vollen Kontext
• Asynchrone Zusammenarbeit: In verteilten Teams überbrücken Handovers Zeitzonendifferenzen
• Onboarding: Neue Teammitglieder können sich durch Handover-History in den Projektstand einlesen
• Review-Vorbereitung: Handovers erleichtern Code-Reviews, da der Reviewer den Kontext versteht

Session Handover im Agentic Coding Workshop

Im Agentic Coding Workshop bei elasticbrains ist Session Handover ein zentrales Thema:

• Wie man Handovers so formuliert, dass der KI-Assistent sofort produktiv ist
• Das Drei-Schichten-Modell: CLAUDE.md, Memory Files und Session Handover im Zusammenspiel
• Context-Management-Strategien für lange Entwicklungsprojekte
• Praktische Übung: Handover für ein echtes Feature aus dem Workshop erstellen

Mehr zum übergeordneten Thema finden Sie im Glossar unter Context Engineering.

Weiterführende Ressourcen

• Glossar: Context Engineering, Agentic Coding, CLAUDE.md
• Workshop: Agentic Coding Workshop
• Service: KI-Entwicklung bei elasticbrains