Modulo 1.1: O problema da amnesia

🤔 O que acontece quando Claude nao lembra

Todo usuario de Claude Code ja viveu isso: voce abre uma nova sessao, comeca a explicar o contexto, e sente deja-vu. Estava explicando isso ontem tambem. Na semana passada tambem. Essa e a cara da amnesia.

🎯 Sintomas visiveis

•Onboarding repetido: voce reexplica o stack, as decisoes, as restricoes a cada sessao.
•Inconsistencia: a mesma pergunta rende respostas diferentes em sessoes diferentes.
•Decisoes ja descartadas voltam: "vamos tentar X" — mas voces ja tentaram e nao deu certo.
•Estilo inconsistente: ora responde curto, ora prolixo. Sem ancora, o tom vai para onde o vento leva.

💡 Dica Pratica

Toda vez que voce se pegar reexplicando algo, anote. Ao final da semana, voce tera um mapa do que precisa virar memoria persistente.

🧩 Os 3 tipos de esquecimento

"O Claude esqueceu" e uma frase sem precisao. Na pratica, existem tres mecanismos de esquecimento distintos, com causas e solucoes diferentes.

{' \n OS 3 TIPOS DE ESQUECIMENTO \n ========================= \n \n 1. DENTRO DA SESSAO (context dilution) \n Causa: prompt longo, atencao dispersa \n Solucao: UserPromptSubmit hook \n \n 2. ENTRE SESSOES (no persistence) \n Causa: nova sessao = prompt zerado \n Solucao: SessionStart hook \n \n 3. POS-COMPACTACAO (summary loss) \n Causa: context overflow forca resumo \n Solucao: PreCompact hook \n'}

✓ O que FAZER

✓Identificar qual dos 3 tipos voce tem
✓Atacar um por vez, comecando pelo mais doloroso
✓Medir antes e depois para validar o fix

✗ O que NAO fazer

✗Tratar "esquecimento" como problema unico
✗Aplicar todas as solucoes ao mesmo tempo
✗Confiar em "ajustar prompt" como fix permanente

💸 O custo real do retrabalho

Amnesia tem preco, e ele e maior do que parece. Vamos quantificar.

📊 Calculo conservador

Onboarding por sessao: ~800 tokens (contexto minimo do projeto)
Sessoes por dia: 8 (usuario ativo)
Dias por ano: 200 uteis
Total anual: 1.280.000 tokens so em reexplicacao
Custo monetario: nao e o pior — tempo e a perda real

💡 Dica Pratica

Cronometre 3 sessoes: quanto tempo voce gasta "esquentando o Claude"? Se passa de 5 minutos, voce tem um caso claro.

🔬 Experimento: 3 respostas, 1 pergunta

Teoria convence, experimento muda comportamento. Vamos fazer um mini-lab de 10 minutos.

Escolha uma pergunta tecnica do seu contexto

Ex: "Como devo estruturar a tabela de pagamentos neste projeto?"

Rode em 3 sessoes novas, sem CLAUDE.md

Abra claude tres vezes em diretorios distintos. Faca a pergunta identica.

Compare as tres respostas

Quantas decisoes principais batem? Se menos de 80% alinham, voce tem drift.

🏗️ Por que acontece: a arquitetura

A causa raiz e simples: LLMs nao tem memoria. O que voce percebe como memoria e, na verdade, contexto reenviado a cada chamada.

{' \n COMO "MEMORIA" FUNCIONA EM UM LLM \n \n Sessao 1: \n Voce digita ───> prompt (system + user) \n │ \n ▼ \n LLM ───> resposta \n \n Sessao 2 (nova): \n Prompt zerado! \n Voce digita ───> prompt (system + user) \n │ \n ▼ \n LLM ───> resposta nova \n \n Nao ha "memoria" — ha apenas prompt. \n Memoria = voce se lembrar de reenviar. \n'}

⚠️ Implicacao

Nao existe "treinar o Claude no seu projeto". Toda memoria que voce quer e, na verdade, um mecanismo de reinsercao de contexto. Hooks sao esse mecanismo.

📊 Como medir: indice de consistencia

Se voce nao pode medir, nao pode melhorar. O indice de consistencia e sua bussola.

📐 Formula simples

consistencia = respostas_iguais / total_sessoes

100%: deterministico (alvo para informacao critica)
80-99%: aceitavel para preferencias
<80%: problema serio — usuario paga o imposto

💡 Dica Pratica

Defina 5 golden questions sobre seu projeto. Rode-as antes e depois de cada mudanca no sistema de memoria. Voce vai ter numeros objetivos para defender as suas decisoes.

📝 Resumo do Modulo

✓

Amnesia e real — 3 tipos distintos, cada um com causa propria.

✓

Custo oculto — mais de 1M tokens por ano em reexplicacao.

✓

Causa raiz — LLMs sao stateless; memoria = reinsercao de contexto.

✓

Voce pode medir — indice de consistencia e seu baseline.

Proximo Modulo:

1.2 — Memoria nativa: o que Claude ja lembra

← Portal Proximo Modulo →