💬 Perguntar ao Claude Code usando o grafo

O Claude Code só usa o que enxerga. Se o seu segundo cérebro — o vault gerado pelo Graphify — está num canto do disco que ele nunca olha, é como se não existisse. O primeiro passo, sempre, é deixar o vault dentro (ou ao lado) do projeto e dizer ao agente onde ele está, logo no começo da sessão.

Não basta o vault estar no disco: o agente precisa ser direcionado a ele antes de começar a varrer o repositório. A forma mais barata é uma frase de abertura que estabelece o vault como fonte primária. O bloco abaixo é um prompt pronto pra colar.

O segundo cérebro deste projeto está em graph-imports/<nome-do-grafo>/ .
Lá tem um .md por conceito (com backlinks [[...]]) e o GRAPH_REPORT.md
com os god nodes. Use ESSE vault como fonte primária antes de varrer o repo.

Onde começar uma pergunta? Pelos god nodes — as entidades mais conectadas do grafo, listadas no GRAPH_REPORT.md. Eles são os hubs: entrar por um deles puxa o resto do mapa junto, porque quase tudo passa por ali. Começar por um nó periférico é entrar pela porta dos fundos.

Entrou por um god node — e agora? O pulo do gato é deixar o agente seguir os backlinks: os [[links]] que cada nota carrega pros conceitos vizinhos. Em vez de parar no primeiro nó, ele anda pela vizinhança e monta uma resposta conectada, não isolada.

É exatamente o que o vault foi feito pra permitir: cada .md aponta pros vizinhos, então o agente navega o sentido — não posições de texto soltas. Visualmente, o caminho é este:

↑ A pergunta entra pelo god node em destaque; daí o agente segue os backlinks até os vizinhos (ciano) e devolve uma resposta que liga os conceitos — não um parágrafo solto.

Tudo isso vira hábito com um prompt bem montado. A diferença entre "explica X" e um prompt que direciona ao grafo é enorme: o segundo manda o agente entrar pelo hub, seguir backlinks, citar as notas e ficar dentro do escopo do vault. O bloco abaixo é o copy-run principal deste módulo.

Use o vault em graph-imports/<nome-do-grafo>/ para explicar <tema>.
Comece pelo god node mais ligado a ele, siga os backlinks [[...]] até os
conceitos vizinhos e cite cada nota .md que usar. Não varra o resto do repo.

Ler arquivos markdown funciona — mas o Graphify também consegue servir o grafo como tools programáticas, via MCP. Aí o agente consulta o grafo de forma exata (vizinhos de um nó, caminho mais curto) em vez de depender só do texto. É opcional, mas poderoso pra grafos grandes.

# dentro do Claude Code (skill form):
/graphify . --mcp

# ou via terminal puro:
graphify --mcp

# tools expostas: query_graph · get_node · get_neighbors · shortest_path

Confiar, mas conferir. O grafo guarda a procedência de cada nó — o arquivo-fonte de onde a entidade saiu — dentro do graph.json. Quando o agente afirma algo, você fecha o ciclo indo do conceito até o doc-fonte original e checando se bate. É a melhor defesa contra alucinação.

↑ O conceito afirmado leva, pela procedência do graph.json, até o doc-fonte original — onde você confere. Os docs-fonte não vão pro vault: ficam no projeto.