Workshops/Governance

ADPS Pattern Workshop Series

First Governance Module Workshop

How action controls, agent fleets, and lifecycle fit one governance structure.

18 August 2026

The discussion covered dangerous tool calls, agent fleets, governance lifecycle, and organizational responsibility. Its conclusions changed the relationship between governance and the dual axis: observability moved to a cross-cutting plane, lifecycle became explicit, and local controls connected to registry, policy, enforcement, and evidence services.

1. Compliant actions can still drift from a long-running goal

The workshop separated action governance from goal governance. The first checks the current tool, arguments, authority, and preconditions. The second compares the original goal, current plan, completed artifacts, and real outcome across a long run. Every local action may pass while the task spends most of its time on an irrelevant branch.

This distinction led to three objectives: authorization, accountability, and containment.

2. A sandbox bounds reach; domain authorization decides this invocation

A sandbox isolates process, files, and network. It does not know whether the current user may change a business record or whether these arguments require review.

The same payroll tool can yield three different outcomes. Reading one's own payroll record may execute directly. Changing one employee's allowance requires fixed arguments and review. A batch payment above the daily ceiling is denied even when a reviewer is available. A sandbox cannot infer these domain distinctions.

The public DeerFlow Guardrail case provides inspectable implementation steps: a common pre-tool middleware, trusted Principal propagation, RunJournal, an independent RBAC provider, and shared policy across assembly and invocation.

3. Tool assembly is an intersection, not one allowlist

task needs
  ∩ tool group
  ∩ agent/subagent allow-deny
  ∩ active skill policy
  ∩ principal authorization
  = model-visible tools

Deferred discovery delays low-frequency tools. Discovery does not confer invocation authority.

An allowance change needs employee lookup, policy lookup, change preparation, review, and commit capabilities. Batch payment, employee deletion, and tenant administration should not become visible merely because they share a payroll tool package. The intersection is recomputed when task, role, or active skill changes.

4. Approval needs durable intent after the button

The difficult question was how to prove, after a long pause, that execution is still the action the reviewer saw. Tool versions, arguments, and resource scope can be frozen, while balance, inventory, date, and target versions continue to change.

The workshop therefore split the control into Intent, Approval, and Execution. Intent fixes the action and preconditions. Approval records reviewer, expiry, and single use. Execution revalidates on resume and records the external receipt. Domains still need to define which changed preconditions invalidate approval.

Suppose the reviewer approved “employee E-1842, transport allowance 800→1000, effective next month.” If the employee leaves, policy changes, or another request changes the current value to 900 during the wait, the old approval cannot be consumed unchanged. Execution compares the intent digest, resource version, and business preconditions before continuing, requesting new review, or terminating.

5. Observability does not fit one Governance × Orchestrate cell

Every topology needs evidence, including decentralized choreography. Observability also serves debugging, evals, product analysis, and evolution. The discussion used three levels: task and business outcome; agent process; and foundation health.

When an artifact cannot be scored immediately, downstream adoption can be useful evidence. Adoption is not correctness, but it is closer to business outcome than a page reaction.

6. Agent sprawl requires a control plane

As pilots multiply, governance covers duplicated capabilities, shared credentials, unowned agents, broken accountability across delegation, and queues or callbacks that survive an ended experiment.

Four enterprise components emerged: registry for identity, ownership, versions, tools, and retirement; policy for delegation, authority, risk, and exceptions; enforcement for filtering, tokens, sandboxes, quotas, and breakers; observation for joining runs, approvals, and outcomes.

Central infrastructure and domain ownership must work together. The central team maintains shared identity, formats, telemetry, and cross-domain audit. Domains retain risk, acceptance, approvers, and incident response.

Control-plane recordPayroll-agent content
RegistryAgent version, owner, callable capabilities, service identity, expiry
PolicyRead and mutation rights, amount and batch limits, review rules
EnforcementTool filtering, short-lived token, argument validation, pause, quota, breaker
EvidenceRequest provenance, policy version, intent, approval, receipt, after-read

7. Rules, model classification, and policy decision need separate roles

Deterministic rules cover enumerable hard conditions. Models can identify complex textual risk. Policy owns the final verdict. Rule order and conflict semantics must be explicit, because arguments, resources, and environments can change the risk of the same tool.

This separation also changes G5: a hook is an enforcement point, a provider supplies policy, a decision service issues the verdict, and G4 stores evidence.

8. Progressive commitment is capability-specific and bidirectional

One agent's query, validation, mutation, and release capabilities can require different tiers. The useful unit is agent version × capability × scenario × resource scope. Authority expands with evidence and contracts after incidents, version change, missing evaluation, missing ownership, or retirement.

9. Observation, evals, reflection, and governance form one change loop

observed facts → attribution → change knowledge/spec/tool/model/policy
               → eval and regression → release, demote, or roll back

Observation records facts. Evals judge them. Reflection proposes change. Governance decides who may make the change effective and what authority the changed capability receives. Offline trajectory evaluation spans all modules.

Approval, clarification, pause, takeover, resume, and explanation belong to the human-agent interaction plane. UI carries stateful runtime control, not presentation alone.

10. One payroll change through the governance structure

StageRuntime factMain control
IntakeChange one employee's transport allowance from 800 to 1000 next monthConfirm delegated identity, target, field, desired state, and non-goals
EvidenceCurrent state comes from the HR API; policy comes from a versioned knowledge sourceKeep mechanical state separate from policy evidence
PrepareThe agent creates a canonical intent with tool version, arguments, resource, and preconditionsG2 limits scope to one employee and one field
ApproveThe reviewer sees before, after, delta, effective date, policy basis, and scopeG1 issues an expiring, single-use approval
ResumeThe executor rereads employee state and policy versionChanged preconditions require new review or termination
ExecuteA short-lived credential commits the change; hooks run deterministic pre- and post-checksG5 enforces policy while G2 maintains quota and scope
AcceptTransaction receipt and after-read agree; the next payroll cycle enters reconciliationG4 links request, evidence, verdict, state delta, and external outcome
EvolveAnomaly enters regression; policy or tool change triggers revalidationG3 holds, promotes, demotes, freezes, or retires authority

The path makes the responsibilities visible. Approval handles one intent. Blast-radius limits remain active. Observability spans every stage. Progressive commitment governs authority across repeated runs. No single pattern replaces the lifecycle.

11. Changes adopted in v0.4

  1. Move G4 out of the Governance row into a cross-cutting core; retain 27 matrix patterns.
  2. Keep 28 core specifications and preserve G4's number and URL.
  3. Add lifecycle from registration and evaluation through operation, revalidation, demotion, and retirement.
  4. Add Intent, Approval, Execution, precondition review, and single use to G1.
  5. Add hard and autonomy envelopes plus fleet aggregation to G2.
  6. Make G3 capability-, scenario-, resource-, and version-specific and bidirectional.
  7. Separate policy source, decision, enforcement, and evidence in G5.

12. Open questions

Related pages

This public record is organized by engineering theme. It preserves technical questions, mechanisms, and disagreements while anonymizing internal organization names, operating scale, rules, and responsibility structures.