Concepts
Context Nest is built on a small set of composable concepts. Understanding these gives you the full picture of how vaults work.
Architecture
┌────────────────────────────────────────────────────────┐
│ Context Nest Vault │
│ │
│ ┌──────────┐ ┌──────────┐ ┌──────────────────────┐ │
│ │ Nodes │ │ Sources │ │ Packs │ │
│ │ (docs, │ │ (live │ │ (curated bundles │ │
│ │ refs, │ │ data │ │ with agent │ │
│ │ etc.) │ │ feeds) │ │ instructions) │ │
│ └────┬─────┘ └────┬─────┘ └──────────┬───────────┘ │
│ │ │ │ │
│ └──────────────┼───────────────────┘ │
│ │ │
│ ┌───────▼────────┐ │
│ │ Selectors │ │
│ │ tag, type, │ │
│ │ pack, status │ │
│ └───────┬────────┘ │
│ │ │
│ ┌───────▼────────┐ │
│ │ Resolver │ │
│ │ Evaluates │ │
│ │ queries, │ │
│ │ returns docs │ │
│ └───────┬────────┘ │
│ │ │
│ ┌───────▼────────┐ │
│ │ Versioning │ │
│ │ Hash chains, │ │
│ │ checkpoints │ │
│ └────────────────┘ │
└────────────────────────────────────────────────────────┘Key Concepts
| Concept | What it is |
|---|---|
| Vault Structure | How files and directories are organized |
| Node Types | The 8 types of documents a vault can contain |
| Frontmatter | YAML metadata that governs every document |
| Context Index | context.yaml — the machine-readable vault manifest |
| Selectors | Composable query grammar for filtering documents |
| Context Packs | Curated bundles of documents with agent instructions |
| Addressing | contextnest:// URI scheme for cross-referencing |
| Source Nodes | Documents that instruct agents to fetch live data |
| Versioning | Hash chains, keyframes, diffs, and checkpoints |
Last updated on