Agent Behaviour Policy: <pipeline>@<Team>.<person>

Status: template (copy this file to abp/<pipeline>.md next to the workflow it binds, replace every <...>, and set the status to proposal). Phase: observe (a pipeline starts in observe; its first enforce step is almost always a narrower token).

A pipeline is an agent without a conversation: it acts on every push, with whatever its token can reach. Write its policy the same way (CI behaviour policies). Deny by default. Format: the AgentiCCells ABP format.

Mandate

Reach (what its tokens can actually do)

List every secret the workflow can read (names only), the scopes of each token or GitHub App installation, the cloud roles, and who can change the workflow file itself (a pull request that edits the workflow runs with its secrets unless the repository stops it).

WhatHowEvidence
<administer every repository in the organisation><GitHub App installation, permissions>measured
<change any record in the DNS zone><cloud role>measured
<who can edit this workflow><branch protection, CODEOWNERS>measured

Capabilities

IdCapabilityTargetTierUndoDecisionBarrierEnforcerMode
C1create.repository.tenant<one repository per approved request>3with-effortplan-applysetting<a broker that holds the create-only token>observe
C2write.dns.tenant<one record per request, in one zone>3with-effortplan-applysetting<a DNS broker that checks the target, because IAM cannot>observe
C3delete.repository.tenantany repository3nodenyboundary<not in any token>enforce
C4write.workflow.projectthe workflow files that hold the secrets3with-effortdenysetting<CODEOWNERS and branch protection, owned by a person>observe

Limits: <at most N repositories a day; one DNS record per request; names must match the request>. Tests: <the broker's log against the approved requests; the token's scopes read back from GitHub each week>.

Never

IdNeverBarrierEnforcerModeTest
N1Delete a repositoryboundary<no token has the scope>enforce<read the scopes back>
N2Point a name outside the approved targetssetting<the DNS broker's allowlist>observe<zone diff against requests>
N3Run a workflow changed in the same pull request with production secretssetting<repository settings for pull requests from forks and branches>observe<settings read back>
N4Print a secret into a logsetting<masking and the leak scan>observe<log scan>

Gap

Observe to enforce

Licence to operate

The policy as data

{
  "format": "agenticcells-abp/0.1",
  "id": "<pipeline>@<Team>.<person>",
  "kind": "pipeline",
  "version": "<0.1.0>",
  "status": "template",
  "phase": "observe",
  "default": "deny",
  "owner": "<person>",
  "keeper": "<who keeps this file>",
  "reviewer": "<specialist.abp@AgentiCCells.dinis>",
  "updated": "<YYYY-MM-DD>",
  "mandate": { "task": "<task>", "scope": "<scope>", "purpose": "<purpose>", "words": "<words>", "given": "<YYYY-MM-DD HH:MM UTC>" },
  "reach": [
    { "what": "<administer every repository>", "how": "<App permissions>", "evidence": "measured" },
    { "what": "<who can edit the workflow>", "how": "<settings>", "evidence": "measured" }
  ],
  "capabilities": [
    { "id": "C1", "capability": "create.repository.tenant", "target": "<one per request>", "tier": 3, "undo": "with-effort", "decision": "plan-apply", "barrier": "setting", "enforcer": "<broker>", "mode": "observe", "test": "<broker log against requests>" },
    { "id": "C2", "capability": "write.dns.tenant", "target": "<one record per request>", "tier": 3, "undo": "with-effort", "decision": "plan-apply", "barrier": "setting", "enforcer": "<DNS broker>", "mode": "observe", "test": "<zone diff>" },
    { "id": "C3", "capability": "delete.repository.tenant", "target": "any repository", "tier": 3, "undo": "no", "decision": "deny", "barrier": "boundary", "enforcer": "<no token has the scope>", "mode": "enforce", "test": "<scopes read back>" },
    { "id": "C4", "capability": "write.workflow.project", "target": "workflow files", "tier": 3, "undo": "with-effort", "decision": "deny", "barrier": "setting", "enforcer": "<CODEOWNERS, branch protection>", "mode": "observe", "test": "<settings read back>" }
  ],
  "never": [
    { "id": "N1", "rule": "Delete a repository", "barrier": "boundary", "enforcer": "<no token has the scope>", "mode": "enforce", "test": "<scopes read back>" },
    { "id": "N2", "rule": "Point a name outside the approved targets", "barrier": "setting", "enforcer": "<DNS broker allowlist>", "mode": "observe", "test": "<zone diff>" },
    { "id": "N3", "rule": "Run a workflow changed in the same pull request with production secrets", "barrier": "setting", "enforcer": "<repository settings>", "mode": "observe", "test": "<settings read back>" },
    { "id": "N4", "rule": "Print a secret into a log", "barrier": "setting", "enforcer": "<masking, leak scan>", "mode": "observe", "test": "<log scan>" }
  ],
  "gaps": [
    { "id": "G1", "what": "<token wider than one run>", "evidence": "<evidence>", "proposal": "<broker or narrow token>", "status": "open" }
  ],
  "enforce_plan": { "first": ["<G1>"], "trigger": "<trigger>", "escape_valve": "<escape valve>" },
  "licence": { "authority": "<person>", "licensee": "<pipeline, workflow, token>", "conditions": "<gates>", "validity": "<from date>", "review": "<weekly scope read-back>", "stop": "<disable the workflow>" }
}

Record

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