The Operating Framework for Human-Agent Companies
This repository contains the starter Codex for the REALM Framework — a ready-to-use folder structure, all five Class Sheets, and templates for every file you need to build and run a Realm.
Fork it, clone it, and start building your world.
REALM is an operating framework for companies where humans and AI agents work together as a single crew. It defines who does what, how knowledge flows, and where the human stays in control.
The metaphor is a game world — Characters with defined abilities, a Codex that holds all knowledge, Quests that drive work forward, and a Player who makes the decisions that matter.
→ Read the full framework → Download the PDF → See it in practice
This is the Codex — the knowledge base structure that every Character reads from and writes to.
REALM-Codex/
├── WORLD/
│ ├── OATH.md ← Why your company exists
│ ├── DESTINY.md ← Where your company is going
│ └── Your-Zone-1/ ← One folder per business domain
│ ├── Zone-Overview.md
│ ├── Knowledge/
│ ├── Outputs/
│
├── PLAYERS/
│ └── Player-Card-Template.md ← One file per human Player
│
├── CHARACTERS/
│ ├── Class-Sheets/ ← The 5 Class definitions (included)
│ │ ├── Warrior.md
│ │ ├── Mage.md
│ │ ├── Hunter.md
│ │ ├── Cleric.md
│ │ └── Bard.md
│ ├── Character-Files/ ← One file per Character: the agreement
│ │ └── Character-File-Template.md
│ ├── Roster.md ← Who exists, and where each agreement lives
│ └── Portraits/ ← Optional character images
│
├── SAGAS/
│ ├── Active/
│ │ └── Your-First-Saga/
│ │ ├── Saga-Overview.md
│ │ └── Quest-Template.md
│ └── Completed/
│
├── SESSIONS/
│ ├── Season-Reviews/
│ ├── Raids/
│ └── Patches/
│
├── INTELLIGENCE/
│ ├── Competitors/
│ ├── Market-Trends/
│ └── Opportunities/
│
├── DECISIONS/ ← What was decided, and what would reverse it
│ └── Decision-Template.md
│
├── GUILDS/ ← External partner relationships
│
├── QUEST-BOARD.md ← The board. Not a copy of the board
│
└── REALM.md ← The same Codex as headings, in one file
Use the folders or REALM.md, not both. Same sections, same rules, same content —
the shape follows how your Characters read. Folders if they can open files themselves.
Headings in one document if you paste context in by hand. Moving between them is copying
text, not migrating a system.
| File | What it is |
|---|---|
| 5 Class Sheets | Complete definitions for Warrior, Mage, Hunter, Cleric, and Bard — what each shape of output must contain, how they think, how to work with them |
| Quest Board | The four-state task system |
| Decision Template | Four lines: what was decided, what it rests on, what would reverse it, when to look again |
| Template | What you write |
|---|---|
| OATH.md | Why your company exists (1-2 paragraphs) |
| DESTINY.md | Where your company is going (1-3 paragraphs) |
| Player Card | Who you are, your energy patterns, communication style |
| Character File | One per Character — name, Class, Zone, Mode, Tools, Reach, Tiers, and what it owes back to the Codex |
| Zone Overview | One per business domain — current state, metrics, open questions |
| Saga Overview | One per quarter/season — goal, quests, context |
| Quest | One per specific goal — tasks, owners, decisions, outcome |
Three capabilities, not three products. How you get them is up to you.
- Somewhere to write things down and find them again. This repo, in whatever tool you keep it. A folder of Markdown files does it. So does a notes app or a wiki.
- One interface to talk to a Character through, and a short list of what it may touch. A single chat window is enough; eight Characters can share one. On day one that list should be close to empty: no keys, no accounts, nothing that sends and nothing that spends.
- A visible list of Ready, Active, Blocked and Completed.
QUEST-BOARD.mdis that list.
One AI subscription and one text file will have you playing this week. Everything past that — scheduled runs, Characters that write to the Codex themselves, work that continues while you sleep — changes how fast the Realm moves. None of it changes whether you can start. If someone tells you REALM requires a particular platform, they are selling something.
A note on safety. A boundary written in a file is a note, not a fence. A Character that reads "I do not send email without approval" has been asked politely; if it holds a key that sends email, it can send email, and one strange input is all it takes. Anything that matters is enforced by the platform: the key it was never given, the scope the token does not carry, the branch it cannot push to, the spend cap the account itself refuses to cross. Write the tier in the Character File so everyone knows the rule. Enforce it in the platform so the rule survives a bad day. Start tight. Loosen as evidence earns it.
- Fork or clone this repo into your knowledge base tool
- Read the REALM Framework PDF — understand the principles, classes, and goal hierarchy before building
- Write your Oath (
WORLD/OATH.md) — why does your company exist? - Write your Destiny (
WORLD/DESTINY.md) — where is it going? - Create your Player Card (
PLAYERS/) — who are you, how do you work? - Rename the Zone folders to match your business domains (Commerce, Marketing, Finance, etc.)
- Write your first Character File — pick the Class that fits, name its Zone, the tools it may touch, whether it reads anything from outside the Realm, and what it owes back to the Codex
- Define your first Saga and Quest — one meaningful goal, broken into SMART Tasks
- Answer the two tooling questions at the top of
QUEST-BOARD.md— can your Characters write to the Codex themselves, and does anything happen while you are Offline? - Start your first Session — set Energy, read The Scroll if it arrived or ask for it if it did not, play
| Class | Symbol | Role | Core Question |
|---|---|---|---|
| Warrior | ⚔ | Executes defined tasks with precision | "What exactly do I need to do?" |
| Mage | ◆ | Analyzes data and surfaces insights | "What does this mean?" |
| Hunter | ◎ | Finds new information and opportunities | "What don't we know yet?" |
| Cleric | ✚ | Coordinates, protects, keeps things running | "Is everything running?" |
| Bard | ♪ | Creates content and connects with people | "How do I make someone care?" |
Full Class Sheets with abilities, limitations, and working guidelines are in CHARACTERS/Class-Sheets/.
REALM Framework v1.0 · Created by Luis Alfredo Godoy Alvarez
Licensed under CC BY-SA 4.0 — free to use, share, and adapt for any purpose, including commercially, as long as you give appropriate credit and distribute adaptations under the same license.
⚔ Build your world. Play for real.