Modulo 1.2: Memoria nativa | CC Master Memory

📄 CLAUDE.md — o mecanismo default

O CLAUDE.md e o primeiro e mais simples mecanismo de memoria. Um arquivo markdown que Claude Code auto-injeta no comeco da sessao.

🔍 Busca hierarquica

{' Ordem de resolucao (primeiro encontrado vence): \n \n 1. ./CLAUDE.md (projeto atual) \n 2. ../CLAUDE.md (pai) \n 3. ~/.claude/CLAUDE.md (usuario) \n 4. /etc/claude/CLAUDE.md (sistema) \n'}

💡 Dica Pratica

Use CLAUDE.md por projeto para decisoes especificas (stack, convencoes) e ~/.claude/CLAUDE.md para preferencias pessoais (estilo, tom).

🎯 Skills — memoria procedural

Skills sao pacotes de instrucoes carregados sob demanda. A descricao no frontmatter vira trigger; o corpo e o conhecimento.

✓ Quando usar skill

✓Workflow repetivel (revisao, release, deploy)
✓Conhecimento que so importa em contexto especifico
✓Quer pagar tokens so quando o trigger bater

✗ Quando NAO usar

✗Fato que precisa estar sempre no ar (use CLAUDE.md)
✗Dado volumoso dinamico (use MCP)
✗Estado pessoal/identidade (use hook SessionStart)

🔌 MCP servers — memoria externa

Model Context Protocol expoe ferramentas com estado externo. A memoria fica em um serviço (DB, API) e Claude consulta quando precisa.

📊 Padroes de MCP util

Postgres MCP: consulta DB de producao com permissoes read-only
Jira/Linear MCP: lista tickets e historico do time
Filesystem MCP: busca em vault de notas pessoais
Memory MCP: KV store dedicado para memoria cross-session

📋 Plans e Tasks — memoria de sessao

Plan mode e TodoWrite sao o scratchpad estruturado da sessao. Persistem enquanto a conversa vive.

⚡ O que e e o que nao e

E: memoria de trabalho (working memory) dentro da sessao
E: forma de ancorar decisoes ja tomadas no prompt
NAO E: persistente entre sessoes (zera ao abrir uma nova)
NAO E: search index (nao da pra consultar o passado)

🗄️ Session state — estado implicito

Alem do que voce manda explicito, Claude Code herda estado implicito do ambiente: cwd, arquivos lidos, variaveis de ambiente, git state.

{' ESTADO IMPLICITO AUTO-CAPTURADO \n \n ├── cwd (working directory) \n ├── git branch + status \n ├── arquivos abertos durante a sessao \n ├── output do shell \n └── env vars (subset filtrado) \n \n Esse estado NAO viaja entre sessoes. \n'}

🚧 Limites da memoria nativa

A pilha nativa e util, mas tem tres limites fundamentais que hooks vao resolver.

⚠️ Os 3 limites

1. Nao-determinismo: CLAUDE.md pode ser ignorado pelo modelo.
2. Compactacao: conteudo da sessao vira resumo e perde detalhe.
3. Escopo estatico: nao ha injecao dinamica por evento ou contexto.

💡 Dica Pratica

Cada limite tem um hook correspondente na Trilha 4. Memorize: (1) SessionStart, (2) PreCompact, (3) UserPromptSubmit.

📝 Resumo do Modulo

✓

Memoria nativa existe — CLAUDE.md, skills, MCP, plans, session state.

✓

Cada ferramenta tem seu papel — usar a errada custa tokens e reducao de confiabilidade.

✓

Ha 3 limites claros — determinismo, compactacao, escopo dinamico.

Proximo Modulo:

1.3 — Limites do CLAUDE.md: o teste da palavra-codigo

← Modulo anterior Proximo Modulo →