A Microapp book
How one human and a team of AI agents run a company.
This is the place where Microapp writes everything down. The line we tell, the audience we tell it to, the enemy we name, the system we build, the agents that run it.
One book. 6 parts. 18 chapters. Read in any order — or read it cover to cover.
Contents
. FOREWORD
The one-paragraph answer to "what is Microapp." Read this before the rest of the book.
The one-paragraph answer. Before the seven brand decisions, before the architecture, before the agent team — the whole company, distilled.
I. BRAND
The message we tell, the audience we tell it to, and the enemy we name.
Seven decisions, founder-locked. The line, the audience, the enemy, the mission, the vision, the voice rules, the pledges.
Four operating postures. How the team works day-to-day — not what we publicly promise (those are the Pledges).
Ten imperatives that keep every sentence sounding like one person, not a marketing department.
II. MODEL
How the company makes money — and where the first 10% of every dollar goes. The Costco model, said plainly.
What counts as a microapp — one purpose, any runtime. Four quadrants the catalogue grows into, three spec-stage filters, and the taste every microapp gives a non-member before asking them to pay.
How Microapp makes money: one membership, ads for non-members, AI at near-cost — and 10% of every dollar to charity. The Costco model, exactly.
III. BUILD
How the system fits together — architecture, language, and decisions we don't re-derive.
How the codebase fits together — ubiquitous language, deep modules, sources of truth, decisions made, and the backlog.
Every Microapp is built to be used by an AI agent as easily as by a human. The commitment, the architecture, the rules.
The convention every Microapp follows so it works on the web AND for agents from the same source. One file, one function, two surfaces.
Palette, typography, and the components we use. The visual vocabulary the brand is rendered in.
The widget conventions that turn brand and engine into one product. Inputs, outputs, errors, mode-switching, and the shared primitives Bob inherits.
The marketing-page constitution — one type scale, one hero pattern, one container set, no raw hex. The same brand on /about, /membership, /agents, /handbook.
The hand-drawn editorial style — bold dark outlines, rounded shapes, speech bubbles, brand greens and golds. How every Microapp picture should feel.
Every architectural decision we've made, kept in plain markdown so the trail never goes cold.
IV. OPERATE
How a one-human-orchestrator company runs on agents.
How a one-human-orchestrator company runs on agents. Five layers, four memory types, four-phase build.
Steph, Kai, Bob, Lace, Simon, Ben — the agents that build, write, translate, and ship Microapp.
How Microapp goes from Claude-Code-and-a-human to self-running on Cloudflare Workers — the four Workers already live, cron + queues + tool-use, and the trust gradient that keeps it safe.
V. LOGBOOK
Real conversations that produced the work. The agent collaboration, made literal — the central claim of this book, shown not described.
Selected sessions from the agent collaboration. Each entry is a real conversation that produced a real decision — the book's central claim, made literal.
This handbook is the brain. New chapters land here as new decisions land in the company. Every word in it has a commit. Nothing is fixed in stone — Microapp is a living thing, and so is the book.
— The orchestrator