Verliere deine Arbeit nicht durch /clear — Lerne session-handoff kennen

Wenn du jemals eine lange Debugging-Sitzung beendet, /clear ausgeführt und dich dann eine Woche später gefragt hast, welche der drei Datenbankoptionen das Team verworfen hatte — dann ist das hier für dich.

Das Problem ist klein, aber teuer. Die Arbeit mit einem KI-Agenten an einem realen Projekt erzeugt eine Wissensschicht, die sonst nirgendwo existiert. Warum eine bestimmte Bibliothek abgelehnt wurde. Welche Staging-Umgebung kaputt ist. Was der Benutzer mit „dem Gate“ eigentlich gemeint hat. Es steht nicht im Code. Es steht nicht in git. Es steht im Gespräch. Und das Gespräch wird gleich gelöscht.

Der Rettungstest

session-handoff ist eine kleine Agent Skill, die vor dem Löschen ausgeführt wird. Sie durchsucht die Sitzung nach Fakten und stellt eine entscheidende Frage:

"Würde ein erneutes Lesen des Repos dies wiederherstellen?"

Wenn ja, lass es weg — der Code ist die Quelle der Wahrheit. Wenn nein, könnte es sich lohnen, es zu speichern. Diese eine Heuristik eliminiert ungefähr 80% der falschen Speicherungen und verhindert, dass die Datei mit dem Langzeitgedächtnis zu Lärm wird.

Wie es in der Praxis funktioniert

Der Ablauf hat sieben Schritte, aber die Erfahrung sind zwei: Einen Auslöser wie "checkpoint before clearing," eingeben, prüfen, was gespeichert würde, genehmigen. Die Skill schreibt dann strukturierte Markdown-Einträge — user für Rolle und Umgebung, feedback für Arbeitsregeln, project für Ziele und Entscheidungen, reference für Verweise auf externe Systeme — und aktualisiert eine Indexdatei mit einer Zeile, damit zukünftige Sitzungen sie effizient laden können.

Zwei technische Details, die das tatsächlich nutzbar machen:

• Datumsnormalisierung. "Thursday" wird bei der Extraktion in 2026-05-21 umgewandelt, sodass der Eintrag auch in drei Monaten noch Sinn ergibt.
• Why / How-Struktur. Jeder Feedback- oder Project-Eintrag enthält den Grund (oft ein früherer Vorfall) und wann die Regel gilt. Das ermöglicht deinem zukünftigen Ich, Grenzfälle zu beurteilen, statt der Notiz blind zu folgen.

Wer das braucht

Wenn deine Arbeit lang laufende Migrationen, Rollouts mit mehreren Beteiligten oder alles umfasst, bei dem mündliche Absprachen das Gespräch überdauern, das sie hervorgebracht hat — dann ist das genau das Richtige. Platform Leads, SREs, Contract Engineers, die Arbeit übergeben. Nicht, weil es clever ist. Sondern weil die Alternative darin besteht, das, was du schon wusstest, schlecht und drei Wochen zu spät neu zusammenzusetzen.

Das Repo ist offen und die Skill ist klein genug, um sie in einem Durchgang zu lesen:

👉 github.com/andreab67/agent-skills/blob/main/session-handoff/SKILL.md