A practitioner framework for governing systems in which multiple agents, tools, memories, and human principals exchange information or authority.
The repository focuses on the questions that simple “human in the loop” or “trusted agent” labels leave unanswered: what can each component actually do, whose authority is it exercising, how does one agent’s output propagate into another agent’s action, and how can the workflow be contained when evidence or control fails?
| Artifact | Use it for |
|---|---|
docs/authority-and-containment.md |
describing authority envelopes, propagation controls, containment, and recovery |
docs/nist-rmf-mapping.md |
practitioner cross-reference to selected NIST AI RMF concepts |
agent-orchestration |
control-flow patterns |
agent-eval |
evaluation evidence and decision semantics |
agent-simulator |
runnable bounded workflow examples |
Multi-agent systems can create risk through composition even when each component looks acceptable in isolation.
Governance must therefore cover the interaction graph, not only the individual agents.
A global label such as trusted, semi-trusted, or untrusted is rarely precise enough. Describe each component across these dimensions:
| Dimension | Example distinctions |
|---|---|
| Principal | named user, service account, organization, unknown source |
| Role | planner, router, executor, reviewer, monitor, memory service |
| Data reach | public, tenant-scoped, sensitive fields, cross-tenant, no data |
| Action authority | read, draft, submit, approve, publish, delete, purchase, execute |
| Externality | private/reversible, internally visible, externally visible, financial, physical |
| Delegation | none, allow-listed, recursive, capable of granting new authority |
| Persistence | stateless, session memory, durable memory, configuration or credential write |
| Validation | executable checks, independent review, human authorization, none |
| Isolation | sandbox, network boundary, tenant boundary, direct production access |
| Revocation and recovery | immediate, delayed, partial, irreversible, unknown |
Authority should be enforced by identity, data, and tool controls rather than relying on a prompt to remember its limits.
An authority envelope defines the actions an agent may take under stated conditions.
For every authority-bearing agent, record:
See the worked structure in docs/authority-and-containment.md.
A controlled workflow separates several transitions:
request
↓
propose ──► validate ──► authorize ──► execute ──► verify ──► record
│ │ │
└─ reject └─ defer └─ contain / recover
For each transition, define:
A “validator agent” is not automatically independent. Independence can be weakened by common models, prompts, retrieval, context, rubrics, and incentives.
When one agent consumes another agent’s output, specify:
No agent should gain authority merely because another agent emitted authoritative-sounding text.
“Human in the loop” is not a complete control description. Record:
For high-consequence actions, separate proposal, authorization, and execution so an approval can be independently attributed and revoked where possible.
Every authority-bearing workflow should have a tested response for:
A rollback plan that only restarts the orchestrator is insufficient when delegated work or external actions may continue.
Do not use fixed percentages as universal alert thresholds. Derive thresholds from the workflow’s authority, service objectives, baseline, and harm model.
Monitor:
| Level | Signals |
|---|---|
| Agent | invalid outputs, tool errors, retries, refusal and escalation reasons |
| Interaction | delegation depth, authority transitions, disagreement, propagation failure |
| Workflow | completion, partial execution, recovery, human intervention |
| Control | denied calls, bypass attempts, confirmation failures, revocation health |
| Outcome | user correction, unauthorized action, incident, harmful external effect |
Interpretation matters. A rising escalation rate can indicate safer caution, degraded capability, workload shift, or a broken dependency.
| Gate | Evidence expected |
|---|---|
| Purpose and authority review | intended use, prohibited use, authority envelopes, principal model |
| Component evaluation | task and failure evidence for each material component |
| Interaction evaluation | propagation, disagreement, common-mode, and cascading-failure scenarios |
| Control verification | identity, permission, confirmation, revocation, and containment tests |
| Operational readiness | monitoring, incident ownership, recovery exercise, change process |
| Decision review | residual risks, conditions, owners, and re-evaluation triggers |
The gate outcome should distinguish blockers, evidence gaps, required actions, conditions, and accepted residual risks rather than returning a vague pass/fail label.
Maintain a versioned record of:
This is a practitioner governance framework, not a formal assurance case, certified control system, or proof that emergent behavior has been fully characterized. Adapt it to the actual authority, externality, jurisdiction, and operational environment.
References to NIST AI RMF are practitioner mappings and should be verified against official material.
| Repository | Distinct role |
|---|---|
agent-orchestration |
routing, delegation, validation, and failure-handling patterns |
agent-eval |
defensible evaluation design and release-decision semantics |
agent-simulator |
runnable bounded retries, fallback, and escalation |
mcp-agent-risk-checklist |
tool-server and agent-integration risk review |
Maintained by Sima Bagheri.