Course outline
AcademyModule 0 · Orientation
The three layers: workspace, graph, agent
What you'll learn
- You can name the three layers and say which one owns your files, your connections, and your answers.
- You can explain why your markdown files are never altered, and what "rebuildable" means for the graph.
- You can trace one fact from a sentence in a note to a node on the graph and back to its source.
- You can describe what Consilience quietly does in the background while you write.
It's month six. You have hundreds of notes, and a teammate asks: "Wait, what did we decide about pricing, and where did we write it down?" In a plain folder of markdown files, that answer is twenty minutes of searching and skimming. The note is in there somewhere. What's missing is the connection.
Consilience's answer is three layers, each with one job. Your markdown files stay exactly as you wrote them. On top of them, a knowledge graph grows into an index of who connects to what. And an AI agent reads that graph to follow the connections you'd otherwise chase down by hand.
You connected a folder during first launch, so extraction is already building that graph in the background. While it works, here's the picture the rest of the course hangs on.
The three layers at a glance
| Layer | What it holds | Its one rule |
|---|---|---|
| 1 · Markdown workspace | Your notes, as plain, portable files on your own machine | Permanent memory: everything above reads it, nothing ever edits it |
| 2 · Knowledge graph | Entities, relationships, and your verbatim statements, extracted note by note | A rebuildable index: every fact remembers which note asserted it |
| 3 · Agent | The AI that follows graph connections to answer and act | Reasons on top; anything it learns is saved as new, clearly labeled notes |
- Workspace
- Your folder of markdown files. It's the permanent, portable layer that everything else is built from.
- Entity
- A thing your notes mention, like a person, organization, place, project, or idea. It becomes a node in the graph.
- Named graph
- A per-note compartment in the graph store. Each note's extracted facts live in their own compartment, keyed by the note's path.
- Provenance
- Where a fact came from. In Consilience the named graph is the provenance record: it names the note that asserted the fact.
- Agent
- The built-in AI that reads the graph, follows connections to answer questions, and writes its own knowledge as labeled notes.
Layer 1, the workspace: memory that never changes
The bottom layer is the plainest and the most important: a folder of markdown files on your own machine. Everything above is built from these files, and nothing above ever writes back into them. Save a note, rename it, move it. It's still a plain text file any editor can open. If you left Consilience tomorrow, this layer would leave with you, intact.
Layer 2, the graph: a rebuildable index that remembers its source
Every time you save a markdown note, Consilience quietly reads it. The people, projects, places, and ideas it mentions become entities. The typed facts that connect them become relationships. And with "Capture your decisions and questions" on, your own decisions, questions, claims, and quotes are kept word for word as statements. All of it lands in an on-device graph store, never in your files.
The design choice that matters most: each note's facts live in that note's own named graph, keyed by the note's path.
# Each note gets its own compartment, named after the note:
note "strategy/pricing.md" {
(Acme) -acquired-> (Initech)
}
# Re-extract the note -> only this compartment is replaced.
# Delete or rename it -> this compartment is dropped or re-keyed.That per-note compartment makes the graph honest and disposable at once. Honest, because provenance is built in: every fact knows which note asserted it. Hover any connection in the app and you see the exact sentence, in the exact note, that states it.
Disposable, because the whole layer can be regenerated. Settings has a "Rebuild knowledge graph" action that re-extracts every note with the latest logic. And your corrections (type overrides, synonym verdicts, removed connections) live outside the per-note graphs, so a rebuild never erases what you've taught it.
Drag the nodes. Click a community chip to focus it.
Quick check
Settings' "Rebuild knowledge graph" re-extracts every note from scratch. What happens to the type overrides and synonym verdicts you already confirmed?
Layer 3, the agent: reasoning on top
The top layer is the built-in AI. The graph exists for its sake as much as yours. As the app's own empty state puts it, Consilience builds the graph "so the AI can follow those connections to a complete answer." Instead of keyword-matching one note at a time, the agent walks from an entity to its relationships to the notes behind them. Every hop stays backed by the exact source sentence in layer 1.
- It reads through the graph. Entities, relationships, and your verbatim statements (the "In your words" section on entity pages) all become context it can follow, and each one traces back to a source note.
- It builds the graph too. Extraction is the AI reading your notes in the first place. You pick which model runs it in Settings under "Extraction model".
- It learns in the open. Notes the agent saves land under
learned/, indexed like yours but always labeled as agent-authored, never blended into your own writing.
The sleep cycle: tidying while you're away
Think of it the way memory works. Layer 1 is your lived experience. Layer 2 is what your brain does while you sleep: it consolidates the day into associations without touching the memories themselves.
With "Automatic knowledge-graph extraction" on, every save kicks off a quiet background pass over just the note you changed, and untouched notes are left alone. The deeper cleanup waits for one click on "Tune up AI search". And if you've been away six hours or more and something really changed, the graph greets you with a "While you were away" digest.
The life of one fact
You write it (layer 1)
You type "Acme acquired Initech in March" into a note and save. The file is the permanent record. Nothing will ever edit it.
Extraction catches the change (layer 1 → 2)
The moment you save, background extraction notices that just this note changed, re-reads only it, and rewrites its named graph. Acme and Initech become entities, and "acquired" becomes a typed relationship between them.
You can audit it (layer 2)
In the document sidebar, the "Key facts" button opens the "What this note says" dialog: entity cards, relation rows, and this note's local connection graph.
The agent follows it (layer 3)
On the knowledge graph, Acme's card lists the connection. Hover it, and Consilience quotes back the exact sentence from your note. That's layer 3's answer, grounded in layer 1's words.
Quick check
Each note's facts are stored in that note's own named graph, keyed by the note's path. What does this design buy you?
Keep this model in your pocket
Everything later in this course hangs off this picture. When a lesson says "extraction," picture layer 1 building layer 2. When it mentions entity pages, collections, or the topic map, you're looking at layer 2.
When you chat, run research, or review the agent's proposals, you're at layer 3. And every claim it makes should point back to the exact sentence in layer 1.