🎬 Começando nova sessão com handoff
O fluxo de retomada tem 3 etapas, na ordem certa. Cada uma garante uma camada de contexto — pular uma é garantir lacunas.
Fluxo de retomada completo
Abra Claude Code no diretório certo
cd /home/dev/projeto && claude
Isso garante que o CLAUDE.md do projeto seja lido automaticamente.
/clear se sessão anterior ainda estiver viva
Se você voltou para o mesmo terminal de uma sessão suja, use /clear antes de colar o handoff.
Se abriu novo terminal, isso não é necessário — já está limpo.
Cole o handoff como primeira mensagem
Preceda com o prompt de retomada (tópico 2). Espere o Claude confirmar entendimento antes de pedir ação.
Nessa hora você tem 3 camadas empilhadas: CLAUDE.md (auto), skills (sob demanda), handoff (colado).
🧱As 3 camadas de contexto "grátis"
- 1.CLAUDE.md → carrega sozinho (regras do projeto)
- 2.Skills → o Claude invoca quando precisa (workflows)
- 3.Handoff → você cola (estado específico dessa continuação)
Juntas, reconstroem 90% do contexto que se perdeu no /clear.
📋 Prompt de retomada — template
Colar o handoff direto e esperar que o Claude "continue" é muitas vezes o bastante — mas um prompt de retomada curto antes dele aumenta a qualidade da primeira resposta em 80% dos casos.
Template oficial
cole antes do handoffVou continuar um projeto. Leia o handoff abaixo e me confirme que entendeu antes de agir:
[cola handoff]
Próxima ação: [pegar do handoff]🔍Por que esse prompt funciona
- →"Vou continuar um projeto" — framing que muda o modo do Claude para "retomar", não "começar do zero"
- →"Leia o handoff abaixo" — sinaliza que o texto a seguir não é a tarefa, é contexto
- →"me confirme que entendeu antes de agir" — BLOQUEIO explícito contra ação impulsiva
- →"Próxima ação: [...]" — reforça qual a tarefa depois da confirmação
Exemplo preenchido (copie e adapte)
Vou continuar um projeto. Leia o handoff abaixo e me confirme que entendeu antes de agir:
# Objetivo
Adicionar OAuth Google ao /api/login.
# Estado atual
- Branch: feature/google-oauth
- Servidor dev em http://localhost:3001 (PID 4182)
# O que foi feito
- next-auth v5 instalado
- Rota /api/auth/[...nextauth].ts criada
- Schema User atualizado em /prisma/schema.prisma
# Próxima ação
Rodar `npx prisma migrate dev --name add-oauth-provider`.
Próxima ação: rodar a migration e validar que aplica sem erros.💡Uma linha adicional opcional
Quando o projeto é sensível, adicione: "Se alguma informação estiver faltando ou ambígua, PERGUNTE antes de executar." Isso vira um freio extra contra inferências erradas.
✅ Validar que o novo Claude entendeu
Depois que o Claude processa o handoff, valide antes de autorizar ação. Um check de 10 segundos detecta o mal-entendido que custaria 20 minutos de retrabalho.
🎯A pergunta mágica
Força síntese. Impede resposta evasiva ("vou seguir o handoff"). Se a resposta dele não bate com o que está escrito, é alerta vermelho.
✓ Resposta boa (prossegue)
2. Verificar se o schema atualizou sem erro no banco local."
Específica. Bate com o handoff. Autorize.
✗ Resposta ruim (corrija)
Inventou uma ordem diferente do handoff. Redirecione.
Outras perguntas úteis de validação
git status antes.🔄 Auto-compaction do Claude Code
Se você não controlar a sessão, ela se auto-gerencia. O auto-compaction dispara automaticamente em ~95% da capacidade — mas de forma genérica, sem entender suas prioridades.
Como o auto-compaction funciona
📊A ordem de corte do auto-compaction
Claude Code não corta tudo ao mesmo tempo — há prioridade. Primeiro o descartável, depois o essencial:
- 1.Tool outputs — stdout de comandos, resultados de buscas (alto volume, baixo valor residual)
- 2.Leituras de arquivo antigas — mantém só os arquivos ainda referenciados
- 3.Mensagens mais antigas — resume em síntese
- 4.User requests importantes — preservados no resumo
✓ Handoff manual (sua escolha)
- ✓Você escolhe o que é importante
- ✓Próxima ação fica explícita
- ✓Sessão começa limpa — máxima atenção
- ✓Dispara quando VOCÊ quiser
~ Auto-compaction (fallback)
- ~Resumo genérico, não prioriza o seu foco
- ~Perde nuances de decisões
- ~Dispara em 95% — qualidade já caindo
- ~Ainda melhor que travar a sessão
🎯Rede de segurança, não estratégia
Auto-compaction existe para evitar crash, não para ser o seu plano. Se você está confiando no auto-compaction, você já está tarde demais — o contexto está poluído há vários turnos.
🗺️ O que sobrevive ao compaction
Saber o que sobrevive ao compaction muda onde você coloca coisas importantes. Regra de bolso: tudo que é re-lido do disco é resiliente; tudo que vive só no histórico é descartável.
Matriz de sobrevivência pós-compaction
| Item | Sobrevive? | Como |
|---|---|---|
| 📘 CLAUDE.md | SIM · 100% | Re-lido do disco após compaction |
| 🎒 Skills invocadas | SIM | Re-anexadas até 5k tokens cada |
| ⚙️ System prompt | SIM | Sempre presente |
| 📝 User requests marcados | PARCIAL | Preservados no resumo |
| 💬 Conversa histórica | RESUMIDA | Condensada, não literal |
| 📄 Arquivos lidos antigos | NÃO | Removidos se não referenciados |
| 🛠️ Tool outputs | NÃO | Primeiros a serem cortados |
🧠O que isso implica na prática
- →Regra crítica? CLAUDE.md. Sobrevive sem esforço.
- →Workflow usado raramente? Skill. Re-anexada quando pedida.
- →Decisão importante dita no chat? Também anote em
decisions.md— ou some no resumo. - →Comando que funcionou? Anote no handoff — tool output some.
💡Como saber se compaction aconteceu
O Claude Code mostra sinal no status. Você também pode perceber por sintomas: mensagens antigas "resumidas" aparecendo, outputs de comandos sumindo. Depois de compaction, re-validar o que o Claude "lembra" é saudável.
⚠️ "Limpa e lembra" — o erro fatal
Este é o bug humano mais comum da Trilha 3. Fazer /clear e depois perguntar "continua de onde paramos?" — como se o Claude tivesse memória escondida. Ele não tem. E pior: vai inventar uma continuação plausível.
🚨Por que é fatal
Depois de /clear, o Claude não tem nenhum registro da conversa anterior. Zero. Mas ele é treinado para ser útil — então quando você pergunta "continua daquela função do OAuth?", em vez de dizer "não sei do que você fala", ele alucina uma continuação plausível.
Resultado: você passa 20 minutos autorizando código que parece certo, até perceber que ele está mexendo em arquivos que você nunca editou antes, resolvendo um problema que você nunca discutiu.
Como o erro acontece na prática
✅O jeito certo — 3 regras
- 1.Depois de /clear, SEMPRE cole o handoff. Não existe atalho.
- 2.Se não tem handoff, aceite que vai começar do zero. Não tente "lembrar pela conversa".
- 3.Valide com a pergunta mágica. "Em 2 linhas, o que vamos fazer?" pega alucinação em segundos.
✗ Fluxo fatal
✓ Fluxo correto
🏆A disciplina central da Trilha 3
Claude não tem memória entre sessões. Aceite isso profundamente. Cada /clear é um apagão total — sua responsabilidade é reconstruir contexto com artefatos externos (handoff, CLAUDE.md, arquivos). Quem aceita essa disciplina ganha velocidade. Quem tenta "enganar o sistema" paga caro.
🤖 Skill de memória: automatize o handoff
Até aqui você aprendeu o handoff manual: pedir resumo, copiar, limpar, colar. Funciona, mas tem atalho. Uma skill de memória faz o salvamento e o Claude recarrega sozinho na próxima mensagem após /clear.
Preciso comprimir… ou posso limpar?
Se o essencial está salvo em memória persistente, /clear é mais limpo que /compact.
O fluxo em 3 passos
MEMORY.md + arquivos de apoio (decisões, todos, artefatos).MEMORY.md e os arquivos referenciados na inicialização. Você nem precisa colar handoff.📋 Handoff manual (3-1)
- •Peço resumo estruturado
- •Copio da conversa
- •
/clear - •Colo o resumo na nova mensagem
- •Valido que o Claude entendeu
Bom para: sessão ad-hoc, sem skill configurada.
🤖 Skill de memória
- •"Salva memória"
- •
/clear - •Próxima mensagem: continua
- •(reload automático)
- •(validação opcional)
Bom para: rotina diária, projetos recorrentes.
💡/clear > /compact (com memória salva)
/compact mantém tudo na mesma sessão, mas o cache do prefixo pode virar inútil (resumo novo quebra o cache). /clear + memória persistente devolve um prefixo limpo, previsível, estável para cache.
Para sessões de 50k+ tokens, /clear + skill costuma ser mais barato que /compact repetido. Trilha 6 tem os números detalhados.
⚠️Pré-requisito inegociável
/clear sem memória salva = "limpa e inventa" (o erro do tópico 6). /clear com memória salva = reset limpo. A skill é o que separa os dois mundos.
📋Resumo do Módulo
Próxima trilha:
Trilha 4 — 🎯 Avançado
Subagentes, orquestração, técnicas avançadas de contexto para projetos complexos.