MODULO 1.6

🩺 Diagnostico: que memoria voce precisa

Checklist + 4 perguntas-chave que apontam sua arquitetura de memoria. Ponte para Trilha 2.

6
Topicos
30
Minutos
Basico
Nivel
Ferram.
Tipo
1

πŸ“‹ Checklist de sintomas

Responda sim/nao. Cada "sim" vale 1 ponto. 3+ pontos = voce precisa de hooks.

πŸ“ 10 perguntas

  1. Voce reexplicou o stack pelo menos 3x nesta semana?
  2. Uma mesma pergunta rendeu respostas diferentes em sessoes diferentes?
  3. Claude ja sugeriu abordagem que voces ja descartaram?
  4. Voce tem multiplos projetos ativos e ja viu Claude misturar contextos?
  5. Suas sessoes passam frequentemente de 1h?
  6. Ja viu Claude "esquecer" uma decisao depois de compactacao?
  7. Voce tem regras de compliance/seguranca que Claude as vezes ignora?
  8. Voce reabre o mesmo projeto em sessoes diferentes em dias distintos?
  9. Seu stack tem particularidades que nao batem com o default do modelo?
  10. Voce ja desistiu de usar Claude para uma tarefa por medo de esquecimento?
2

πŸ”„ Pergunta 1: persistencia entre sessoes?

Se suas sessoes sao isoladas e auto-contidas, nao. Se voce volta em projetos em andamento, sim.

Define

Se voce precisa de SessionStart hook ou apenas CLAUDE.md.

3

🧱 Pergunta 2: sobreviver a compactacao?

Sessoes longas (>1h, >100k tokens) vao passar por compactacao. Voce quer perder contexto critico? Se nao, precisa de PreCompact hook.

4

πŸ—‚οΈ Pergunta 3: isolamento por projeto?

Se voce tem mais de 3 projetos ativos e ja viu mistura de contextos, precisa de memoria por cwd/branch (Trilha 6).

5

πŸ” Pergunta 4: semantica ou keyword?

Como voce pensa nas memorias? Por conceito ("a decisao sobre pagamentos") ou por termo exato ("pgvector")?

Keyword basta

Markdown + grep. Simples, rapido, zero dependencia.

Precisa semantica

SQLite + sqlite-vec ou ChromaDB. Trilha 5 cobre.

6

πŸ—ΊοΈ Proximo passo: sua arquitetura

Com 4 respostas voce tem a receita inicial:

🎯 Sua receita

  • P1 sim β†’ SessionStart hook + prime.md
  • P2 sim β†’ PreCompact hook + context.md
  • P3 sim β†’ memoria scoped (Trilha 6)
  • P4 semantica β†’ SQLite/vetor (Trilha 5)
  • P4 keyword β†’ markdown + grep (Trilha 5)

πŸŽ‰ Trilha 1 completa

Agora voce sabe por que a memoria quebra, como medir e que arquitetura voce precisa. Hora de entrar nas camadas β€” Trilha 2.

πŸ“ Resumo do Modulo

βœ“
Checklist de 10 sintomas β€” 3+ sinais = caso claro de hooks.
βœ“
4 perguntas mapeiam a arquitetura β€” persistencia, compactacao, isolamento, busca.
βœ“
Receita inicial pronta β€” voce sai daqui com um esboco para implementar nas trilhas seguintes.

Proxima Trilha:

Trilha 2 β€” Os 7 niveis de memoria (modelo mental em camadas)