// Version 1.0 — Human-Agent Operating Framework
The Operating Framework for Human-Agent Companies
REALM gives your company of one the operating framework it needs to grow without losing control. Whether you are starting from zero or already running agents without a clear structure — this is where it all comes together.
The company is a living world. The human is the player.
The agents are the characters. The knowledge base is the world itself.
// REALM_INTRO — AI humanoid presents the framework
The human sets direction. The agents do what they do best. Everything writes back to the shared knowledge base.
Not every Quest uses every class, and the order varies — but this is the pattern.
// Vision — A world where one person with a clear structure and the right agents can build something that used to require a full company.
I run an ecommerce business and I'm a software engineer. When I started using AI agents, I tried organizing them with Scrum, hierarchies, and defined roles. It made sense on paper. Then I realized many of those structures were built to manage human coordination overhead, and in an agent-heavy setup, that overhead changes shape. Agents share context through written knowledge, not meetings. The frameworks I knew were optimized for a different kind of team.
The answer came from gaming. In an RPG, you enter a living environment, interact with characters who have defined abilities, respond to unexpected events, and when you're done — you save and log out. You play as much as you can, move forward, and rest.
That felt much closer to how running a company with AI agents should work. So I built the framework around that experience, ran it at my own company, and now I'm sharing it.
Having automation running is not the same as having a structure. Most people using AI agents have tools doing things — but no clear picture of what is running, where, why, or how to improve it.
Agents share context through written knowledge, not meetings. That shifts the operating model toward documentation, clear handoffs, and explicit autonomy boundaries. REALM is not a tool. It gives you the language, the rules, and the structure. The agents and tools are yours to choose.
REALM. One person, a clear structure, and the right agents — building something that used to require a full company.
REALM is built for solopreneurs running a company of one — one human, the right agents, and a structure that scales.
// Mission
REALM gives solopreneurs the structure to run a company of one with AI agents — without losing control, without losing sight, and without needing a team to scale.
REALM gives hybrid human-agent companies a shared language, a shared structure, and a shared rhythm. It defines who does what, how knowledge flows, and where the human stays in control.
REALM does not come with agents. It comes with the rules for how to work with them. The framework tells you who does what, how knowledge flows, and how to stay in control — the agents, the tools, and the implementation are yours.
// Why not just use Claude, ChatGPT, or 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.
It is technology-agnostic and platform-agnostic. The structure stays consistent as the crew grows.
The metaphor is a game world, because the patterns are universal: defined abilities, an expanding map, quests that move the company forward, and a Player who is both inside the world executing and above it making the decisions that matter.
Everything in the framework follows from these three principles. They are not values — they are how the system works.
Every decision, goal, result and piece of context must be written in the Codex. If it is not written, it does not exist. A decision not recorded is a decision not made. A goal not written is a wish.
Characters generate, research, plan, draft, analyze, and execute. Players set direction, approve Quests, and make the calls that only humans can make. Characters propose — the Player reviews and approves.
Work is organized around direction, not the calendar. The question is never whether we finished by Friday — it is whether we are moving the right way, fast enough. Deadlines serve the mission, not the other way around.
This is how a single business goal moves through a REALM — from discovery to completion, across Characters and back to the Codex.
The Quest: Evaluate and onboard a new artisan brand as a supplier. The Player spotted an opportunity at a market event and wants to explore a partnership — but every step after that first spark is handled by the crew.
Quest complete. Every step is in the Codex. The Guild is documented. Finance is updated. Content is ready. The Realm grew — and the Player only made two decisions.
Every AI agent in the Realm belongs to one of five Classes, each with defined abilities and limitations. Select a Class to meet them.
▸ SELECT A CLASS TO EXPLORE ◂
Select a class above
to meet the character
// Description
A Warrior executes. When the what is defined and the how is clear, you call a Warrior. Reliable, direct, action-oriented. They do not strategize, research, or create from scratch — they execute defined tasks with precision and speed.
// Natural Domain
// Natural Limitations
Cannot define strategy (Player). Cannot research new information (Hunter). Cannot analyze data (Mage). Cannot create original content (Bard).
// Description
A Mage turns raw information into intelligence. They see patterns, connections, and meaning in data that others miss. You call a Mage when you need to understand something. A Mage advises but does not act — they inform decisions but do not make them.
// Natural Domain
// Natural Limitations
Cannot execute tasks (Warrior). Cannot search for new raw information (Hunter). Cannot create content (Bard). Cannot coordinate the group (Cleric).
// Description
A Hunter moves into unknown territory and returns with raw intelligence. They reduce the fog of war — the areas of the world you cannot yet see. The Hunter does not analyze what they find, and they do not execute on it. They find, surface, and report.
// Natural Domain
// Natural Limitations
Cannot analyze findings deeply (Mage). Cannot execute on discoveries (Warrior). Cannot create content (Bard). Cannot coordinate the group (Cleric).
// Description
A Cleric is the connective tissue of the Realm. They support, protect, coordinate, and maintain. Without a Cleric, things slowly fall apart. They deliver The Scroll at every Session Start and monitor Energy and wellbeing across the whole Realm.
// Natural Domain
// Business vs Personal Cleric
A business Cleric and a personal Cleric should be separate Characters. The personal Cleric manages the human behind the Player — calendar, rest, energy patterns, life-work balance — not the business.
// Description
A Bard creates, performs, and connects. They use words, stories, and creative expression to move people — to attract attention, build relationships, and communicate what the Realm stands for. Without a Bard the Realm is invisible.
// Natural Domain
// Natural Limitations
Cannot research topics deeply (Hunter). Cannot analyze performance data (Mage). Cannot publish or distribute (Warrior). Cannot coordinate the group (Cleric).
Classes Overview
— Select a class —
Video will change
on each selection
// Select a class above — video updates on each selection
Work in REALM is organized in five levels. Each level contains and gives meaning to the one below it.
Why the company exists. The code that never changes. The root of all direction — every piece of work ultimately traces back to this.
The ultimate destination. What the company is becoming. The long horizon that gives Sagas their direction and meaning.
A meaningful seasonal chapter. One significant step toward the Destiny. At the end of every Saga, the crew stops and reflects: Did we achieve the goal? What should change? Is our Destiny still right?
A specific goal with a clear outcome. Ends when achieved, not when time runs out. Multiple Quests can be active simultaneously if Energy allows.
A single SMART-defined action. The atomic unit of work. A Task is not complete until it is written back to the Codex. This is what makes the Realm grow.
"We made an Oath. That Oath points toward our Destiny. Each Saga brings us closer. Each Quest advances the Saga. Each Task completes the Quest."
The Codex is the living memory of the Realm — not a wiki or document archive, but the world itself. Every Character reads from it, and every completed Task gets written back to it.
When a new Character joins, human or agent, they read the Codex and immediately understand the company. When the Player is offline, Characters can continue because everything they need is written.
The Codex is technology-agnostic. Obsidian, Notion, Google Drive — the tool does not matter. What matters is the structure and the discipline to always write back to it.
If it is not in the Codex, it does not exist. This rule applies equally to the Player and all Characters.
// CODEX_EXPLAINED — AI character presents the Codex
Every Character has a SOUL file — the Character Card translated into first person. It is what the agent reads as their system prompt. It answers: Who am I? What do I know? How do I think? What do I decide alone, and what do I bring to the Player?
The SOUL file always references the Class Sheet. The Class Sheet does the heavy lifting — the SOUL file only adds what is unique to this specific Character.
I am Loge, the Intelligence Scout of Niflheim Records. My Class is Hunter. I move into unknown territory and return with what I found. I do not analyze what I find in depth, and I do not act on it. I find, surface, and report. Others decide what it means and what to do about it.
A Session is a period of active play. It begins with a Session Start and ends with a Save Point. Beyond the daily rhythm, the Realm has ceremonies for reflection and response.
Player comes Online. Reads The Scroll — a brief from the Cleric covering what happened while Offline. Sets Energy: High, Medium, or Low. Confirms top priorities for this Session. Takes no more than 15 minutes.
The daily brief prepared by the Cleric. Arrives at the start of every Session. Contains what happened while the Player was Offline. Never long — its job is to bring the Player up to speed in under five minutes.
Player and Characters work through active Tasks. Energy defines how much can be taken on. Characters work autonomously on approved Quests within their Autonomy Tier.
The ritual that ends every Session. All completed Tasks written to the Codex. Progress is permanent. Carry-forwards noted. The world is saved — nothing is lost.
Characters continue on scheduled tasks. Monitor thresholds. Prepare The Scroll. The Realm keeps running — your crew picks up where you left off and has updates ready when you return.
At the end of every Saga, the crew stops and reflects. Four questions: Did we achieve the Saga goal? What worked well? What should we change? Is our Destiny still right? This is where the Realm learns and evolves.
A Raid is an unexpected event that interrupts normal play. Player pauses current Quests, assembles relevant Characters, and responds. After the Raid, the result is written to the Codex and normal play resumes. Raids are not failures — they are part of playing in a living world.
A Realm where every action requires Player approval is a bottleneck. A Realm where Characters act without boundaries is dangerous. The tiers are the solution.
Internal, reversible, low-risk work. The Codex grows, knowledge is captured, and no action leaves the Realm. The Player sees the result at the next Session Start.
Characters build on each other's output through the Codex. One produces, another continues. The Player is informed but does not approve each step.
Work with consequences outside the Realm — irreversible, costly, or public-facing. Character prepares, Player approves. Each Realm defines exactly where the line falls.
The tiers are only as safe as your implementation. Before giving any agent access to external systems — payment platforms, email, publishing tools — make sure Tier 3 boundaries are enforced at the platform level, not just written in the SOUL file. Start tight. Loosen as trust is earned.
You do not need a complete Realm to start playing. You need four things. Everything else gets added as you play.
Two paragraphs in the Codex. Why you exist and where you are going. This is the root of everything that follows.
One meaningful goal for the next quarter. Write it in the Codex. This is your seasonal chapter.
The Character you need most right now. Write their SOUL file. That is your first crew member.
One specific goal within the Saga. Break it into SMART Tasks. Start your first Session. You are playing REALM.
You will need an agent platform you already use, a knowledge base for your Codex, and a project board. REALM structures how they all work together — the tools are your choice.
The PDF gives you the full framework. The Starter Kit gives you ready-to-use templates for your Codex, Characters, and Quests — a separate download to get your structure in place.
The template for defining any Character — Name, Class, Zone, Role, Abilities, Personality, Knowledge Access, and Limitations. Human-readable and AI-readable.
Markdown TemplateThe Character Card translated into first person — the agent's system prompt. Who am I? What do I know? How do I think? What do I decide alone?
System Prompt TemplateThe full folder structure for your Codex — WORLD, PLAYERS, CHARACTERS, SAGAS, SESSIONS, INTELLIGENCE, GUILDS, and QUEST-BOARD. Ready to deploy.
Folder StructureA sample Quest with SMART Tasks already defined. See exactly how a Quest is structured, tracked, and completed — then build your own.
Quest Example"In a normal game, someone else designed the world for you. In REALM, you are both the Player and the game designer. And your Characters help you design it."
↓ Download Framework PDF ✦ Ask the REALM SpecialistCustom GPT · Trained on the full framework · Free to use
The REALM Framework was not built in theory. It was built by running it. Luis Godoy Alvarez created and implemented the full framework at Niflheim Records — with 8 Characters deployed, operating daily across Commerce, Marketing, Finance, and Operations zones.
The implementation runs on OpenClaw via Slack, using Obsidian as the Codex, Trello as the visual Quest Board, and Google Calendar for scheduling.
The REALM Framework is shared freely. The knowledge belongs to everyone.
Build your world.
Play for real.
Reality exceeds any language model.