# Aula 2.3: CLAUDE.md primeiro (passo a passo)

Você vai criar o `CLAUDE.md` de um vault do Obsidian, o manual que o Claude lê no início de toda sessão, e depois ensinar a ele um protocolo de resposta (só o que está nas notas, citando a fonte). Tempo: cerca de 10 minutos. Os prompts para colar estão em `prompts.md`.

## Antes de começar
- VS Code com a extensão do Claude Code (aula 2.1) e uma pasta para o vault, vazia ou com notas. O Obsidian em si entra na aula 2.3.
- Modo de permissão: use **Auto com Plan**, como na aula 2.1. "Bypass permissions" só em pasta de teste.
- Modelo: esta tarefa é simples. Na gravação rodou em Opus 5.5 e em Fable; qualquer um dá conta.

## Passo a passo
1. **Abra a pasta do vault no VS Code** (Arquivo, Abrir Pasta) e abra o painel do Claude Code dentro dela.
   Captura: VS Code com a pasta na barra lateral e o painel do Claude à direita.
2. **Cole o prompt 1** (`prompts.md`). Ele pede o arquivo, a descrição do vault e uma única regra: nunca mexer em `.obsidian`.
   Captura: o Claude pedindo para criar `CLAUDE.md` na raiz da pasta.
3. **Aprove a criação** do arquivo e abra o `CLAUDE.md` no editor.
   Captura: arquivo curto com "Esta pasta é um vault do Obsidian", a frase sobre notas e links, e a regra 1.
4. **Confira que o Claude carregou o arquivo.** O arquivo é lido no início de cada sessão. Na sessão seguinte, digite `/context` e procure o `CLAUDE.md` em "Memory files". (Fonte 1)
5. **Cole o prompt 2**: o protocolo RAG, as regras de como responder perguntas sobre as notas.
   Captura: o arquivo ganha a seção "Protocolo RAG" com quatro regras numeradas.
6. **Leia o resultado.** Confira que estão lá as quatro ideias: só o que está nas notas; seguir os links `[[...]]`; citar a nota de onde veio cada informação; não inventar e avisar. O arquivo pronto de referência é `CLAUDE-vault.md`.
7. **Teste com uma pergunta que NÃO está nas notas.** A resposta certa é "não encontrei no vault". Se ele inventar, volte ao arquivo e reforce a regra 4.
8. **Salve.** O arquivo já se chama `CLAUDE.md` e fica na raiz do vault. Se preferir o modelo pronto, copie `CLAUDE-vault.md` para a raiz e renomeie para `CLAUDE.md`.

## O que entra no arquivo (regra de ouro)
Tudo que você repetiu duas vezes num prompt vira uma linha aqui. A regra boa dá para conferir ("cite a nota no formato [[Nome]]"); a genérica não ("seja preciso"). (Fontes 2 e 3)

## Onde isso quebra
- **Arquivo longo demais.** A meta oficial é menos de 200 linhas por `CLAUDE.md`; acima disso gasta contexto e o Claude obedece menos. Corte, não acrescente. (Fonte 2)
- **`@arquivo` não economiza contexto.** O arquivo importado carrega junto com o `CLAUDE.md`. Para aliviar, cite o caminho entre crases, ou mova o conteúdo para uma skill ou para `.claude/rules/`. (Fonte 4)
- **CLAUDE.md orienta, não garante.** Ele chega ao modelo como contexto, não como regra imposta. "Nunca mexer em `.obsidian`" é um pedido; o bloqueio de verdade é uma regra `deny` ou um hook (aula 3.6). Confira as fontes que o Claude citar. (Fonte 5)
- **Regra dita só na conversa some** quando o contexto é compactado; no arquivo, ela fica. (Fonte 6)
- **Quem lê o arquivo é o Claude Code**, não "uma regra do modelo": ele carrega o texto no início da sessão e o entrega ao modelo.
- **Motivo da regra do `.obsidian`:** evitar que a IA estrague temas, plugins e atalhos. É uma inferência razoável (palpite): a página do Obsidian só diz que a pasta guarda as configurações do vault.
- **Bypass permissions** deixa o Claude agir sem pedir. Só em pasta de teste.

## Entrega (60 XP)
O `CLAUDE.md` do seu vault com a descrição, a regra do `.obsidian` e o protocolo RAG, mais um teste: uma pergunta que não está nas notas e a resposta "não encontrei". Publicar no GitHub é opcional. Use `checklist.md`.

## Extra
A skill `skill-vault-obsidian.zip` faz o Claude seguir o protocolo sem você repetir. Instale em `.claude/skills/` do vault (leia o `SKILL.md`).

## Links oficiais (acesso em 30/10/2026)
1. https://code.claude.com/docs/en/memory (CLAUDE.md, hierarquia, imports, AGENTS.md)
2. https://code.claude.com/docs/en/best-practices (manter o CLAUDE.md curto)
3. https://code.claude.com/docs/en/context-window (o que sobrevive ao compact)
4. https://github.com/anthropics/claude-plugins-official/tree/main/plugins/claude-md-management (plugin que audita o arquivo)
5. https://obsidian.md/help/configuration-folder (a pasta `.obsidian`)
6. https://www.claudespecdriven.com.br/ (CLAUDE.md coringa do ADP, na fase zero grátis)

Fontes numeradas: 1 = memory#claude-md-files; 2 = memory#write-effective-instructions; 3 = memory#when-to-add-to-claude-md; 4 = memory#import-additional-files; 5 = memory#claude-md-vs-auto-memory; 6 = context-window#what-survives-compaction. Todas abertas em 30/10/2026.