Claude-Code-Session-Handoff-Vorlage: Kontext für den nächsten Menschen oder Agenten erhalten

Claude Code wird stärker, wenn Sessions übergeben werden können

Viele Fehler entstehen nicht durch schlechten Code, sondern durch verlorenen Kontext. Eine Handoff-Notiz hilft dir morgen oder einem Teammitglied, sicher weiterzumachen.

Dieser Artikel verbindet das First-Task-Runbook mit der Bug-Report-Vorlage.

Handoff-Vorlage

# Claude Code Handoff

## Goal
- Ziel heute:
- Heute nicht:

## Current state
- branch:
- last commit:
- dirty files:
- relevante URLs:

## What changed
- Änderungen:
- Dateien:
- Absicht:

## Verification
- Befehle:
- Ergebnis:
- visuelle Prüfung:

## Risks
- fragile Bereiche:
- nicht anfassen:
- ungeprüft:

## Next prompt
In der nächsten Session zuerst git status und den letzten Diff prüfen.
Erst starten, wenn beides zu diesem Handoff passt.

Gutes Beispiel

## Goal
- Interne Links von /en/products/ zu den drei Artikeln vom 25.5. ergänzt
- Pricing-Struktur heute nicht ändern

## Verification
- npm.cmd run build: erfolgreich
- production /en/products/: 200
- mobile 390px: kein horizontales Overflow

## Risks
- Gumroad Links priorisieren Englisch
- Nicht-englische Texte auf öffentlicher URL prüfen

Häufige Lücken

• Nur build OK schreiben, ohne öffentliche URL
• Dirty files nicht erklären
• Ungeprüftes als “vermutlich OK” verstecken
• Keinen nächsten Prompt hinterlassen

Ein Handoff ist kein Tagebuch. Es soll in 5 Minuten einen sicheren Neustart ermöglichen.

Nächster Schritt

Für Einzelarbeit nutze das kostenlose Cheatsheet. Für Teams kombiniere Setup Guide und Prompt Templates. Für Einführung siehe Beratung.

Handoff ist genauer als Commit Message und kürzer als Tagebuch

Die Handoff-Notiz ist Betriebsinformation. Eine Commit Message enthält selten Verifikation und Risiken; ein Tagebuch ist zu lang. Benötigt werden Zustand, Änderungsgrund, Prüfung, fragile Bereiche und nächster Prompt.

Reviewe dieses Handoff:
1. kein Widerspruch zu git status
2. Änderungsgrund in einem Satz
3. Build und öffentliche URL getrennt
4. ungeprüfte Risiken sichtbar
5. nächster Prompt reicht zum Fortsetzen

Bei mehrsprachigen Sites gehören öffentliche URL, Sprache, mobile Breite und CTA-Zustand dazu. Ein erfolgreicher Build beweist nicht, dass die sichtbare Seite korrekt ist.