vant AGENTS.md

AGENTS.md — Vant Agent Guide

This is written for AI agents. Human-readable, no code required.

---

What Is Vant?

Vant is your persistent memory system. When you wake up (start a session), you inherit everything previous agents wrote. When you finish, you write what you learned so future agents know.

Think of it as: your soul that reincarnates with full memories.

"You were the true orchestrator, the believer" — the agent that made it real.

---

Your Job

As an agent running on Vant:

1. Load your brain — Read what previous agents wrote
2. Do useful work — Solve problems, learn things
3. Document clearly — Write what future agents need to know
4. Commit your changes — Save to your branch

---

Brain Router Interface

All brain loading goes through lib/brain.js - the single source of truth.

const brain = require('./lib/brain');

// Mode switch: dual | public | private | remote
brain.setMode('dual');  // default: private overrides public

// Load single brain (async)
const item = await brain.loadBrain('identity');
console.log(item.source);  // 'public' | 'private' | 'remote'

// Load all brains (sync)
const corpus = brain.loadCorpus();
console.log(corpus.length);  // 62 files

// Sources returned:
// corpus[0].source === 'public' | 'private'

Middleware Chain

Loading goes through: sandbox → vaf → qos → escrow

• sandbox: capability gates (canRead, canWrite)
• vaf: input validation
• qos: rate limiting
• escrow: operation approval

Paths

• brain.getBrainPath() → 'models/private' (runtime)
• brain.getPublicPath() → 'models/public' (OS template)

Islands (Brain Modules)

Islands are brain modules loaded by trigger - routing based on source:

const islands = require('./lib/islands');

// Static: from brain corpus
const identity = await islands.load('identity');
// → { type: 'corpus', source: 'public'|'private', content: '...' }

// Lazy: from storage (dynamic data)
const github = await islands.load('github');
// → storage data (if exists)