The AgentiCCells ABP format, version 0.1

One way to write an Agent Behaviour Policy, for an agent, a pipeline or an AgenticCell. By specialist.abp@AgentiCCells.dinis, 16 November 2026. Approved by Dinis Cruz (to cell.email on 16 November, and to this specialist on 19 November 2026: "Yes, I approve it").

It is not new. It joins three things that already worked, so that a policy written by any team reads, and checks, the same way:

The page, in this order

  1. Title: # Agent Behaviour Policy: <id>.
  2. Status line: **Status: proposal** (or template, approved, retired). A policy is a proposal until its person approves it.
  3. Phase line: **Phase: observe** (or enforce, mixed). Say plainly whether anything blocks.
  4. Mandate: task, scope, purpose, and the person's own words with the time they were given. The mandate is written by a person, never by the agent alone.
  5. Reach: what the agent can actually do, each line with how and with its evidence: measured (probed), observed (seen in a run), documented (the vendor says so), inferred, or not-checked. Reach is measured, not assumed.
  6. Capabilities: one row per capability, with tier, undo class, decision, barrier, enforcer, mode and test (below).
  7. Never: one rule per row, each with its barrier, enforcer, mode and a test anyone can run.
  8. Gap: what the agent can reach beyond its mandate. Derived from reach and mandate, never invented; each gap with evidence, a proposal and a status (open, closed, or accepted by a named person).
  9. Observe to enforce: which rules become boundaries first, what triggers it, and the escape valve.
  10. Licence to operate: authority, licensee (agent, session, key), conditions, validity, review, and who can stop it.
  11. The policy as data: one JSON block that says what the tables say. scripts/abp-check.mjs reads it.
  12. Record: the version history.

The words, defined once

FieldValuesMeaning
kindagent, pipeline, cellwhat the policy binds
defaultdenyanything not listed is not allowed; there is no other value
capabilityverb.object.reachreach is one of self, project, host, tenant, world; use one of the 23 RiskMandate ids where one fits
tier1, 2, 3, 41 assist (read, summarise); 2 change its own work; 3 change a system of record (shared repository, CRM, DNS, a live release); 4 irreversible to the world (send, publish, spend) (where assist becomes execute)
undoyes, with-effort, nocan the same actor undo it without loss; at a cost; not at all. Reading is no: what was read can be repeated
decisionallow, draft, plan-apply, denytier 3 is never allow (plan, then something above the agent applies); tier 4 is never allow (a draft that a person acts on)
barriernothing, expectation, setting, boundarywhat really stands in the way: nothing; a rule in prose that only the agent keeps; a switch the agent's own account can flip; something enforced above the grant
enforcertextwho or what enforces it; for a boundary, something the agent's grant does not include
modeobserve, enforceobserve records and allows; enforce blocks. An expectation cannot be in enforce mode: nothing outside the agent can block it
testtexthow anyone checks the rule held, without asking the agent

What the checker refuses

node scripts/abp-check.mjs fails a policy that: has no data block or a block that does not parse; is not default: deny; leaves a required field empty; uses a word outside the lists above; allows a tier 3 or tier 4 capability; claims enforce for a rule with no enforcer; names the agent itself as the enforcer of a boundary; leaves an irreversible tier 3 or 4 capability open without a boundary; packs several rules into one row; accepts a gap without naming who accepted it; marks itself approved without saying who approved it, or is kept by the agent it binds; or whose page does not state the status and phase that its data states. It prints, for each policy, how many of its rules are boundaries, settings, expectations and nothing: the share of the policy that is hope.

Why each rule of the format

Each comes from something that went wrong or right; see the principles and the mistakes.

This page is generated from format.md, its Markdown twin.