Skip to content

A series · One invented business

The vault and the graph

An Obsidian vault is a folder of Markdown notes. This series shows, from the simplest case to the hardest, how that folder becomes the memory of an agent graph, using one invented business whose vault grows a chapter at a time. Chapter 6 opened ahead of chapters 4 and 5, which are not written yet.

One invented business

Whitlock & Marsh Grounds is a two-person landscaping company in the invented town of Fenwick Ridge. Dana Whitlock visits, designs and plants; Eli Marsh runs the mowing crew, irrigation repair and hauling. They are not real, and neither is anything in their vault. I invented them so every chapter can show the same notes growing instead of a new toy example each time.

The idea

Obsidian describes a vault as a folder on your local file system where it stores your notes, and says it stores them as Markdown-formatted plain text files.

My viewMy argument is that this is exactly the shape an agent graph’s memory node needs: plain files that people already write, linked to each other, that an agent can read before it acts. The series tests that one chapter at a time, and says where it stops being true.

My viewA vault is the memory. Everything else that sits around a model is in the Harness series.

The chapters

4 open, 4 coming.

Writing and structure

In the graph, and at scale

What this series is not

  • A tour of Obsidian. It covers only what an agent needs from a vault, and every fact about the app cites its official help.
  • A product pitch. No plugin, service or tool is recommended, and nothing here is for sale.
  • A real business. Every name, town and note is invented, and no real client or vault is behind them.
  • A model benchmark. The agent’s answers in the figures are scripted to show the shape of the idea; no model is called.

Sources

  1. Obsidian Help Create a vault. Official help; read 2026-10-30.

    What a vault is.

    • The definition of a vault
  2. Obsidian Help How Obsidian stores data. Official help; read 2026-10-30.

    Notes as Markdown plain text files, and the configuration folder in the vault root.

    • Notes stored as Markdown-formatted plain text files in a vault

Each fact about Obsidian or Claude Code is paraphrased from the page named, read on the date shown. Where a sentence is my own reading, it is marked “My view”. The business, its people and its notes are invented.