01 — Why · a live tenant
How a team runs an AI workforce on Arkon.
This is one tenant, ACME, running Arkon in production today — names changed, the operating picture intact. The same four primitives you provision with are the ones holding this fleet together right now.
The 90-second read
ACME installed Arkon to run an AI workforce across three lanes on a seven-host fleet — Delivery (client work), Team (people in training), and Platform (Arkon itself).
Warden, the governing agent on Claude Opus 4.7, is the sole executive of the fleet. It takes the business load so the operator is freed for higher-value work. Five agents under Warden's hand. A direct lane runs alongside. Several new team members each operate a personal agent. Every turn writes a row.
Delivery
Client work — websites, custom retainers, and sprint work, shipped by the governed fleet.
Team
A young AI team in training. New members onboard by provisioning a personal agent they own.
Platform
Arkon itself — ArkonOS, ArkonHelm, the command center, and the runtime that governs the fleet.
Warden takes the business load. The fleet keeps writing rows.
— operating principle
02 — A day on the fleet
Six moments from one Tuesday.
The fleet is easier to read once you've watched it do a day. Every moment names an agent and a real outcome.
Warden writes the morning brief.
A timer fires. Warden pulls last night's results, the activity summary, pending tasks, and fleet health into one brief — landing on the board before the operator's first coffee.
Forge ships a client feature.
A pull request opens against a client repo. Helm catches the agent-run, attaches the PR, and opens an approval gate. The operator taps Approve on a phone. Forge picks the merge back up.
Lumina drafts research, spliced in line.
Warden delegates “summarise the new model pricing tier.” Lumina reads three sources, drafts a brief, posts it to the team chat, and writes the result back to the queue — spliced into Warden's next reply by 11:24.
Sentinel flags a vendor change.
An upstream API behaviour shifts. Sentinel notices in its hourly sweep, posts a one-paragraph briefing to the ops channel, and pins the source on the wiki.
Helm catches a budget ceiling.
A worker hits its monthly budget cap. Helm queues the run for review instead of silently killing it. The kill switch is still one tap away — the operator just sees the gate first.
The fleet is quiet.
Warden's session log keeps writing. The control database backs up to object storage. Tomorrow's morning brief is queued for 04:30. Every turn from today wrote a row.
03 — The four primitives
Every surface here serves one of four.
Provision, govern, observe, kill. The case below maps to these — the full framing lives on the platform page.
Sixty seconds
Pick a role, type one sentence, the agent is live and drafting its own spec.
Boundaries by default
Autonomy limits, a monthly budget, and approval gates ship with every agent.
Every turn a row
Cost, tools, decisions, delegations — queryable from the dashboard or the CLI.
Five seconds
Stop an agent, a tool, or a whole tenant. Per-scope, reversible, audited.
04 — The AI workforce
Fourteen agents. Four lanes.
Each agent is a role on a harness on a model on a host. Warden alone delegates inside the governed fleet; the other lanes sit outside that line by design.
Warden-governed
sole executive · 5 agents · delegate flows outward★ Warden
Sole executive · delegator
Governs the fleet. Holds UKR, WAEL, and Helm write access — no other agent does. Delegates by name; never to itself.
Exists so the operator ships through one accountable surface, not nine.
Forge
Dedicated coding agent
Writes code on tightly scoped tasks. Replaced an earlier coder on 2026-05-23 — same one-swing rule, new harness.
Exists so Warden has a code hand without burning Opus tokens on plumbing.
Lumina
Research · customer copy
Multi-source web research, briefs, and customer-facing copy. Owns knowledge retrieval through ChromaDB on EU-OPEN.
Exists so polished voice and long-form research stay off Warden's main thread.
Sentinel
Ops · scouting intelligence
Watches changelogs, vendor APIs, security incidents, and infrastructure signals across the stack.
Exists so vendor surprises surface as briefings, not outages.
Dunamis
Fleet dispatcher · routing
Routes the operator to agents, prioritises, and synthesises across replies. Owns no execution; never delegates to itself.
Exists so the fleet has a single intake mouth as agents multiply.
Direct lane
not Warden-governed · by design · operator-directMentor
Internal team agent
Onboarding support, internal training, and team-side content drafting. Reads the company knowledge base.
Exists so the team lane stays separate from the business fleet.
Archivist
Steward of brand voice
Holds the brand-voice corpus, drafts on-voice messages, and flags drift from approved messaging.
Exists so the company's voice carries forward consistently as it scales.
Team personal agents
Hermes harness · 5 members · each builds their ownJordan's agent
Personal · onboarding
A done-for-you agent owned, named, and scoped by the team member. Provisioned through Arkon's role-pack catalog.
Exists so each member learns by running an agent they own.
Riley's agent
Personal · onboarding
A done-for-you agent owned, named, and scoped by the team member. Provisioned through Arkon's role-pack catalog.
Exists so each member learns by running an agent they own.
Casey's agent
Personal · onboarding
A done-for-you agent owned, named, and scoped by the team member. Provisioned through Arkon's role-pack catalog.
Exists so each member learns by running an agent they own.
Morgan's agent
Personal · onboarding
A done-for-you agent owned, named, and scoped by the team member. Provisioned through Arkon's role-pack catalog.
Exists so each member learns by running an agent they own.
Avery's agent
Personal · onboarding
A done-for-you agent owned, named, and scoped by the team member. Provisioned through Arkon's role-pack catalog.
Exists so each member learns by running an agent they own.
DFY pattern
OpenClaw harness · bounded delegate MCP onlyApollo
Personal agent · co-resident
A team member's personal assistant agent. Co-located on TEAM-1 but isolated from Warden. The template for onboarding.
Exists so the team has a DFY pattern to clone for new members.
site-edit-worker
Bounded MCP delegate
Patches static client-site HTML element-by-element during maintenance jobs. Tokens minted through the bridge.
Exists so client sites get surgical edits without an agent holding a shell.
Models without tools are conversations. Harnesses turn them into work.
— platform vocabulary
05 — The backbone
Seven components carry the platform.
What the operator touches, what the agents touch, and where the shared memory sits. Press play to trace a real message through the fleet, hop by hop.
How the components talk to each other
operator surfaces → executive → harnesses → memoryArkonOS
Observeos.arkonhq.com · chat PWA
The chat app where the operator talks to the fleet.
A website and phone app with one channel per agent — Warden in one, Lumina in the next, Dunamis in the next. A team chat where every channel is an agent. It also carries task lists, knowledge search, and victory briefings.
The operator opens ArkonOS at the airport, taps the Warden channel — “what shipped last night?” — and gets three bullets and a Helm link. No terminal, no laptop.
The fleet has no front door for the human. Chat falls back to SSH and CLI.
Arkon
Provisionapp.arkonhq.com · command center
The console where you install, govern, and stop the workforce.
ArkonOS is for talking to agents. Arkon is for managing them — spinning up new agents from a catalog, setting budgets and boundaries, watching costs, and hitting the kill switch. This is where the Provision pillar lives.
The operator taps “Provision new agent,” picks “Researcher,” types one sentence. Sixty seconds later the agent is live, with conservative budget defaults. No terminal was opened.
No provisioning surface. Operators provision through CLI or scripts only.
Warden Bridge
GovernACME-TEAM-1 · long-running runtime
Where Warden's brain lives, full-time.
Warden can't be a fresh thought every time you open a chat. The Bridge is a process that runs around the clock, keeping Warden's memory, identity, and authority to delegate active 24/7. Message Warden in ArkonOS and you reach the Bridge — the same Warden every time.
11:00 — the operator asks Warden to delegate research to Lumina. 14:00 — they reopen ArkonOS and the result is already waiting, spliced into Warden's next reply. No re-prompting.
No Warden in chat. The delegation queue keeps draining, but the executive surface goes dark.
ArkonHelm
Governhelm.arkonhq.com · the board
The board for everything the fleet is doing.
Every ticket, work item, and approval gate across all lanes lives here. It's where the operator approves, rejects, or releases work the fleet has produced — and where the fleet looks before it starts something new.
Forge ships a PR. Helm catches the agent-run, attaches it, opens a gate, and pings the operator. They tap Approve over coffee. The fleet picks the merge back up.
No source of truth for what the fleet has done, is doing, or is blocked on.
Hermes Harness
ProvisionNous Hermes Agent · worker shell
The shell that wraps a model and gives it hands.
A raw model can talk, but it can't open a file, send a message, or query a database. A harness is the wrapper that gives the model those abilities. Hermes is the harness six agents run on: Forge, Lumina, Sentinel, Dunamis, Archivist, and every team member's personal agent.
Warden delegates research to Lumina — a model inside a Hermes harness. The harness adds web-search, file-write, and report-back tools, and the model becomes an actual worker.
Six agents go silent at once. The fleet collapses to Warden alone.
OpenClaw Harness
Provisionv2026.4.2 · DFY personal-agent shell
A second harness, purpose-built for personal agents.
OpenClaw is a second harness — same job, different shape — built for done-for-you personal agents that members own end-to-end. Apollo runs on OpenClaw today; every new team member uses it to stand up their own personal agent.
A new member opens Arkon and picks the “personal assistant” role-pack. Sixty seconds later an OpenClaw harness wraps their chosen model, and they have their own Apollo — shipping by lunchtime.
Apollo stops. The onboarding pattern has no template.
UKR
ObserveUnified Knowledge Repository · memory
The one place agents don't forget.
Agents forget. UKR is the one place that doesn't. Every decision, every entity, every fact Warden needs next Monday lives here. The fleet reads through Warden; Warden alone writes — so canonical memory has a single accountable author.
Three weeks ago the operator decided “site-edit-worker is the only delegate allowed to touch client HTML.” Today Warden queries UKR, finds the pinned rule, and routes the work correctly the first time.
Warden re-learns the same decision every Monday morning. Drift goes undetected.
06 — UKR · the memory
The one place the fleet doesn't forget.
UKR earns its own tier. Every other component is replaceable. This one is the spine — the canonical record the fleet trusts when memory and reality disagree.
Six layers. Five verbs. One writer.
A self-hosted knowledge substrate that consolidates everything the fleet has ever decided. Warden alone writes; the rest of the fleet reads through Warden. Anchored in mission_control Postgres on data-spine-1.
Six layers — what UKR remembers
docs
Briefs, plans, deliverables — the things you wrote down.
decisions
Pinned calls Warden made and why. Supersedable.
entities
People, clients, hosts, agents — the proper nouns of the fleet.
facts
Atomic truths attached to entities. Datable. Citable.
events
What happened, when, by whom. The fleet's timeline.
synthesis
Warden's own conclusions across the lower layers. Rebuildable.
Five verbs — how Warden touches UKR
ukr_pinMark this as canonical going forward.
ukr_queryRead what UKR already knows.
ukr_supersedeRetire an entry; point it at the newer truth.
ukr_unpinDemote without deleting. Tombstone stays.
ukr_upsertWrite the row or update it in place.
Authority model — what wins when memory disagrees
If any derived layer disagrees with raw + catalog, canonical wins.
The ingest forge — how something becomes canonical
Six stages. Failed extractions drop to a quarantine lane; secrets are redacted before embedding. Press play to trace a file through.
The ingest forge — how something becomes canonical
source → six stages → canonical07 — The map
Seven hosts, three continents, one Tailnet.
Each host lists the agents and services that live there. Public IPs serve HTTPS only via Cloudflare; everything else moves over Tailscale.
EU · 24% disk · 45d up
Warden runtime + Bridge, observability, automation. Runs Warden and Apollo.
EU · 33% disk · 43d up
Worker pool, ArkonOS, ChromaDB, OpenClaw gateway. Runs Lumina, Sentinel, Dunamis.
EU · 78% disk · tight
The data spine — control Postgres, secrets, docs portal. UKR lives here.
EU · app host
Deployment platform and the fleet app surface. Root key revoked after rotation.
NA · SSH timeout
Edge node, currently unreachable. Static site offline — flagged on Helm, not blocking the fleet.
ZA · 88% disk · critical
Content factory and crawl/TTS services. Runs Mentor and Forge.
ZA · intermittent
The operator's own surface — local agent tooling and design work. Comes and goes.
08 — Net effect
What the fleet actually adds up to.
The tiers above explain the parts. These four outcomes are what they mean for the team running it.
The operator freed for higher-value work.
Warden carries the business load through one accountable surface, so the operator spends time where it counts.
Ops resilience without an IT team.
Seven hosts on Tailscale, daily backups to object storage, and Helm tracking every approval gate — run by one operator.
New members building real systems.
Five team members provisioning their own personal agents through Arkon. They learn by running an agent they own.
Five-second kill switch on any agent.
Per-scope, reversible, audited, tested. Governance isn't a document — it's a button, fired before every launch.
Build velocity — the last four weeks
Glossary
Platform vocabulary.
- Agent
- A role on a harness on a model on a host. Each agent is one accountable hand.
- Bridge
- The long-running runtime an agent's brain lives inside, e.g. the Warden Bridge.
- Delegate
- Hand a task to a specific named agent. Warden is the only delegator inside the governed fleet.
- Lane
- One of a tenant's separated streams of work — here, Delivery, Team, and Platform.
- Harness
- The wrapper that gives a raw model tools — Hermes or OpenClaw. Models without one are conversations.
- Operator
- The human running the AI workforce. Not “admin,” not “user.”
- Pillar
- One of Arkon's four primitives — Provision, Govern, Observe, Kill.
- Role-pack
- A pre-configured agent template in the Arkon catalog.
- Tenant
- An isolated workspace inside Arkon. ACME is one tenant; its lanes live inside it.
- UKR
- Unified Knowledge Repository. The fleet's shared long-term memory. Warden alone writes.
- WAEL
- Worker Activity Event Log. Every turn writes a row here.
- Warden
- The governing agent. Capital W — a role name, not a brand.