MODULO 1.1

🌀 O problema da amnesia do Claude

Antes de aprender a consertar, vamos entender exatamente o que quebra. Tres tipos de esquecimento, por que acontecem e como medir.

6
Topicos
30
Minutos
Basico
Nivel
Teoria
Tipo
1

🤔 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.

2

🧩 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
3

💸 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.

4

🔬 Experimento: 3 respostas, 1 pergunta

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

1

Escolha uma pergunta tecnica do seu contexto

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

2

Rode em 3 sessoes novas, sem CLAUDE.md

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

3

Compare as tres respostas

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

5

🏗️ 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.

6

📊 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

← Voltar para Trilha Proximo Modulo →