Spec, Plan, Handoff
Strukturiere deine Arbeit so, dass die nächste Session reibungslos weitermacht
⏱ ca. ~4 Min
01 · Lesen
Letztlich endet jede Claude-Code-Session irgendwann. Vielleicht ist der Kontext voll. Vielleicht klappst du den Laptop zu. Vielleicht übergibst du an einen Kollegen.
Die Frage ist — kann die nächste Session reibungslos weitermachen?
Die Antwort hängt davon ab, wie gut du dokumentierst. Genau hier kommen Specs ins Spiel. Eine Spec ist eine Markdown-Datei, die ein Feature, einen Bugfix oder eine Aufgabe so detailliert beschreibt, dass Claude (oder ein Kollege) sie aus dem kalten Start übernehmen kann.
Kernpunkte
- Sessions enden — der Kontext ist flüchtig, Specs sind dauerhaft
- Specs ermöglichen es der nächsten Session (oder Person), zu übernehmen, ohne dass alles neu erklärt werden muss
- Eine Spec ist eine Markdown-Datei, die das Was, Warum und Wie beschreibt
- Sie lebt in deinem Repo (oft im Ordner specs/) und wird in git committed
02 · Code-Beispiel
Eine gute Spec beantwortet: Was bauen wir, welche Dateien sind betroffen, und wie sieht „fertig" aus? Unten eine Vorlage.
Vorlage für Feature-Spec
# Feature: OAuth Integration
## Requirements
- Support Google and GitHub OAuth
- Maintain session after page refresh
- Handle token refresh automatically
## Files to Modify
- src/auth/oauth.ts — OAuth client setup
- src/auth/session.ts — Session persistence
- server/routes/auth.ts — API endpoints
## Implementation Plan
1. Set up OAuth provider configuration
2. Add login flow UI components
3. Implement token refresh logic
4. Add integration tests
## Done When
- `npm test` passes
- Can log in with Google and GitHub
- Session survives page refresh
Sieh dir die Struktur an — Anforderungen (was), Dateien (wo), Plan (wie), Definition von Fertig (wann aufhören). Das reicht, damit Claude in einer neuen Session mit diesem Feature anfangen kann. Verweise Claude auf die Spec-Datei und sag: „Implementier das."
03 · Lesen
Für komplexe Änderungen hat Claude Code den Plan-Modus. Statt sofort Code zu schreiben, erkundet Claude die Codebasis, versteht bestehende Muster und schlägt vor dem Implementieren einen Plan vor.
Du kannst deine Arbeit außerdem checkpointen. Drücke Esc+Esc, um das Rewind-Menü zu öffnen — du kannst Code und Gespräch auf jeden vorherigen Punkt zurücksetzen oder ab einem Checkpoint zusammenfassen, um Kontext freizugeben.
Denk an Checkpoints wie an ein lokales Undo — sie verfolgen jede Änderung, die Claude vornimmt, und du kannst jederzeit zurückspulen.
Kernpunkte
- Plan-Modus: Claude erkundet und schlägt vor dem Implementieren einen Plan vor
- Checkpoints: werden vor jeder Änderung automatisch erstellt
- Esc+Esc öffnet das Rewind-Menü — setze Code, Gespräch oder beides zurück
- „Ab hier zusammenfassen" komprimiert alles vor diesem Punkt
- Checkpoints sind sessionlokal (getrennt von git)
04 · Code-Beispiel
Unten siehst du, wie erfahrene Entwickler komplexe Arbeit in Claude Code strukturieren.
Phase 1 — Erkundung
You: "Read the auth module and explain how sessions work"
Claude: [reads files, explains architecture]
Phase 2 — Plan
You: "Write a spec for adding OAuth support"
Claude: [creates specs/OAUTH_SPEC.md with requirements, files, plan]
Phase 3 — Implementierung
You: "Implement the spec in specs/OAUTH_SPEC.md"
Claude: [implements against the spec, step by step]
Phase 4 — Verifikation
You: "Run tests and verify against the spec"
Claude: [runs tests, checks each "done when" criterion]
Specs werden zur Brücke zwischen Sessions. Wenn mitten in der Implementierung der Kontext voll wird, startest du eine neue Session und sagst: „Mach mit der Implementierung von specs/OAUTH_SPEC.md weiter." Claude liest die Spec, prüft in git, was erledigt ist, und macht von dort aus weiter.
05 · Quiz
Du bist mitten in einem komplexen Feature, und der Kontext ist voll. Wie machst du in einer neuen Session am besten weiter?
- Verweise Claude auf deine Spec-Datei und bitte es, weiterzumachen
- Von vorn anfangen und alles neu erklären
- Das gesamte vorherige Gespräch per Copy-Paste einfügen
- Das Feature aufgeben und ein einfacheres bauen
06 · Ausfüllen
Wenn du zweimal Esc drückst, öffnet sich das _____-Menü, in dem du Code und Gespräch auf einen früheren Punkt zurücksetzen kannst.
Andere Lektionen aus diesem Kapitel
⚠ Das volle interaktive Erlebnis braucht JavaScript. Bitte aktiviere es und lade die Seite neu.
※ Diese Seite ist ein unabhängiges Bildungsprojekt — kein offizielles Anthropic-Produkt. Claude™ ist eine eingetragene Marke von Anthropic, PBC.