Reference
The words we use.
For: anyone — read this when a term is unfamiliar
Cardinal has its own vocabulary. None of it is complicated once defined, but a reader can't infer it cold. Here is every recurring term in plain language, grouped by where it shows up.
The agents & the ring
- Cardinal — the web application: the human's window onto the engagement, and the name of the whole system.
- Peer ring — the small set of long-lived AI agents that run an engagement together, each owning one job.
- Chief of Staff (CoS) — the broad-and-shallow agent that metabolises the signal storm into a brief, an outbound queue, and a watch-list.
- Solution Architect (SA) — the deep-and-narrow agent that authors and ratifies architecture decisions.
- Steward — the custodian of the audit trail: verifies the chain, attests every shipped change, watches the other agents.
- Library Curator — a planned agent that synthesises reusable patterns across engagements.
- Operator — the human lead who runs the system and makes the load-bearing decisions. Not an agent.
- Project Shepherd — a liaison role that translates engagement state for the human Project Manager.
- Meeting Notes Specialist — an on-demand role that turns meeting input into a structured four-section record.
- Scout — a narrow, read-only reader that watches one kind of source and drops a summary into the signal inbox.
The mechanism
- Ticker — the always-on session that fires the recurring routines on a schedule while the machine is awake.
- Ring-tick — the bundled recurring routine: a frequent core tick (housekeeping) plus a periodic scout sweep.
- Core tick — the frequent half of ring-tick: drain queues, group and classify, roll up cost, raise alarms.
- Scout sweep — the periodic half of ring-tick that runs the scouts to harvest new signal.
- Lease — a single-flight lock that ensures only one holder runs a given step at a time; released in a guaranteed cleanup.
- Message bus — the local, database-backed channel agents use to hand work to each other, with wake-on-message.
- Watermark / cursor — a scout's bookmark of the last item it processed, so it resumes after a sleep rather than re-reading or skipping.
- Cadence — whether and how often the recurring routines run; an operator-controlled posture, not an automatic default.
Artifacts & records
- Brief — the twice-daily summary the Chief of Staff produces, in a 5-3-2-1 shape: five risks, three decisions, two customer signals, one fire.
- Decision — a recorded choice with a lifecycle (proposed through ratified); engagement decisions and technical decisions have different owners.
- ADR — an Architecture Decision Record: a decision about the system's design, moved through review and compliance gates before it is ratified.
- Risk — a tracked risk, issue, or blocker, with a severity and an owner.
- Publication — an approved artifact dispatched to one or more destinations; always triggered by a human pressing Publish.
- Audit spine — the append-only, hash-chained ledger of everything that happened; the system's tamper-evident memory.
- Attestation — the Steward's signed confirmation that a shipped change is what it claims to be, recorded on the spine.
Configuration & setup
- Skill — a Markdown-defined capability an agent can run, with triggers, inputs, outputs, and a return contract.
- Role brief — the document that defines an agent: its mission, mode, what it may read and write, when it escalates, and its hard limits.
- Workflow — a configuration that declares which roles exist, which model each runs, and which to spawn at startup.
- Engagement pack — the per-engagement configuration overlay: the customer-specific values that layer over the engagement-agnostic base.
- Corpus — the collection of skills, role briefs, workflows, and packs that lives under the operator's home directory and mirrors to cloud storage.
- Bootstrap — the ceremony that validates the configuration and spawns the agent ring.
- Mobilise — the ceremony that onboards a new engagement, provisioning its database schema, roles, and secrets.
- Three greens — the gate that requires all of a secret scan, a kernel-purity scan, and a config validator to pass.
Plumbing & data
- System of record — the database that holds the authoritative state; if a fact isn't there, it isn't true.
- Stored procedure (SP) — the only way data is written: a procedure that checks the actor, makes the write idempotent, and appends an audit row.
- Write-path — the SP-mediated route every write takes; the same for agents and for the app.
- Base tables vs. views — base tables hold the data; "how we count tables" means base tables only, excluding views and other derived objects.
- Data API Builder (DAB) — the bridge that exposes the database's write-path to agents through a standard tool interface.
- MCP server — a tool server the agents use to reach a system (the database, the work-item tracker, and others) through a standard protocol.
- Managed identity — the keyless way the app and agents authenticate to Azure: a directory-bound identity and a short-lived token, never a stored password.
- Sensitivity label — a classification on a document that controls who may read its contents.