🔮 Obsidian, o vault que vira memória

O Obsidian é um aplicativo de notas gratuito. A grande sacada dele não é um formato mágico: ele abre uma pasta de arquivos de texto que já está no seu disco e a apresenta como um caderno conectado. Essa pasta tem um nome próprio — o vault.

Por que isso importa tanto para o nosso caso? Porque um vault não é um arquivo proprietário trancado. É uma pasta de .md — então o Claude Code lê, faz grep e edita tudo do mesmo jeito que você. A memória do agente e o seu caderno passam a ser o mesmo lugar.

Se cada nó do grafo vira um arquivo, faltava uma coisa: como ligar uma nota a outra? A resposta é o wikilink — você escreve o nome de outra nota entre colchetes duplos, e o Obsidian transforma isso num link clicável. É a forma mais simples possível de dizer "isto se conecta àquilo".

# Hooks

Hooks são ganchos que rodam em eventos do agente.

Eles compartilham a [[Context Window]] da sessão e
costumam aparecer perto de [[Subagents]].

## Relações
- usa --> [[Context Window]]
- vizinho-de --> [[Subagents]]

↑ Uma nota de nó típica do vault: texto markdown + wikilinks [[Context Window]]. Cada relação do grafo vira um link clicável — e a nota Context Window ganha um backlink apontando de volta para Hooks.

↑ As setas em ciano são os wikilinks de ida que você escreve; a seta tracejada em verde é o backlink que o Obsidian cria sozinho. É essa via dupla que torna o vault navegável nos dois sentidos.

O Obsidian tem uma tela chamada graph view ("visão de grafo"): uma bolha de pontos e linhas, bonita de ver. É tentador achar que ela é o grafo de conhecimento do Graphify — mas não é. Ela apenas desenha os links entre as notas markdown que existem no vault.

A diferença é fina, mas importa. O grafo de conhecimento real (entidades, relações tipadas, comunidades, god nodes) vive no graph.json que o Graphify gerou. A graph view do Obsidian é uma representação visual desse grafo depois de virar notas — perde os tipos das relações e fica só com "A liga em B".

Aqui está o encaixe que faz o stack inteiro funcionar: markdown é texto puro. Não há camada binária, não há banco proprietário, nenhuma conversão. O mesmo arquivo .md que você lê com prazer no Obsidian é exatamente o que o Claude Code abre, faz grep e edita.

E os wikilinks não atrapalham o agente — ajudam. Quando o Claude Code lê uma nota e encontra [[Context Window]], ele tem o nome exato da próxima nota a abrir. O link é legível por humano e por máquina ao mesmo tempo. Sem lock-in, sem formato secreto: a memória fica num formato que sobrevive a qualquer ferramenta.

Muita gente escolhe esse stack não só pelo markdown, mas pela infraestrutura ao redor: uma interface agradável, busca, temas e centenas de extensões. Dois nomes aparecem o tempo todo — canvas e plugins — e vale saber o que cada um faz.

vault/
├── Context Window.md      ← nota de nó (com [[wikilinks]])
├── Hooks.md
├── Subagents.md
├── graph.canvas           ← comunidades como grupos no Canvas
└── .obsidian/             ← config, temas e plugins do vault

↑ A anatomia de um vault gerado: as notas .md, o graph.canvas com os clusters, e a pasta .obsidian/ onde vivem temas e plugins. Tudo texto, tudo no seu disco.

Agora as duas margens se encontram. De um lado, o graph.json — a fonte de verdade do grafo. Do outro, o vault — a memória que você abre e o agente consulta. O export Obsidian é a ponte: ele lê o graph.json e escreve um arquivo .md por nó, com os wikilinks já no lugar.

Um detalhe que fecha o ciclo: o vault é regenerado a cada export. A fonte de verdade nunca é o markdown — é sempre o graph.json. Se o grafo muda, você reexporta e o vault se atualiza. Por isso a Trilha 1 termina aqui: você já entende as duas margens e a ponte entre elas. A Trilha 2 atravessa essa ponte na prática.

↑ A ponte da Trilha 1 inteira em uma imagem: o graph.json (fonte) atravessa o export e vira um leque de .md — o vault que o Claude Code consulta. Regenerou o grafo? Reexporta, e o vault acompanha.