Spec, plan, handoff
Struttura il tuo lavoro per passaggi di consegne puliti tra una session e l'altra
⏱ Stima ~4 min
01 · Leggi
Prima o poi ogni session di Claude Code finisce. Magari il contesto è pieno. Magari chiudi il laptop. Magari passi il lavoro a un compagno di team.
La domanda è: la prossima session può riprendere senza intoppi?
La risposta dipende da quanto bene documenti. È qui che entra in gioco la spec. Una spec è un file markdown che descrive una feature, una correzione di bug o un task con abbastanza dettaglio da permettere a Claude (o a un compagno) di partire da zero e continuare.
Punti chiave
- Le session finiscono — il contesto è temporaneo, la spec è permanente
- La spec permette alla prossima session (o persona) di riprendere senza rispiegare
- Una spec è un file markdown che descrive cosa, perché e come
- Vive nel tuo repo (spesso in una cartella specs/), committata su git
02 · Esempio di codice
Una buona spec risponde a: cosa stiamo costruendo, quali file sono coinvolti, come appare il "fatto"? Ecco un template.
Feature spec template
# 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
Guarda la struttura — requisiti (cosa), file (dove), piano (come), definizione di done (quando fermarsi). È abbastanza perché Claude inizi questa feature in una nuova session. Indica a Claude il file spec e digli "implementa questo".
03 · Leggi
Per modifiche complesse, Claude Code ha la modalità plan. Invece di scrivere codice subito, Claude esplora la codebase, capisce i pattern esistenti e propone un piano prima di implementare.
Puoi anche fare checkpoint del tuo lavoro. Premi Esc+Esc per aprire il menu rewind — puoi ripristinare sia il codice che la conversazione a qualsiasi punto precedente, o riassumere da un checkpoint per liberare contesto.
Pensa ai checkpoint come a un undo locale — tengono traccia di ogni modifica di Claude, e puoi sempre tornare indietro.
Punti chiave
- Modalità plan: Claude esplora e propone un piano prima di implementare
- Checkpoint: creati automaticamente prima di ogni modifica
- Esc+Esc apre il menu rewind — ripristina codice, conversazione, o entrambi
- "Riassumi da qui" comprime tutto ciò che viene prima di quel punto
- I checkpoint sono locali alla session (separati da git)
04 · Esempio di codice
Ecco come gli ingegneri esperti strutturano il lavoro complesso con Claude Code.
Fase 1 — Esplorazione
You: "Read the auth module and explain how sessions work"
Claude: [reads files, explains architecture]
Fase 2 — Pianificazione
You: "Write a spec for adding OAuth support"
Claude: [creates specs/OAUTH_SPEC.md with requirements, files, plan]
Fase 3 — Implementazione
You: "Implement the spec in specs/OAUTH_SPEC.md"
Claude: [implements against the spec, step by step]
Fase 4 — Validazione
You: "Run tests and verify against the spec"
Claude: [runs tests, checks each "done when" criterion]
La spec diventa il ponte tra le session. Se il contesto si riempie a metà implementazione, apri una nuova session e di' "continua a implementare specs/OAUTH_SPEC.md". Claude legge la spec, guarda git per vedere cosa è fatto e riprende.
05 · Quiz
Stai lavorando su una feature complessa e il contesto si riempie a metà. Qual è il modo migliore per continuare in una nuova session?
- Indica a Claude il tuo file spec e chiedigli di continuare
- Ricominciare da capo rispiegando tutto
- Copiare e incollare tutta la conversazione precedente
- Abbandonare la feature e fare qualcosa di più semplice
06 · Completa
Premi Esc due volte per aprire il menu _____, dove puoi ripristinare codice e conversazione a un punto precedente.
Altre lezioni di questo capitolo
⚠ L'esperienza interattiva completa richiede JavaScript. Attivalo e ricarica la pagina.
※ Questo è un progetto educativo indipendente — non è un prodotto ufficiale di Anthropic. Claude™ è un marchio di Anthropic, PBC.