🧩 The 4 integration strategies
You have the generated vault — now what? How much of this knowledge goes into your main brain? There are four paths, from completely isolated to completely diluted, with a clear trade-off between coherence and reversibility. Here you choose yours.
🧪 Standalone vault (isolated)
The simplest strategy is not to integrate anything: keep the vault generated by Graphify as a separate, dedicated vault of your main vault. It lives on its own — you open it when you need that knowledge and close it when you’re done. That’s the default and the safest of all.
🔰 Reminder: what is a “vault”?
In Obsidian, a vault is just a folder of Markdown files that it treats as a knowledge base. Having two vaults means having two independent folders—opening one doesn’t affect the other. That’s why "standalone" is foolproof: none of the generated content touches what you already had.
↑ The four strategies on a single axis: on the left, you can undo with one click; on the right, the knowledge merges with yours—more valuable, harder to reverse. The standalone is the left endpoint.
🔑 Key concepts
🚧 Quarantine subfolder (deletable)
One step beyond standalone: put everything into a subfolder of your main vault — for example graph-imports/claude-code-docs — which you can delete entirely at any time. The knowledge stays close, in the same context as everything else, but isolatable: if you don't like it, delete the folder and that's it. It's the perfect middle ground.
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
🔰 Why “quarantine”
The idea is to try something new without letting it spread. Since all the files stay under a single root folder, they don't get mixed in with your notes—and reverting takes just one operation: delete the folder. You get the context of your main vault without committing to full integration.
🔑 Key concepts
🌾 Selective import (harvest)
Instead of bringing everything in, you gathers a subset: ask Claude Code to import only the relevant notes — for example, the ~100 that mention subagents — and ignore the rest. It’s curation: the main vault grows only with what you’ll actually use, and the 500 files you’d never consult are left out.
✓ Harvest (curation)
- ✓Only what’s useful goes into the vault.
- ✓Keeps the main vault lean and easy to navigate.
- ✓You choose the topic; the agent filters.
✗ Dump everything
- ✗600 files, most never opened.
- ✗Noise in the graph view and search.
- ✗Hard to find what matters later.
Objective: bring only the notes on one theme into the main vault, leaving the rest outside.
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.
How to verify: open graph-imports/<tema> in Obsidian and count the files—it should be a subset (dozens), not the entire corpus (hundreds). Check that the internal backlinks still work.
🔑 Key concepts
🔀 Redistribution (case by case)
Maximum integration: Claude Code redistributes each note to the vault subfolder that makes the most sense — a note about hooks goes in your automation folder, one about context goes in your fundamentals folder. The knowledge dilutes into your existing structure, as if it had always been there. Total consistency—and the hardest path to undo.
The agent reads each note
Analyzes the subject of each generated file, one by one.
Choose the destination
Matches each note to the vault subfolder that fits it best.
Move and reconnect
Distributes the files and adjusts the wikilinks for the new paths.
⚠️ The cost of redistribution
Once notes are spread across dozens of folders, there's no longer "one folder to delete." Reverting becomes a manual job of hunting down files one by one. It's a conscious tradeoff: you gain maximum coherence and lose the easy way out. Keep the vault versioned (git) or make a manual backup.
🔑 Key concepts
🚚 Move to the main vault (the prompt)
Chose the quarantine? Here's how to do it in practice. Instead of dragging folders one by one in the file explorer, describe what you want and Claude Code will transfer the entire structure for you—in less than a minute, preserving the wikilinks.
Objective: move the generated vault structure into the main one, in a quarantine subfolder.
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.
How to verify: open Obsidian in the main vault, navigate to graph-imports/claude-code-docs and click a backlink — it should open the neighboring note without a “file not found” error.
🔰 Tip: ask in natural language
You don't need to memorize terminal commands. Claude Code understands your request in Portuguese and runs the mv for you. Replace <caminho-do-vault> using your vault’s actual path before pasting.
🔑 Key concepts
🌳 Which one to choose (decision tree)
Four options can make the decision difficult. This tree sorts it out in seconds: answer yes or no and it takes you to the right strategy. The underlying rule is always the same — the more integrated it is, the more coherent and less reversible.
↑ Follow the green (yes) and red (no) arrows. Notice: the first question isn’t even about the vault—if the source was code, the Graphify graph is already enough, and you don’t even export to Obsidian.
| Strategy | What it does | When to use | Revert |
|---|---|---|---|
| 🧪 Standalone | Separate vault that doesn't touch the main one | Only wants it in Obsidian, without mixing things together | Trivial — deletes the vault |
| 🚧 Quarantine | Everything in an isolated subfolder | Integrate safely | Easy — delete the subfolder |
| 🌾 Harvest | Bring in only the notes that are useful | Want curation and a lean vault | Medium—deletes the selection |
| 🔀 Redistribution | Dilutes each note into your structure | Want total consistency | Difficult — scattered |
🔑 Key concepts
✋ Self-recovery (optional, non-blocking): you want to integrate the knowledge into your main vault, but without losing the chance to go back. What is the easier to undo?
📌 Module summary
Next track
You finished Track 2 — from zero to an integrated vault. In the Track 3 · Real-World and Advanced Use you move from “how to build it” to “how to use it every day”: ask the graph questions, build a command center, and keep everything in shape.