MODULO 1.5

📦 Compaction: Dominando a Compressao

Aprenda como funciona a compactacao de contexto, quando usar, e tecnicas para preservar informacoes criticas durante a compressao.

6
Topicos
30
Minutos
Basico
Nivel
Pratico
Tipo
1

🗜️ O que e Compaction

Compaction e o processo de comprimir a conversa quando o contexto fica muito cheio. Claude resume o historico, descarta detalhes menos importantes e libera espaco para continuar trabalhando.

Como Funciona

85%
Antes
📝
Resume
25%
Depois

Contexto e comprimido, mantendo informacoes essenciais

📊 O que e Preservado

  • Decisoes arquiteturais importantes
  • Bugs nao resolvidos e erros pendentes
  • Detalhes de implementacao criticos
  • 5 arquivos mais recentes acessados
2

⚙️ Auto-Compact vs Manual

Existem duas formas de compactacao: automatica (quando atinge o limite) e manual (quando voce decide). Cada uma tem suas vantagens.

🤖 Auto-Compact

Acontece automaticamente quando o contexto atinge ~85-90%

  • Pode acontecer no meio de uma tarefa
  • Voce nao controla o que e preservado
  • Pode perder contexto importante

👆 Manual (/compact)

Voce decide quando e como compactar

  • Escolhe o momento certo
  • Pode instruir o que preservar
  • Mais controle sobre resultado

💡 Recomendacao

Prefira sempre compactacao manual quando possivel. Use /compact antes de chegar a 70% para ter controle sobre o que e preservado.

3

🎚️ Threshold Recomendado: 70%

O gatilho ideal para /compact e 70% de uso. Isso deixa espaco suficiente para Claude processar a compactacao sem perder qualidade.

Por que 70%?

0-50%
Trabalhe normalmente
50-70%
Prepare compactacao
70%
COMPACTE AQUI!
70-85%
Urgente - compacte ja
85%+
Auto-compact ativado

📊 Buffer de 30%

Compactar em 70% deixa 60K tokens livres (30% de 200K). Isso e espaco suficiente para Claude raciocinar, planejar alternativas e construir respostas de qualidade.

4

🎯 Personalizando Compaction

O comando /compact aceita instrucoes sobre o que preservar. Isso e poderoso!

Exemplos de Uso

Preservar decisoes especificas:

/compact preserve as decisoes de autenticacao e os patterns de API

Manter apenas nomes de arquivos:

/compact only keep the names of files we reviewed

Preservar padroes de codigo:

/compact preserve the coding patterns we established

💡 Dica Avancada

Antes de usar /compact, escreva explicitamente o que deve sobreviver: "Antes de compactar, lembre: 1. Usamos JWT, 2. Token expira em 15min...". Claude incluira isso no resumo.

5

⚠️ Riscos da Compactacao

Compactacao nao e magica - ela perde informacao. Apos varias compactacoes, detalhes importantes podem desaparecer.

⚠️ O que Pode ser Perdido

  • • Detalhes de conversas antigas
  • • Nuances de decisoes tomadas
  • • Contexto de arquivos lidos ha tempo
  • • Feedback loops de erros anteriores
  • • Preferencias mencionadas no inicio

✓ Mitigacoes

  • • Grave decisoes no CLAUDE.md
  • • Crie playbooks para fluxos complexos
  • • Use /compact com instrucoes
  • • Prefira sessoes novas quando possivel

Sinais de Problema

  • • Claude "esquece" instrucoes
  • • Repete erros ja corrigidos
  • • Pede informacoes ja dadas
  • • Contradiz decisoes anteriores
6

📝 Hack: Pre-Compaction Summary

A tecnica mais poderosa para compactacao efetiva: criar um resumo antes de compactar.

Passo a Passo

1

Peca um resumo

"Antes de compactar, resuma em 5-7 bullets o que PRECISA sobreviver desta sessao"
2

Revise o resumo

Verifique se capturou tudo importante

3

Execute /compact

/compact
4

Opcional: Atualize CLAUDE.md

Grave aprendizados permanentes

🚀 Proximo Passo

No proximo modulo vamos explorar Sessoes e Persistencia - o que persiste entre sessoes, snapshots de arquivos, e estrategias para multiplos terminais.

📋 Resumo do Modulo

Compaction comprime contexto - Resume historico e libera espaco
Manual > Auto - /compact te da mais controle
Gatilho ideal: 70% - Deixa buffer para qualidade
Personalize com instrucoes - Diga o que preservar
Use pre-compaction summary - Resume antes de compactar

Proximo Modulo:

1.6 - Sessoes e Persistencia