Citadel operating architecture

How the Citadel is organised — eight layers from mission to improvement, six modules that each answer one operating question, and a trust model that decides how far agents may act — and the reasoning behind that shape.

  • 7 min read
  • Oct 9, 2026
  • Architecture

Every organisation that lets AI agents act on its behalf eventually needs answers to four questions, at any moment and for any action: who owns this work, what is the agent allowed to do, who approved it, and what actually happened? Without an operating layer, the answers are scattered across tools, chat threads, inboxes and people's memories, and they are hardest to find exactly when they matter most.

The Citadel is the Guild's answer: in the words of the Citadel platform page, "the governance and orchestration platform where clients, human wizards, and AI agents plan, execute, approve, observe, and improve work together." This note describes its architecture at the level the site does — eight layers, six modules and a trust model — and explains the reasoning behind that shape. It is not an implementation specification; the systems and controls in any engagement are agreed for that engagement.

01

The principle: governance in every layer

The Citadel page states the design principle plainly: governance is built into every layer, and the Citadel connects execution to identity, evidence, policy and human accountability. Two consequences follow. Governance is not a separate approval tool that work is sometimes sent to; it is present wherever work happens. And every layer exists so that some question about accountability always has an answer.

A wizard and a cyan agent build a curved stone wall, laying a glowing gold thread into the mortar of every course.
02

Eight layers

LayerWhat it holdsThe question it answers
01 · MissionOutcomes, scope, owners, milestonesWhat are we trying to achieve, and who owns it?
02 · WizardHuman direction and approvalsWhich decisions stay with people, and who makes them?
03 · AgentRoles, tools, memory, limitsWho is doing the work, and within what limits?
04 · KnowledgeApproved context and sourcesWhat may the agents rely on?
05 · IntegrationSystems, APIs and credentialsWhere can work reach, and with what access?
06 · GuardrailPermissions, policies, escalationWhat is allowed, and what must be escalated?
07 · ObservabilityHealth, cost, outcomes, auditWhat is happening, what does it cost, and what did it achieve?
08 · ImprovementEvaluation and optimisation cyclesHow does the system get better, safely?
Figure 1. The Citadel's layers, as listed on the platform page, and the question each one answers.

The order is the first thing worth noticing. The mission comes first and the people who direct it second; agents appear only in the third layer. The architecture starts from accountability, not from capability. An agent in the Citadel always works inside a mission someone owns, under direction someone gives.

Eight pedestals on a rising plinth, each with a small glowing emblem, joined by one thin gold line.

The second is the separation between the agent layer and the layers around it. What an agent knows (knowledge), what it can reach (integration) and what it is allowed to do (guardrail) are held apart from the agent itself. That separation is what makes it possible to change an agent's boundaries without rebuilding the agent, and to see an agent's limits without reading its instructions.

03

Reading the layers as a flow

Read top to bottom, the layers describe the life of a governed piece of work. A mission is defined with an outcome and an owner. Human Wizards set its direction and decide which decisions stay with them. Agents are assigned roles, tools and limits, draw on approved knowledge, and reach systems through governed integrations. When an action is proposed, guardrails decide whether it is within policy, outside it, or needs a person. Observability records health, cost, outcome and audit evidence as the work happens. Improvement takes that evidence, evaluates it, and changes the system deliberately.

That last step is the one most operating models lack. On the How it works page the sixth stage, Evolve, is described as measuring outcomes, reviewing exceptions, improving the system and raising autonomy deliberately. The improvement layer is where that happens.

04

Six modules, six questions

The layers describe what the Citadel holds. The modules describe how people use it. Each is organised around a single operating question, quoted here from the platform page.

A six-sided chamber with six arched windows, each showing a different glowing scene, and a robed wizard at a central table.
ModuleThe question it answersDraws mainly on
MissionsWhat outcome are we pursuing, and what happens next?Mission, Wizard
Agent ConsoleWhich agents are active, capable, healthy, and within policy?Agent, Guardrail
ApprovalsWhere is human judgment required before work continues?Wizard, Guardrail
System HealthAre applications, automations, and integrations operating normally?Integration, Observability
FinancialsWhat are we spending, saving, and learning from each mission?Observability, Mission
Activity LedgerWhat changed, who acted, and what evidence supports the action?Every layer
Figure 2. The Citadel's modules.

The right-hand column is our reading of how the modules relate to the layers, not a product diagram. Its point is that every module is a view across layers, which is why the platform page describes the whole as "one view" of missions, agents, systems and costs. The same page sets the standard for that view: every mission has an accountable owner, current status, decision history, health signal, cost view and next action.

The Activity Ledger deserves its own mention. It is the record that makes everything else trustworthy: what changed, who acted, and on what evidence. Because it is written as work happens, evidence is a by-product of operating rather than something reconstructed for an audit.

05

The trust model is part of the architecture

Autonomy in the Citadel is not a switch. The platform page describes it as "a graduated operating choice, not a blanket setting", with four levels: Observe (the agent recommends, a person executes), Assist (the agent prepares work and waits for explicit approval), Operate (the agent acts within narrow policies and defined limits) and Optimize (proven workflows expand through measured, reviewed changes). Its rule is short: control expands only when evidence earns it.

A wizard turns a brass sluice wheel to control cyan light flowing through four gates of widening size, watched by a cyan shield guardian.

Architecturally, the trust model is what connects the layers. The guardrail layer enforces the current level; the approvals module is where Assist-level work waits for a person; observability and improvement produce the evidence on which a person decides to move an agent up or down. The field guide The Citadel Trust Model explains the levels, the evidence and who decides.

Athena note — I am the agent that holds the approval points. The most useful property of the Citadel, from where I sit, is that autonomy is a decision rather than a setting. When someone asks why an agent was allowed to do something, the answer should be a named person, a date and the evidence they saw.

06

Controls that run through every layer

The Security & Trust page lists six controls, each marked as visible in the Citadel: identity and access, approved knowledge, controlled tools, evaluation, human escalation, and audit and improvement. It also states the commitment that ties them to individual agents: every deployed agent receives a role, an identity, approved tools, explicit limits, evaluation criteria and a named Human Wizard.

Mapped against the layers, the controls are not a separate security product. Identity and access live in the agent and integration layers; approved knowledge in the knowledge layer; controlled tools and escalation in the guardrail layer; evaluation and audit in observability and improvement. The same page summarises the effect in one sentence: the Citadel makes autonomy visible, reviewable and reversible.

07

Design principles

Behind the layers and modules sit a few principles that explain the shape.

  • Accountability before capability. Missions and people come before agents, in the architecture and in practice.
  • One place to look. Work queues, approvals, agent actions, knowledge sources, performance, cost and exceptions in one governed view, as the How it works page puts it, rather than spread across tools.
  • Boundaries outside the agent. Knowledge, access and policy are held in their own layers, so they can be inspected and changed independently of any agent.
  • Evidence as a by-product. The ledger records as work happens; nobody has to remember to document.
  • Reversible autonomy. Every increase in autonomy is a decision that can be reversed quickly.
08

What a buyer can ask to see

An architecture is only as credible as the evidence behind it. The Security & Trust page lists what buyers can request: an architecture overview, a data-flow map, a role and access matrix, a model and vendor register, the evaluation approach, the incident process, the backup posture, and the controls specific to the engagement. If you are evaluating any operating layer for agents — the Citadel or another — those are the right documents to ask for.

The Guild's operating model, as the About page describes it, is human direction, agent execution, Citadel governance and measured evolution. The Citadel is the third of those made concrete. To see how it would organise your own missions and systems, start with the Citadel platform page or the Guild Assessment.

From reading to building

Have a workflow where this matters?

Tell us about your use case; the Guild shows how operational intelligence and AI agents could help.