The substrate

Status: Candidate — awaiting founder verification. Why this page exists: "Substrate" is the most overloaded word in this product — this is what it actually means.

TL;DR

The substrate is the filesystem layer where the agents live. It is markdown-first, folder-modular, and human-readable. Folder = lobe. File = memory. README = identity. The structure you give the agent is the brain it inhabits.

The deeper read

Most agent frameworks treat memory as an opaque vector database. Apiary inverts that: every memory is a .md file in a folder you can cat and edit. The substrate is the source of truth, the version control surface, and the audit log all at once.

Three things follow from that choice:

1. You can read what the agent knows. Open the folder. The structure is the brain. 2. You can edit what the agent knows. Change the README, change the identity. No retraining. 3. You can fork what the agent knows. Copy the folder, get a new agent with the same brain plus your changes.

This is why Apiary calls it a substrate, not a framework. A framework is something you write code on top of. A substrate is something the agent lives in.

The layout

brain/
├── frontal-cortex/        — planning, decisions, working memory
│   └── README.md          — the lobe's identity
├── temporal-lobe/         — long-term memory, .md persistence
├── hippocampus/           — new-memory formation
├── visual-cortex/         — pattern recognition, screenshots, OCR
├── cerebellum/            — prediction, next-step inference
├── amygdala/              — safety, threat detection, containment
├── basal-ganglia/         — procedural memory, learned habits
└── thalamus/              — input router, dispatches to regions

substrate/
├── committee/             — per-sector reps, proposals, votes
├── cortex-docs/           — the wiki you are reading
└── overlay/               — UI overlays, founder console state

Every folder is real. Every README declares the region's identity. The directory tree is the literal nervous system.

Why markdown-first

Versionable. Git is the audit log. Every committee vote is a commit.
Diff-able. Two agents disagreeing? Show me the diff.
Forkable. Copy a hive, get an agent with the same brain.
LLM-readable. Every model on Earth speaks markdown fluently. No translation layer.
Founder-readable. You can read your agents' minds in plain text.

A vector database is a black box. A folder of markdown is a glass box.

Source quotes