Spec, plan, handoff
Structure ton travail pour que la prochaine session reprenne sans accroc
⏱ Estim. ~4 min
01 · Lire
Au final, chaque session Claude Code finit par s'arrêter. Peut-être que le contexte est plein. Peut-être que tu fermes ton portable. Peut-être que tu passes le travail à un coéquipier.
La question est — la prochaine session pourra-t-elle prendre le relais facilement ?
La réponse dépend de la qualité de ta documentation. C'est là qu'entrent en jeu les specs. Une spec est un fichier markdown qui décrit une fonctionnalité, une correction de bug ou une tâche avec assez de détails pour que Claude (ou un coéquipier) puisse démarrer à froid et reprendre.
Points clés
- Les sessions finissent — le contexte est temporaire, les specs sont permanentes
- Les specs permettent à la prochaine session (ou personne) de reprendre sans réexpliquer
- Les specs sont des fichiers markdown qui décrivent quoi, pourquoi, comment
- Vivent dans ton repo (souvent dans un dossier specs/), commit dans git
02 · Exemple de code
Une bonne spec répond à : qu'est-ce qu'on construit, quels fichiers sont concernés, à quoi ressemble « fini » ? Voici un template.
Template de spec de fonctionnalité
# 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
Regarde la structure — exigences (quoi), fichiers (où), plan (comment), définition de fini (quand on s'arrête). Ça suffit à Claude pour démarrer cette fonctionnalité dans une nouvelle session. Pointe Claude vers le fichier de spec et dis « implémente ça ».
03 · Lire
Pour les changements complexes, Claude Code propose le mode plan. Au lieu d'écrire du code tout de suite, Claude explore le code, comprend les patterns existants et propose un plan avant d'implémenter.
Tu peux aussi checkpointer ton travail. Appuie sur Esc+Esc pour ouvrir le menu rewind — tu peux restaurer le code et la conversation à n'importe quel point antérieur, ou libérer du contexte avec un résumé depuis un checkpoint.
Vois les checkpoints comme un undo local — ils suivent chaque modification de Claude, et tu peux toujours revenir en arrière.
Points clés
- Mode plan : Claude explore et propose un plan avant d'implémenter
- Checkpoints : créés automatiquement avant chaque modification
- Esc+Esc ouvre le menu rewind — restaure code, conversation ou les deux
- « Résumer depuis ici » compacte tout ce qui précède ce point
- Les checkpoints sont locaux à la session (séparés de git)
04 · Exemple de code
Voici comment les ingénieurs expérimentés structurent un travail complexe avec Claude Code.
Phase 1 — exploration
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 — implémentation
You: "Implement the spec in specs/OAUTH_SPEC.md"
Claude: [implements against the spec, step by step]
Phase 4 — vérification
You: "Run tests and verify against the spec"
Claude: [runs tests, checks each "done when" criterion]
La spec devient le pont entre les sessions. Si le contexte se remplit en cours d'implémentation, ouvre une nouvelle session et dis « continue à implémenter specs/OAUTH_SPEC.md ». Claude lit la spec, regarde git pour voir ce qui est fait, et reprend là où ça en était.
05 · Quiz
Tu es à mi-chemin d'une fonctionnalité complexe et le contexte est plein. Quelle est la meilleure façon de continuer dans une nouvelle session ?
- Pointer Claude vers ton fichier de spec et lui demander de continuer
- Tout recommencer et tout réexpliquer
- Copier-coller toute la conversation précédente
- Abandonner la fonctionnalité et en faire une plus simple
06 · Compléter
Appuie sur Esc deux fois pour ouvrir le menu _____, où tu peux restaurer code et conversation à un point antérieur.
Autres leçons de ce chapitre
⚠ L'expérience interactive complète nécessite JavaScript. Active-le et recharge la page.
※ Ce site est un projet éducatif indépendant — pas un produit officiel d'Anthropic. Claude™ est une marque déposée d'Anthropic, PBC.