Skip to content

Protocol Files

The protocol itself is a small set of markdown files at the repo root. They are written for an AI agent to execute, so they're terse and operational — this page is a map. Each links to the source on GitHub.

Always read

File Role
AGENTS.md The hub. Every vendor's agent reads it first; it routes to everything else. A target's AGENTS.md is the memory hub (from templates/AGENTS.md); the tool's root AGENTS.md is the dual-mode operator dispatcher.
README.md Human-facing quickstart + design philosophy.

Read on demand

File Role
DECAY.md The authoritative decay rules — tiers, windows, what never decays, supersession.
REVIEW.md The review ritual, step by step, with the safe-write Safety section.
MERGE.md The tiered, human-gated memory/ conflict-resolution protocol.
SKILLS.md The skills layer — authoring, syncing, deleting, the adapter recipe.

Operator-only

File Role
ENABLE.md The 10-step enablement flow (Modes A / B / C). Lives in the tool, never installed into a target.
MIGRATE.md Vendor-file detection + promotion for Mode C.
UPGRADE.md The version ladder + per-rung instructions + source-of-truth map.

Per-repo state (generated)

Path Role
memory/continuity.md The live projection — facts, decisions, open threads.
memory/vision.md The north star (core, invariant-verified).
memory/sessions/ Immutable dated session logs — the event ledger.
memory/archive/ Faded facts + a greppable INDEX.md.
memory/decay-policy.md This repo's tunable decay parameters.
.agent/version.md Install manifest — gates in-place upgrades.
.agent/schema.md The file-format reference for the memory layer.

Going deeper

For the why behind these, read the Whitepaper and the design notes under Background in the nav.