REALM Framework
FAQ
Common questions about the REALM Framework, how it works, and how to get started.
What is the REALM Framework?
REALM is an operating framework for human-agent companies, organizations 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 framework uses an RPG-inspired structure: the human is the Player, AI agents are Characters organized into five Classes, and the shared knowledge base is the Codex.
What are the five Character Classes?
Every AI agent in a Realm belongs to one of five Classes. The Warrior executes defined tasks. The Mage analyzes data and surfaces insights. The Hunter finds new information and opportunities. The Cleric coordinates and keeps things running. The Bard creates content and connects with people. Each Class has defined abilities and limitations documented in a Class Sheet.
What is the Codex?
The Codex is the living memory of the Realm, the shared knowledge base that every Character reads from and writes to. It contains the company's purpose, long-term direction, active work, all Character definitions, and decisions made. It is technology-agnostic, it can live in Obsidian, Notion, Google Drive, or any tool. The core rule is simple: if it is not in the Codex, it does not exist.
What is a SOUL file?
A SOUL file is the Character Card translated into first person, the system prompt that the AI agent reads when it starts. It defines who the agent is, how it thinks, how it communicates, what it decides alone, and what it brings to the Player. The SOUL file references the Class Sheet and adds only what is unique to that specific Character.
Who is REALM built for?
REALM is built for solopreneurs and side hustlers who want to build their company of one with AI agents, from zero or from an existing setup that needs structure. It is for people with a business idea and no budget to hire, operators who think in systems and iteration, and anyone who has tried Scrum, Kanban, or similar frameworks and felt they did not fit an AI-augmented team. It is not built for large enterprises seeking a SaaS platform or people looking for a quick productivity hack.
How does work flow in REALM?
The Player sets direction. The Hunter finds information. The Mage analyzes it. The Bard creates content. The Warrior executes defined tasks. The Cleric coordinates everything. All output is written back to the Codex. Not every Quest uses every Class, and the order varies, but this is the general pattern.
What is the Goal Hierarchy?
Work is organized in five levels: the Oath, the Destiny, Sagas, Quests, and Tasks. The Oath explains why the company exists. The Destiny describes where the company is going. Sagas are seasonal chapters. Quests are specific goals with clear outcomes. Tasks are single SMART-defined actions. Each level gives meaning to the one below it.
What is a Session?
A Session is a period of active work. It begins with a Session Start, where the Player reads The Scroll, sets their Energy level, and confirms priorities. It ends with a Save Point, where completed Tasks are written to the Codex and progress is saved. Between Sessions, Characters continue on scheduled work and prepare for the next Session Start.
What are Autonomy Tiers?
Autonomy Tiers control how much freedom each Character has. Tier 1 means Characters act alone on internal, reversible, low-risk work. Tier 2 means Characters build on each other's output through the Codex, with the Player informed but not approving each step. Tier 3 means the Player approves before anything with external consequences, such as money, publishing, messages, or commitments.
How do I get started?
You need four things: write your Oath and Destiny in the Codex, define your first Saga, create one Character Card and SOUL file, and define your first Quest with SMART Tasks. You also need an agent platform, a knowledge base tool, and a project board. The REALM Codex Starter on GitHub provides the folder structure and templates.
Is REALM free?
Yes. The framework is licensed under CC BY-SA 4.0, free to use, share, and adapt for any purpose, including commercially. The PDF, starter kit, and GitHub repository are all available without email gates or payment.
What tools does REALM require?
REALM is technology-agnostic. You need any agent platform you already use, a knowledge base for your Codex, and a project board. Examples include Claude, a custom automation setup, Obsidian, Notion, Google Drive, Trello, Linear, or similar tools. REALM defines the structure and workflow, the tools are your choice.
Has REALM been used in a real company?
Yes. REALM was built and is running at Niflheim Records with 8 Characters deployed across seven zones. The In Practice page shows real artifacts from that implementation, including Character Cards, SOUL files, the Obsidian Codex structure, Quest progressions, and the Trello board.
How is REALM different from Scrum or Kanban?
Scrum and Kanban were designed to coordinate human teams around human constraints, such as limited memory, limited hours, and calendar-based planning. REALM is designed for teams that include AI agents, which share context through written knowledge rather than meetings. REALM shifts the operating model toward documentation, clear handoffs, and explicit autonomy boundaries.
Does REALM come with agents ready to use?
No. REALM is a framework, not a product. It gives you the rules, the structure, the language, and the templates. The agents, the tools, and the implementation are yours to build. Think of it the way Scrum gives you a process, but you still need to build the team.
Why not just use Claude, ChatGPT, or tools like Cowork?
Those are your agents, they can be Characters in your Realm. REALM does not compete with them. It gives them a structure to operate inside. Without a framework, you have automation. With REALM, you have a company.