Spec, plan y handoff
Estructura tu trabajo para que la próxima sesión lo retome sin tropiezos
⏱ Estim. ~4 min
01 · Leer
Al final, toda sesión de Claude Code termina. Quizá se llena el context. Quizá cierras la laptop. Quizá pasas el trabajo a alguien del equipo.
La pregunta es — ¿la próxima sesión puede continuar sin fricción?
La respuesta depende de qué tan bien documentes. Y ahí entran las specs. Una spec es un archivo markdown que describe una feature, un fix de bug o una tarea con suficiente detalle como para que Claude (o alguien del equipo) la retome en frío.
Puntos clave
- Las sesiones terminan — el context es temporal, las specs son permanentes
- Las specs dejan que la próxima sesión (o persona) continúe sin volver a explicar todo
- Una spec es un archivo markdown que describe qué, por qué y cómo
- Vive en tu repo (normalmente en una carpeta specs/) y va al commit en git
02 · Ejemplo de código
Una buena spec responde: qué vamos a construir, qué archivos se tocan y cómo se ve "terminado". Aquí va una plantilla.
Plantilla de spec de feature
# 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
Mira la estructura — requisitos (qué), archivos (dónde), plan (cómo), definición de hecho (cuándo parar). Es suficiente para que Claude arranque la feature en una sesión nueva. Apunta a Claude al archivo de spec y dile "implementa esto".
03 · Leer
Para cambios complejos, Claude Code tiene el modo plan. En vez de escribir código de inmediato, Claude explora la base de código, entiende los patrones actuales y propone un plan antes de implementar.
También puedes hacer checkpoint de tu trabajo. Presiona Esc+Esc para abrir el menú de rewind — puedes restaurar el código y la conversación a cualquier punto anterior, o liberar context con un resumen desde un checkpoint.
Piensa en los checkpoints como un undo local — registran cada cambio que hace Claude y siempre puedes regresar.
Puntos clave
- Modo plan: Claude explora y propone un plan antes de implementar
- Checkpoints: se crean automáticamente antes de cada cambio
- Esc+Esc abre el menú de rewind — restaura código, conversación o ambos
- "Resumir desde aquí" comprime todo lo previo a ese punto
- Los checkpoints son locales a la sesión (separados de git)
04 · Ejemplo de código
Así estructuran los ingenieros con experiencia el trabajo complejo con Claude Code.
Fase 1 — exploración
You: "Read the auth module and explain how sessions work"
Claude: [reads files, explains architecture]
Fase 2 — plan
You: "Write a spec for adding OAuth support"
Claude: [creates specs/OAUTH_SPEC.md with requirements, files, plan]
Fase 3 — implementación
You: "Implement the spec in specs/OAUTH_SPEC.md"
Claude: [implements against the spec, step by step]
Fase 4 — verificación
You: "Run tests and verify against the spec"
Claude: [runs tests, checks each "done when" criterion]
La spec se vuelve el puente entre sesiones. Si el context se llena a mitad de la implementación, abre una sesión nueva y di "continúa implementando specs/OAUTH_SPEC.md". Claude lee la spec, mira git para ver qué quedó hecho y retoma.
05 · Quiz
Estás a la mitad de una feature compleja y se llena el context. ¿Cuál es la mejor forma de continuar en una sesión nueva?
- Apunta a Claude a tu archivo de spec y pídele que continúe
- Empezar de cero y volver a explicar todo
- Copiar y pegar toda la conversación anterior
- Abandonar la feature y hacer una más simple
06 · Completar
Presiona Esc dos veces para abrir el menú de _____, donde puedes restaurar el código y la conversación a un punto anterior.
Otras lecciones de este capítulo
⚠ La experiencia interactiva completa necesita JavaScript. Actívalo y vuelve a cargar la página.
※ Este es un proyecto educativo independiente — no es un producto oficial de Anthropic. Claude™ es una marca registrada de Anthropic, PBC.