Modulo 2.5: Memoria Episodica

🎬 O que e memoria episodica

Episodica e o registro bruto das sessoes. Nao e resumo. E a conversa inteira, com todos os detalhes, hipoteses, hesitacoes.

📜 O que so episodica preserva

Informacao que long-term nao captura:

•O debate que precedeu a decisao
•Alternativas consideradas e rejeitadas
•As razoes tacitas ('nao gostamos de X porque...')
•O clima da decisao (pressa, pressao, ceticismo)
•Quem levantou cada ponto (em time)

📦 Formato: JSONL da sessao

Boa noticia: Claude Code ja salva isso. Cada sessao vira um arquivo JSONL com todas as mensagens. Seu trabalho e organizar e indexar.

📐 Onde vive o JSONL

~/.config/claude/projects/
  └── [project-hash]/
        ├── session-2026-04-20T10-15.jsonl
        ├── session-2026-04-21T14-02.jsonl
        └── session-2026-04-23T09-30.jsonl

Cada JSONL:
  uma linha por mensagem (user ou assistant)
  JSON com role, content, timestamp, tool_calls

💡 Path pode variar

A localizacao exata varia por versao do Claude Code. Procure por *.jsonl em ~/.config/claude/ ou ~/.claude/.

🔕 Nao carregar em bloco

Episodica e cold storage. Jamais entra no prompt por default. Custo seria proibitivo.

📊 Tamanho tipico

Sessao media: 30-100k tokens de JSONL
100 sessoes: 3-10M tokens armazenados
1 ano: 50M+ tokens
Custo se carregar tudo: proibitivo (~$150 so em input)

⚠️ Regra de ouro

Episodica SO entra no prompt quando voce pede explicitamente. 'Por que decidimos X?' dispara busca dirigida.

🔍 Como buscar no passado

O padrao time-travel query: usuario pede, script localiza, injeta so o trecho relevante.

Identificar data ou tema

'Por que escolhemos FastAPI?' → Claude pergunta 'quando? ou quer que eu busque?'

Script varre JSONL

grep por palavras-chave ou data. Retorna as sessoes candidatas.

Extrai trecho relevante

Pega as 5-10 mensagens proximas ao tema. Tudo dentro de uma janela.

Injeta como context especial

Formato: 'Em [data], voce discutiu X: [mensagens]'. Claude le e responde.

💡 Bom pra auditoria

Team lead usa isso para lembrar quem levantou uma objecao em reuniao. Dev solo usa para reconstruir razoes de arquitetura.

🧹 Rotatividade e arquivamento

JSONLs ativos ocupam diretorio do Claude. Apos 90 dias, arquivar reduz poluicao mantendo acesso.

📐 Rotacao

ATIVO (ultimos 30 dias):
  ~/.claude/episodes/
    session-YYYY-MM-DD.jsonl

ARQUIVO (31-365 dias):
  ~/.memory/archive/episodes/2026-Q1/
    sessions.tar.gz

COLD (1+ ano):
  S3/Backblaze/drive pessoal
  Raramente acessado, mas preservado

💡 Nunca delete

Custo de storage e trivial. Valor de recuperar decisao antiga e enorme. Arquive, nao delete.

📔 Analogia: seu diario

Voce nao le todo dia. Mas quando precisa recuperar o contexto emocional de uma decisao — 'por que sentimos que tinha que ser assim?' — o diario e o unico lugar.

🎯 Quando buscar episodica

Questoes que so episodica responde:

•'Por que rejeitamos a alternativa Y?'
•'Quais preocupacoes o time X levantou?'
•'Em que contexto essa decisao foi tomada?'
•'Ja tentamos isso antes? Como foi?'

📝 Resumo do Modulo

✓

Preserva o porque — long-term tem a decisao; episodica tem o debate.

✓

JSONL da sessao — Claude Code ja salva — voce so indexa.

✓

Cold storage — nunca carrega em bloco, so quando voce pergunta.

✓

Time-travel — 'por que decidimos X em marco?' vira query.

Proximo:

2.6 — Decay, Promotion e Progressive Disclosure

← Modulo anterior Proximo Modulo →