AVDR
Guia do mapa
Como usar
O que é. Três partes: por que a IA esquece e onde a memória passa a morar; as 3 pastas e o que vai em cada uma; o passo a passo com o texto pronto para colar e o modelo de ficha.
Para quem é. Para quem usa ou quer usar o Claude Code. Se você só conversa com a IA pelo navegador, a parte 2 serve para organizar o que você cola na conversa; a leitura automática da pasta é do Claude Code.
Quatro palavras antes.
- Claude Code: o Claude trabalhando direto nos arquivos do seu computador.
- CLAUDE.md: o arquivo de instruções que o Claude Code lê no começo de toda conversa aberta naquela pasta.
- Índice: uma lista curta, uma linha por fato, dizendo onde cada coisa está.
- Ficha: as primeiras linhas de um arquivo, dizendo o que ele é, se ainda vale e quando mudou.
Parte 1. Por que a IA esquece e onde a memória passa a morar
Cada conversa nova com o Claude Code começa do zero. A documentação oficial diz isso com todas as letras: cada sessão começa com o contexto vazio. O que você explicou ontem não está lá.
Dois mecanismos levam conhecimento de uma conversa para a outra, e os dois são arquivos no seu computador:
- O CLAUDE.md, que você escreve. O Claude Code lê o da pasta onde foi aberto, e o das pastas acima dela, no começo de toda conversa.
- A memória automática, que o próprio Claude escreve a partir das suas correções e preferências. Ela tem um índice, e as primeiras 200 linhas (ou 25 KB, o que vier primeiro) entram no começo de toda conversa.
A saída é deixar a memória do seu lado: uma pasta mestre com tudo o que a IA precisa saber do seu negócio, e o Claude Code aberto dentro dela.
Um limite honesto. A documentação avisa que o Claude trata esses arquivos como contexto, e não como regra travada. Quanto mais curto e específico, mais ele segue. Por isso o índice é curto e cada fato mora no próprio arquivo.
Outro detalhe da documentação. O Claude Code apaga as conversas antigas depois de um prazo e mantém os arquivos de memória. A conversa bruta vai embora; o fato passado a limpo fica.
Como é aqui (contado em 15/09/2026, 12h19, horário de Brasília)
- O índice da memória do Claude Code na minha empresa tem 141 linhas, uma por fato, e 13,7 KB. Cabe inteiro no que entra no começo de cada conversa.
- São 144 fatos, cada um num arquivo com ficha. Na hora da contagem, 3 ainda estavam sem linha no índice.
- 26 desses fatos são correções e preferências que eu dei, 103 são de projetos e 15 são referências.
- 99 fatos dizem de qual conversa saíram.
- Todo documento de trabalho segue a mesma regra: ficha no topo com o status, e data na frente do nome quando é foto de um momento.
Libere as partes 2 e 3
Deixe seu e-mail e abra agora as 3 pastas e o que vai em cada uma, o passo a passo com o texto pronto para o CLAUDE.md e o modelo de ficha. Sem spam: só os próximos guias.
Parte 2. As 3 pastas
O erro mais comum é jogar tudo numa pasta só. Anotação solta, regra importante e trabalho pronto misturados viram bagunça para a IA ler, e ela passa a tratar um plano velho como se fosse de hoje. Aqui isso já aconteceu: a IA leu um planejamento de junho e contou como se fosse o estado atual. A ficha com status existe por causa disso.
A estrutura:
cerebro/ CLAUDE.md INDICE.md 1-bruto/ 2-limpo/ 3-pronto/
Pensa numa cozinha com bancada de preparo. O cru fica na bancada, o que já foi limpo vai etiquetado para a geladeira e o prato sai no balcão. Nada útil vai para o lixo, e quem cozinha acha tudo sem abrir todas as portas.
1-bruto: a bancada
O que vai. Anotação do jeito que saiu, transcrição de áudio, texto copiado de e-mail ou de conversa, planilha exportada, ata de reunião, briefing.
Regras.
- Nome com a data na frente, no formato ano-mês-dia:
2026-09-15-reuniao-com-fornecedor.md. A lista se ordena sozinha. - Nunca apague. É para cá que o fato limpo aponta quando alguém pergunta "de onde saiu isso?".
- A IA não precisa ler esta pasta em toda conversa. Ela abre quando você pede para passar a limpo.
2-limpo: a geladeira etiquetada
O que vai. Um fato por arquivo. Exemplos: horário de atendimento, tabela de preços em vigor, como você gosta que uma proposta seja escrita, o que nunca dizer a um cliente, quem decide o quê.
Regras.
- Um assunto, um arquivo. Se o texto fala de dois assuntos, são dois arquivos.
- Ficha no topo (modelo na parte 3).
- Nome sem data quando o fato se atualiza (
tabela-de-precos.md); com data quando é foto de um momento (2026-09-15-decisao-frete.md). - Mudou? Atualize o mesmo arquivo e a data da ficha. Nunca crie um segundo arquivo sobre o mesmo assunto: em duas semanas um dos dois está errado.
- Todo fato ganha uma linha no
INDICE.md.
INDICE.md: a etiqueta da porta
Uma linha por fato: o nome, o caminho do arquivo e o que ele resolve.
- [Tabela de preços](2-limpo/tabela-de-precos.md): valores em vigor desde 01/09 - [Tom das propostas](2-limpo/tom-das-propostas.md): direto, com prazo e valor no primeiro parágrafo
Mantenha curto. A documentação recomenda CLAUDE.md abaixo de 200 linhas, e o índice entra junto com ele. Aqui o índice tem 141.
3-pronto: o balcão
O que vai. O que a IA constrói para você: proposta, texto de post, roteiro, planilha, relatório, resposta padrão.
Regras.
- Nome com a data na frente:
2026-09-15-proposta-parceria.md. - Ficha no topo com um destes três status:
- vivo: vale hoje, pode usar como verdade;
- congelado: retrato daquela data, guardado de propósito, pode estar superado;
- encerrado: já foi usado, é história.
- Antes de reaproveitar um documento antigo, olhe o status.
Cada nota nova melhora a próxima resposta.
Parte 3. Montando, passo a passo
- Crie uma pasta chamada
cerebroonde você guarda os seus arquivos. - Dentro dela, crie as pastas
1-bruto,2-limpoe3-pronto, e dois arquivos de texto vazios:CLAUDE.mdeINDICE.md. - Cole no
CLAUDE.mdo texto do bloco abaixo. - Abra o Claude Code dentro da pasta. No terminal:
cd caminho/da/pasta/cerebro claude
- Confira se ele leu: digite
/contexte procure oCLAUDE.mdna lista de arquivos de memória (Memory files). - Jogue em
1-brutoo que você já tem: anotações, textos, planilhas. - Peça: "Passe a limpo o que está em 1-bruto, seguindo as regras do CLAUDE.md." Leia os fatos que ele criar e corrija o que estiver errado.
- A partir daí, quando corrigir a IA, peça para a correção virar fato em
2-limpo.
Texto para colar no CLAUDE.md
Troque só o nome do negócio, se quiser. A linha @INDICE.md faz o Claude Code carregar o índice junto com as instruções, no começo de toda conversa.
# Memória do meu negócio Esta pasta é a memória do meu negócio. O índice de tudo o que está guardado vem logo abaixo. @INDICE.md ## Como a pasta funciona - 1-bruto: material cru, do jeito que chegou. Só abra quando eu pedir para passar a limpo ou quando um fato limpo apontar para lá. Nunca apague nada aqui. - 2-limpo: um fato por arquivo, com ficha no topo. Antes de responder sobre o meu negócio, procure no índice e abra só os arquivos que o assunto pede. - 3-pronto: tudo o que você entregar para mim, com a data na frente do nome (AAAA-MM-DD) e ficha com status. ## Regras 1. Um assunto, um arquivo. Se o fato já existe, atualize o arquivo e a data da ficha. Não crie outro arquivo sobre o mesmo assunto. 2. Todo fato novo em 2-limpo ganha uma linha no INDICE.md: nome, caminho e o que resolve, numa linha curta. 3. Mantenha o INDICE.md abaixo de 200 linhas. Se passar, junte fatos parecidos e tire os que perderam a validade. 4. Quando eu corrigir você, pergunte se a correção deve virar fato em 2-limpo. 5. Antes de usar um documento como verdade, olhe o status da ficha. Vivo pode usar. Congelado ou encerrado é retrato de uma data e pode estar superado. 6. Se não achar a resposta na pasta, diga que não achou. Não invente. 7. Nunca guarde senha, dado de cartão ou documento pessoal de cliente nesta pasta.
Modelo de ficha: fato (pasta 2-limpo)
--- nome: tabela-de-precos descricao: Valores em vigor e o que entra no frete tipo: fato status: vivo atualizado: 2026-09-15 origem: 1-bruto/2026-09-01-reuniao-precos.md --- Valores em vigor desde 01/09/2026. (Depois da ficha, o fato em si, curto: o que é, desde quando vale e por quê.)
Modelo de ficha: entrega (pasta 3-pronto)
# Proposta de parceria > Ficha · tipo: proposta · status: vivo · atualizado em 15/09/2026 · fontes: 2-limpo/tabela-de-precos.md > Resumo: uma frase dizendo o que este documento resolve.
Uma frase no resumo. Se precisar de duas, são dois documentos. Quem mexe no documento atualiza a data junto.
Opcional: ler as notas como caderno
O Obsidian, um app de anotações, abre essa mesma pasta como um caderno. Aqui a pasta onde o Claude Code guarda a memória está cadastrada nele. Não é obrigatório: tudo é texto simples e abre em qualquer editor.
Onde isso para
- A IA usa as notas como contexto. Pode deixar de seguir uma regra; quando acontecer, corrija e reforce o fato.
- Nota errada gera resposta errada com cara de certa. Leia o que ela passou a limpo.
- Índice que cresce sem limpeza pesa. Tire o que venceu.
- Nada aqui promete resultado. A decisão final continua com você.