Três jeitos de montar um segundo cérebro — escolha por quem consegue ler

Existe um teste de trinta segundos que encerra a discussão sobre "qual app de anotações usar". Abra uma sessão nova do seu agente — histórico zerado, nada anexado — e peça algo que só dá pra responder cruzando três anotações suas. Se você precisou subir um único arquivo pra isso funcionar, você ainda não tem um segundo cérebro. Você tem uma pasta e o hábito de se explicar de novo toda vez.

Esse teste muda a pergunta. Nos três formatos mais comuns as funcionalidades são quase iguais: entra texto, o assistente devolve. O que muda de verdade é onde os bytes ficam e quais agentes chegam neles sem depender de você. Isso é uma questão de portabilidade, não de recurso — e é a única parte que vale discutir.

As três arquiteturas, numa tela

1. Conhecimento hospedado — um Projeto no Claude. Você cria o projeto, anexa os arquivos no conhecimento dele, escreve as instruções fixas e toda conversa ali já começa carregada. É o caminho mais rápido pra ter algo útil hoje, e a maior parte da qualidade vem da caixa de instruções — diga qual arquivo consultar antes de responder e a saída melhora na hora. Dois limites que valem saber antes de casar com essa opção: o plano gratuito para em 5 projetos, e a busca dentro do conhecimento (RAG) só existe nos planos pagos. Quando o conhecimento do projeto começa a encostar no limite de contexto, a central de ajuda da Anthropic diz que o Claude ativa o RAG mode "pra expandir a capacidade em até 10x" — ou seja, passado um certo tamanho o modelo recebe trechos que ele mesmo selecionou, não a sua biblioteca inteira. Melhor para: quem quer isso rodando em quinze minutos, ou quem tem um recorte só (um cliente, uma busca de emprego) em vez de tudo junto.

2. Markdown local — um cofre do Obsidian. A documentação do Obsidian é direta sobre o que um vault é de fato: uma pasta no seu sistema de arquivos local onde o Obsidian guarda as suas notas, e ele as guarda como arquivos de texto puro em Markdown. Nada proprietário acontece com o texto — o único artefato do próprio Obsidian é a pasta .obsidian, criada na raiz do cofre pra guardar atalhos, temas e plugins daquele cofre. Como as notas são texto puro, outros editores e gerenciadores de arquivos abrem e editam tudo — e é exatamente por isso que apontar um agente de programação pra mesma pasta simplesmente funciona. Melhor para: quem já escreve notas todo dia e quer backlinks, busca e uma interface de verdade em cima. O problema que ninguém comenta: as notas são portáteis, mas a máquina não. Um notebook só, sem histórico, e uma galeria de plugins grande o bastante pra virar o projeto no lugar das notas.

3. Um repositório git de Markdown — ~/brain. Os mesmos arquivos de texto, sem o app, com controle de versão. Qualquer agente que leia arquivos entra direto. No Claude Code você anexa a pasta com claude --add-dir ~/brain — a referência da linha de comando descreve a flag como acrescentar diretórios de trabalho extras pro Claude ler e editar arquivos — e você torna isso permanente configurando permissions.additionalDirectories nos settings, em vez de digitar de novo a cada sessão. Em clientes de desktop, o servidor MCP de sistema de arquivos faz o mesmo papel: os diretórios que ele pode tocar são literalmente os últimos argumentos da configuração, e o próprio guia de servidores locais é honesto sobre o preço — o servidor roda com as permissões da sua conta de usuário, então ele consegue fazer com os arquivos qualquer coisa que você faria na mão. Melhor para: devs e EMs que já vivem no git e querem o mesmo cérebro no notebook pessoal, na máquina do trabalho e no CI.

As opções 2 e 3 não são rivais, e essa é a sacada: um cofre é uma pasta, então ele pode ser um repositório git. Rode git init dentro dele e você juntou as duas. Quando você percebe isso, o eixo real tem duas posições, não três — conhecimento que você sobe pra um fornecedor e conhecimento que mora num diretório seu.

A estrutura que eu copiaria

Cinco pastas, e a primeira trabalha mais que as outras quatro:

brain/
├── README.md          # o índice: uma linha por pasta, pro agente saber onde procurar
├── me/
│   ├── context.md     # quem eu sou, o que estou perseguindo este ano, como falar comigo
│   └── career.md      # escopo, evidências, dados de salário, as histórias que eu repito
├── projects/          # um arquivo por coisa viva, com o nome da coisa
├── decisions/         # entradas com data: o que escolhi, o que descartei, por quê
└── reference/         # o que eu não escrevi — transcrições, docs, threads salvas

Nomes em minúsculo com hífen, um assunto por arquivo, tudo .md. Aí escreva o único arquivo que importa no primeiro dia:

# Contexto

- Cargo e escopo: do que eu respondo, tamanho do time, o que eu realmente decido.
- Este ano: os 2–3 resultados pelos quais eu sou avaliado, com números.
- Como eu trabalho: minhas ferramentas, minha semana, o que eu delego.
- Como falar comigo: direto, sem enrolação, me contrarie quando eu estiver errado.
- Pare de me perguntar isso: o contexto que eu estou cansado de digitar nos chats.

Ligue o ditado por voz, fale por dois minutos e peça pro agente organizar isso no arquivo. Dois minutos falando rendem mais aqui do que uma hora encarando o editor vazio.

A pegadinha que custa uma semana em silêncio

O --add-dir libera acesso a arquivos, não configuração. A documentação avisa: a maior parte da configuração em .claude/ não é descoberta nesses diretórios extras. Ou seja, aquelas instruções que você deixou com todo o cuidado dentro de ~/brain sobre como usar ~/brain podem nunca ser carregadas. Coloque essa linha de roteamento no projeto de onde você realmente abre a sessão, ou comece a conversa com ela:

Leia ~/brain/README.md e ~/brain/me/context.md antes de responder qualquer coisa.

Por que career.md é o arquivo que se paga

Se você é dev ou EM no Brasil atrás de vagas remotas nos Estados Unidos ou na Europa, você conta as mesmas seis histórias em dezenas de processos — escopo, impacto, por que saiu, expectativa de salário numa moeda que não é a sua. Escrito uma vez, com números reais, esse arquivo transforma cada candidatura de exercício de memória em trabalho de redação. O meu guarda evidência de promoção que eu teria que remontar garimpando o Slack um ano depois.

Faça isso hoje

Crie a pasta, escreva o me/context.md, rode git init e suba como repositório privado. Depois aplique o teste de partida a frio: claude --add-dir ~/brain numa sessão nova e pergunte aquilo que você sempre precisa contextualizar antes — "com base no que tem nessa pasta, no que eu deveria focar na semana que vem?". A resposta diz se você montou um segundo cérebro ou só mais um container vazio. Os três formatos falham pelo mesmo motivo, e nunca é culpa da ferramenta: a pessoa termina a estrutura e nunca coloca nada de verdade dentro.

Fontes

• Claude Help Center — What are Projects?
• Obsidian Help — Vaults
• Obsidian Help — How Obsidian stores data
• Claude Code docs — CLI reference
• Model Context Protocol — Connect to local MCP servers