Modulo 1.4: Compactacao mata memoria

🌀 O que e compactacao

Quando a sessao se aproxima do limite da janela de contexto, Claude Code resume o historico para caber em menos tokens e continuar.

{' GATILHO DE COMPACTACAO \n \n Sessao cresce ──────────────► limite da janela \n ~170k tokens ~200k tokens \n \n Sem compactacao: \n sessao quebra (context overflow) \n \n Com compactacao: \n resume ────► sessao reduzida ────► continua \n'}

🧠 Como Claude decide o que manter

A heuristica de resumo nao e documentada publicamente, mas o padrao observado prioriza: recencia, marcos e decisoes explicitas.

📊 Hierarquia de sobrevivencia

System prompt + CLAUDE.md (100% preservado)
Ultimas 5-10 mensagens (100% preservado)
Marcos anunciados ("vou fazer X", "decidimos Y") — frequentemente preservado
Tool calls e resultados antigos — resumido em 1-2 linhas
Detalhes de exploracao que nao viraram acao — frequentemente descartado

🫥 O efeito "amnesia pos-cirurgia"

Apos compactacao, Claude "sabe" que voces trabalharam em X, mas perdeu como. Resultado: sugere abordagens ja descartadas.

🚨 Sintoma tipico

Voce: "vamos continuar no bug da autenticacao"

Claude: "Otimo! Ja checou se o token esta sendo enviado no header?"

Voce: "Sim, debatemos isso ha duas horas. Foi outra coisa."

🎞️ Anatomia de uma sessao 500k

Exemplo real de compactacao em sessao de debugging longa.

Pre-compactacao (0-170k tokens)

20 mensagens detalhadas com investigacao, hipoteses, tool calls, logs lidos.

Compactacao (trigger automatico)

Claude Code gera resumo de ~3 paragrafos e mantem as ultimas 2 mensagens integrais.

Pos-compactacao (20k tokens)

Detalhes de investigacao perdidos: ~80%. Hipoteses descartadas: mencionadas como "foi tentado X e Y" sem o porque.

🛟 O que sobrevive

Zonas de sobrevivencia sao lugares no prompt que sempre sao preservados.

Zonas garantidas

✓System prompt: preservado sempre
✓CLAUDE.md: re-injetado apos resumo
✓additionalContext de hook: injetado novamente via PreCompact
✓Ultimas N mensagens: mantidas integras

🪝 PreCompact: a saida

O hook PreCompact dispara antes do resumo. Nele voce re-injeta seu contexto critico para garantir sobrevivencia.

{' TIMELINE DO PRECOMPACT \n \n Sessao ~170k tokens \n │ \n ▼ (PreCompact hook dispara aqui) \n [seu script injeta context.md] \n │ \n ▼ \n Claude Code compacta — context.md ja esta no prompt \n │ \n ▼ \n Sessao continua com contexto critico preservado \n'}

💡 Dica

Trilha 4, modulo 4.3 e 4.4 ensinam o setup completo. Voce vai ter o seu PreCompact rodando em menos de 30 minutos.

📝 Resumo do Modulo

✓

Compactacao e inevitavel em sessoes longas — e mecanismo de sobrevivencia.

✓

~80% de detalhes somem — especialmente raciocinio e hipoteses descartadas.

✓

PreCompact e o antidoto — injeta contexto critico antes do resumo.

Proximo Modulo:

1.5 — Fingerprint cognitivo: nao existe one-size-fits-all

← Modulo anterior Proximo Modulo →