Modulo 4.3: PreCompact: sobrevivendo ao squeeze

🎯 Quando PreCompact dispara

Claude Code detecta que sessao passou do threshold (~170k tokens). Antes de fazer o resumo automatico, dispara PreCompact.

📐 Gatilho de compactacao

Sessao crescendo turno a turno...
      │
      ▼
┌─────────────────────────────────────┐
│ Claude Code monitora token count    │
│ Threshold: ~170k tokens             │
│ (configuravel, default conservador) │
└─────────────┬───────────────────────┘
              │
              ▼
 PreCompact HOOK ← sua janela
              │
              ▼
 Resumo automatico (model compacta historico)
              │
              ▼
 Sessao continua com prompt enxuto

💡 Nao esperar 170k

O hook dispara so quando Claude Code decide compactar. Em sessoes curtas nunca roda. E OK — serve so quando precisa.

📄 O que injetar: context.md

Para garantir que projeto e decisoes sobrevivam ao resumo, injete seu context.md.

💉 Por que context.md funciona

Dinamica do squeeze:

•Claude Code adiciona additionalContext ao prompt.
•Depois faz o resumo. O resumo INCLUI additionalContext.
•Portanto, seu texto fica no prompt compactado tambem.
•Resultado: contexto critico preservado literal, mesmo apos squeeze.

🧪 Configuracao do hook

Mesmo padrao do SessionStart, outro evento. Reaproveite o script.

📐 settings.json com PreCompact

{
  "hooks": {
    "SessionStart": [{
      "matcher": "",
      "hooks": [{
        "type": "command",
        "command": "~/.memory/hooks/inject.sh SessionStart"
      }]
    }],
    "PreCompact": [{
      "matcher": "",
      "hooks": [{
        "type": "command",
        "command": "~/.memory/hooks/inject.sh PreCompact"
      }]
    }]
  }
}

# inject.sh unifica os dois casos:
#!/usr/bin/env bash
EVENT=${1:-SessionStart}
CTX=$(cat ~/.memory/context.md 2>/dev/null || echo "")
python3 -c "
import json
print(json.dumps({
  'hookSpecificOutput': {
    'hookEventName': '$EVENT',
    'additionalContext': '''$CTX'''
  }
}))
"

💡 DRY

Um script, dois eventos. Se mudar o formato de context.md, nao precisa atualizar em dois lugares.

🧪 Lab: forçando compactacao

Testar em condicao controlada e melhor que esperar acontecer num momento critico.

Prepare sessao sintetica

Abra Claude Code. Faça varias queries pesadas que geram muito output: 'liste todos os arquivos do projeto com tamanho', 'mostra diff completo de ultimos 20 commits', etc.

Monitore contagem

Muitos clientes de Claude mostram token count. Quando chegar perto de 170k, prepare sua pergunta de teste.

Faça a pergunta antes

'Qual o projeto ativo?' — resposta deve vir do context.md.

Gatilho forcado ou espera

Continue mandando queries pesadas ate compactar. Pergunte de novo 'qual o projeto?'. Se sobrevivente, o hook funcionou.

💡 Signal claro

Use palavra especifica em context.md ('projeto alpha-42'). Pos-squeeze, Claude deve mencionar exatamente essa palavra para provar survival.

📊 Validacao: antes/depois

Dois pontos no tempo, mesma pergunta, comparacao direta.

📐 Protocolo A/B

ANTES da compactacao:
  Pergunta: "Qual decisao tomamos semana passada?"
  Resposta esperada: detalhe especifico do context.md
  Validacao: gravar resposta.

Forçar compactacao (queries pesadas ate ~170k)

DEPOIS da compactacao:
  Mesma pergunta.
  Resposta esperada: mesmo detalhe especifico.
  Validacao: comparar.

MATCH = PreCompact funcionou.
MISMATCH = debug necessario (log do hook, additionalContext size).

💡 Automatizar

Script bash que abre Claude Code em modo headless, envia mensagens padrao, captura respostas pre e pos. Da pra rodar CI do seu sistema de memoria.

⚠️ Armadilhas comuns

Tres erros que pioram o sistema em vez de melhorar.

✓ Fazer

✓Injetar context.md (400 tokens, signal alto)
✓Usar script dedicado, reutilizavel
✓Logar tamanho do additionalContext
✓Testar em sessoes forcadas antes de depender

✗ NAO fazer

✗Injetar CLAUDE.md inteiro (ja esta no prompt)
✗Injetar log da sessao (>2k tokens polui resumo)
✗Injetar tudo, incluindo long-term (explode prompt)
✗Assumir que funciona sem testar

📝 Resumo do Modulo

✓

Dispara antes do squeeze — janela de ouro para injetar.

✓

Re-injeta context.md — 400 tokens de contexto preservados.

✓

Mesmo script do SessionStart — reuso reduz manutencao.

✓

Validacao A/B — antes/depois da compactacao, mesmo teste.

Proximo:

4.4 — context.md: escrevendo contexto critico

← Modulo anterior Proximo Modulo →