// Canonical document

REALM Framework v2.0

The complete operating framework for companies where humans and AI agents work together as a single crew. A revision of v1.0, written for a crew that has hands.

Download the PDF Read the full text →Web overview →

The PDF has selectable text but is not yet tagged for screen readers. The full text in HTML is the accessible equivalent, and the plain-text Markdown edition is another.

Version
2.0
Published
August 2026
Length
21 pages
License
CC BY-SA 4.0
Format
PDF, 617 KB

01 / Document

What the framework contains

REALM defines the language, roles, written world, autonomy boundaries, goal hierarchy, and operating rhythm of a human-agent company. The written world is the Codex. It is not memory for the crew, it is your position of record. It is technology-agnostic: it sits above the agent platform and the knowledge base you already use. It asks for one board, and that board is a file in the Codex. A project tool can show it. It cannot hold a second copy.

The PDF is the stable versioned document. The website and Markdown edition provide more accessible routes to its core concepts, plus examples, videos, field notes, and reference material around it.

  1. 01The world

    Player, Oath, Destiny, Zones, Characters, Operating Modes, and where the framework does not fit.

  2. 02The five Classes

    Warrior, Mage, Hunter, Cleric, and Bard, the shape of the output each one produces, and the Character File.

  3. 03The Codex

    Why it is a position of record and not memory, the root structure, DECISIONS/, and the two questions about tooling.

  4. 04Goals, autonomy and rhythm

    Oath to Task, the three boundaries for Character freedom, what enters the Realm from outside, Sessions, Energy, the Scroll, Save Points, and the Quest Board.

  5. 05Growth

    The radial organigram, Patches, Guilds, and multiplayer.

02 / Release

Version history

Version 2.0

A revision, not a replacement. Agents stopped being narrow and passive, so every rule that described a limit of the machine was re-examined. Classes became the shape of the work rather than a fence around an agent, Autonomy Tiers were re-cut on reversibility, decisions got their own home in the Codex, and the Character Card and SOUL file merged into one Character File.

Version 1.0

Initial public release. Still available at realm-framework-v1.pdf for anyone who cited it.