🧩 As 4 estratégias de integração
Você tem o vault gerado — e agora? Quanto desse conhecimento entra no seu cérebro principal? São quatro caminhos, do totalmente isolado ao totalmente diluído, com um trade-off claro entre coerência e reversibilidade. Aqui você decide o seu.
🧪 Vault standalone (isolado)
A estratégia mais simples é não integrar nada: mantenha o vault gerado pelo Graphify como um vault próprio e separado do seu vault principal. Ele vive sozinho — você abre quando precisa daquele conhecimento e fecha quando termina. É o comportamento padrão e o mais seguro de todos.
🔰 Lembrete: o que é um "vault"
No Obsidian, um vault é só uma pasta de arquivos markdown que ele trata como uma base de conhecimento. Ter dois vaults é ter duas pastas independentes — abrir um não mexe no outro. Por isso "standalone" é à prova de erro: nada do gerado toca o que você já tinha.
↑ As quatro estratégias num eixo só: à esquerda você desfaz com um clique; à direita o conhecimento se funde ao seu — mais valioso, mais difícil de reverter. O standalone é a ponta esquerda.
🔑 Conceitos-chave
🚧 Subpasta-quarentena (deletável)
Um passo a mais que o standalone: jogue tudo numa subpasta do seu vault principal — por exemplo graph-imports/claude-code-docs — que você pode apagar inteira a qualquer momento. O conhecimento fica perto, no mesmo contexto que o resto, mas isolável: se não gostar, deleta a pasta e acabou. É o meio-termo perfeito.
meu-vault/
├── Projetos/
├── Diário/
└── graph-imports/ ← a quarentena
└── claude-code-docs/ ← apague esta pasta e nada mais é afetado
├── Hooks.md
├── Subagents.md
└── Context-Window.md
🔰 Por que "quarentena"
A ideia vem de testar algo novo sem deixá-lo se espalhar. Como os arquivos ficam todos sob uma única pasta-raiz, eles não se misturam às suas notas — e a reversão é uma operação só: apagar a pasta. Você ganha o contexto do vault principal sem o compromisso da integração total.
🔑 Conceitos-chave
🌾 Importação seletiva (harvest)
Em vez de trazer tudo, você colhe um recorte: peça ao Claude Code para importar só as notas relevantes — por exemplo as ~100 que falam de subagents — e ignorar o resto. É curadoria: o vault principal cresce só com o que você realmente vai usar, e os 500 arquivos que nunca consultaria ficam de fora.
✓ Harvest (curadoria)
- ✓Só o que serve entra no vault.
- ✓Mantém o principal enxuto e navegável.
- ✓Você decide o tema; o agente filtra.
✗ Despejar tudo
- ✗600 arquivos, a maioria nunca aberta.
- ✗Ruído na graph view e na busca.
- ✗Difícil achar o que importa depois.
Objetivo: trazer para o vault principal apenas as notas de um tema, deixando o resto fora.
No vault gerado em ~/vault/graphify/claude-code, traga apenas as notas relacionadas a <tema> (ex.: subagents) para a subpasta graph-imports/<tema> do meu vault principal em <caminho-do-vault> e ignore o resto. Preserve os wikilinks entre as notas que vieram. Liste o que trouxe e o que ficou de fora.
Como verificar: abra graph-imports/<tema> no Obsidian e conte os arquivos — deve ser o recorte (dezenas), não o corpus inteiro (centenas). Confira que os backlinks internos ainda funcionam.
🔑 Conceitos-chave
🔀 Redistribuição (case a case)
A integração máxima: o Claude Code redistribui cada nota para a subpasta do seu vault que faz mais sentido — uma nota de hooks vai pra sua pasta de automação, uma de contexto vai pra de fundamentos. O conhecimento se dilui na sua estrutura existente, como se sempre tivesse estado lá. Coerência total — e o caminho mais difícil de desfazer.
O agente lê cada nota
Analisa o assunto de cada arquivo gerado, um por um.
Decide o destino
Casa cada nota com a subpasta do seu vault que melhor combina.
Move e religa
Distribui os arquivos e ajusta os wikilinks para os novos caminhos.
⚠️ O custo da redistribuição
Depois que as notas se espalham por dezenas de pastas, não há mais "uma pasta para apagar". Reverter vira um trabalho manual de caçar arquivo por arquivo. É uma troca consciente: você ganha coerência máxima e perde a saída fácil. Faça com o vault versionado (git) ou um backup à mão.
🔑 Conceitos-chave
🚚 Mover pro vault principal (o prompt)
Escolheu a quarentena? Aqui está a execução prática. Em vez de arrastar pasta a pasta no explorador de arquivos, você descreve o que quer e o Claude Code transfere a estrutura inteira por você — em menos de um minuto, preservando os wikilinks.
Objetivo: mover a estrutura do vault gerado para dentro do principal, numa subpasta de quarentena.
Mova a estrutura do vault em ~/vault/graphify/claude-code para dentro do meu vault principal em <caminho-do-vault>, numa subpasta graph-imports/claude-code-docs. Preserve os wikilinks [[...]] e não sobrescreva nada que já exista lá. Ao terminar, liste o que foi movido e avise se algum link quebrou.
Como verificar: abra o Obsidian no vault principal, navegue até graph-imports/claude-code-docs e clique num backlink — ele deve abrir a nota vizinha sem erro de "arquivo não encontrado".
🔰 Dica: peça em linguagem natural
Você não precisa decorar comandos de terminal. O Claude Code entende o pedido em português e executa os mv por você. Troque <caminho-do-vault> pelo caminho real do seu vault antes de colar.
🔑 Conceitos-chave
🌳 Qual escolher (árvore de decisão)
Quatro opções podem travar a decisão. Esta árvore resolve em segundos: responda sim/não e ela te leva à estratégia certa. A regra de fundo é sempre a mesma — quanto mais integrado, mais coerente e menos reversível.
↑ Siga as setas verdes (sim) e vermelhas (não). Repare: a primeira pergunta nem é sobre o vault — se a fonte era código, o grafo do Graphify já basta e você nem exporta pro Obsidian.
| Estratégia | O que faz | Quando usar | Reverter |
|---|---|---|---|
| 🧪 Standalone | Vault à parte, não toca o principal | Só quer no Obsidian, sem misturar | Trivial — apaga o vault |
| 🚧 Quarentena | Tudo numa subpasta isolável | Integrar com segurança | Fácil — apaga a subpasta |
| 🌾 Harvest | Traz só as notas que servem | Quer curadoria, vault enxuto | Médio — apaga o recorte |
| 🔀 Redistribuição | Dilui cada nota na sua estrutura | Quer coerência total | Difícil — espalhado |
🔑 Conceitos-chave
✋ Auto-recuperação (opcional, não bloqueia): você quer integrar o conhecimento ao vault principal, mas sem perder a chance de voltar atrás. Qual estratégia é a mais fácil de desfazer?
📌 Resumo do módulo
Próxima trilha
Você terminou a Trilha 2 — do zero ao vault integrado. Na Trilha 3 · Uso real e avançado você sai do "como montar" para o "como usar todo dia": perguntar ao grafo, montar um command center e manter tudo em forma.