Modulo 2.3: Memoria de Trabalho

🧩 O que cabe em working memory

Working memory e a mesa bagunçada do trabalho em andamento. Tudo que voce tentou, hipoteses em teste, arquivos tocados, logs temporarios.

📦 Conteudo tipico

O que cabe aqui durante uma sessao de debug:

•Hipoteses em teste ('talvez seja X...')
•Resultados de experimentos ('X deu erro Y')
•Arquivos lidos/modificados na sessao
•Notas de investigacao ainda sem conclusao
•Output de comandos relevante

⏰ Ciclo de vida: ativo → comprime → some

Working memory tem lifecycle definido. Durante a sessao: expande. No SessionEnd: comprime. 30 dias depois: some.

📐 Lifecycle

TEMPO           ESTADO                    TAMANHO
─────────────────────────────────────────────
Durante sessao  Scratchpad ativo          1-2k tokens
SessionEnd      Resumo de decisoes        ~200 tokens
Dia 7           Entrada em long-term      50-100 tokens
Dia 30          Arquivado ou deletado     0 tokens

💡 Decisao vs hipotese

So DECISOES migram para long-term. Hipoteses que nao viraram decisoes morrem. E essa curadoria que faz memoria escalar.

📦 Onde guardar fisicamente

Tres opcoes de storage, escolha pela fricção:

Plans + TodoWrite (nativo)

Usar diretamente o plan mode e TodoWrite. Vive na sessao, some ao fechar. Zero setup.

session-scratch.md (arquivo)

Arquivo temporario em /tmp/claude-session-X.md. Dura enquanto a sessao. Util se quer inspecionar.

Working memory persistente (raro)

Arquivo em ~/.memory/working/. So faz sentido se voce faz pausa na sessao e volta no mesmo tema.

🧭 Sinal vs ruido

A curadoria de working memory define se ela gera long-term rico ou lixo.

✓ Sinal (vai para long-term)

✓Decisao tomada e implementada
✓Erro debugado com root cause claro
✓Padrao que apareceu 2+ vezes
✓Constraint nova descoberta

✗ Ruido (morre no SessionEnd)

✗Hipotese testada e descartada
✗Erro que ja foi corrigido
✗Tentativa unica sem resultado
✗Log temporario sem conclusao

🗜️ Compressao no SessionEnd

O SessionEnd hook e onde working memory gera valor permanente. Script analisa o scratch, extrai decisoes, grava em long-term.

📐 Fluxo de compressao

[working memory cheio]
         │
         ▼ (SessionEnd dispara)
[script le scratch + transcript]
         │
         ▼
[LLM (Gemini) extrai decisoes]
         │
         ▼
[grava em long-term/sessions/2026-04-23.md]
         │
         ▼
[scratch original deletado]

💡 Custo baixo

Usar Gemini Flash para esse resumo custa < $0.001 por sessao. Sintese continua e praticamente gratis. Trilha 6 mostra.

🗑️ Analogia: mesa bagunçada

Mesa no meio do trabalho: papeis por toda parte, copos vazios, tres abas abertas. Bagunça produtiva. No fim do dia: limpa e arquiva o que importa.

🎯 Teste da bagunça

Working memory esta saudavel quando:

•Voce nao se importa com a bagunça durante a sessao
•No fim, voce consegue extrair 1-3 decisoes valiosas
•O scratch zera ao fechar sem voce sentir perda
•Decisoes importantes viraram entries em long-term

📝 Resumo do Modulo

✓

Working memory e transiente — bagunça legitima, serve pra sessao atual.

✓

Plans + TodoWrite — sao a working memory nativa do Claude Code.

✓

Sessao acabou, decisao viaja — hipoteses morrem, decisoes vao para long-term.

✓

SessionEnd comprime — transforma ruido em sinal arquivado.

Proximo:

2.4 — Conhecimento Longo Prazo (pesquisado)

← Modulo anterior Proximo Modulo →