Spec, plan, handoff
Estruture seu trabalho para a próxima sessão retomar sem problemas
⏱ Estim. ~4 min
01 · Ler
Por fim, toda sessão do Claude Code acaba. Pode ser que o contexto encha. Pode ser que você feche o notebook. Pode ser que você passe o trabalho para um colega.
A pergunta é — a próxima sessão consegue continuar com fluidez?
A resposta depende de quão bem você documentou. É aqui que a spec entra. Uma spec é um arquivo markdown que descreve uma feature, uma correção de bug ou uma tarefa com detalhe suficiente para o Claude (ou um colega) pegar do zero e continuar.
Pontos-chave
- Sessões terminam — contexto é temporário, spec é permanente
- Specs permitem que a próxima sessão (ou pessoa) continue sem reexplicação
- Uma spec é um arquivo markdown descrevendo o quê, o porquê e o como
- Fica no seu repo (geralmente na pasta specs/), commitada no git
02 · Exemplo de código
Uma boa spec responde: o que estamos construindo, quais arquivos estão envolvidos, e como é "pronto"? Abaixo, um template.
Template 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
Olhe a estrutura — requisitos (o quê), arquivos (onde), plano (como), definição de pronto (quando parar). É o suficiente para o Claude começar essa feature em uma nova sessão. Aponte o Claude para o arquivo da spec e diga "implemente isto".
03 · Ler
Para mudanças complexas, o Claude Code tem o plan mode. Em vez de escrever código de cara, o Claude explora o codebase, entende os padrões existentes e propõe um plano antes de implementar.
Você também pode fazer checkpoint do seu trabalho. Aperte Esc+Esc para abrir o menu de rewind — você pode restaurar o código e a conversa para qualquer ponto anterior, ou liberar contexto resumindo a partir de um checkpoint.
Pense nos checkpoints como um undo local — eles rastreiam cada mudança que o Claude fez, e você sempre consegue voltar.
Pontos-chave
- Plan mode: o Claude explora e propõe um plano antes de implementar
- Checkpoint: criado automaticamente antes de cada mudança
- Esc+Esc abre o menu de rewind — restaure código, conversa ou ambos
- "Resumir a partir daqui" compacta tudo antes daquele ponto
- Checkpoints são locais por sessão (separados do git)
04 · Exemplo de código
Veja como engenheiros experientes estruturam trabalhos complexos com o Claude Code.
Fase 1 — exploração
You: "Read the auth module and explain how sessions work"
Claude: [reads files, explains architecture]
Fase 2 — plano
You: "Write a spec for adding OAuth support"
Claude: [creates specs/OAUTH_SPEC.md with requirements, files, plan]
Fase 3 — implementação
You: "Implement the spec in specs/OAUTH_SPEC.md"
Claude: [implements against the spec, step by step]
Fase 4 — validação
You: "Run tests and verify against the spec"
Claude: [runs tests, checks each "done when" criterion]
A spec vira a ponte entre sessões. Se o contexto enche no meio da implementação, abra uma sessão nova e diga "continue implementando specs/OAUTH_SPEC.md". O Claude lê a spec, olha o git para ver o que já foi feito, e continua o trabalho.
05 · Quiz
Você está no meio de uma feature complexa e o contexto encheu. Qual o melhor jeito de continuar em uma nova sessão?
- Apontar o Claude para o arquivo da spec e pedir para continuar
- Recomeçar do zero e explicar tudo de novo
- Copiar e colar a conversa anterior inteira
- Abandonar a feature e fazer algo mais simples
06 · Preencher
Aperte Esc duas vezes para abrir o menu de _____, onde você pode restaurar código e conversa para um ponto anterior.
Outras lições deste capítulo
⚠ A experiência interativa completa precisa de JavaScript. Ative-o e recarregue a página.
※ Este é um projeto educacional independente — não é um produto oficial da Anthropic. Claude™ é uma marca registrada da Anthropic, PBC.