Skip to content

Governed Agent Harness

A local control plane for AI-assisted software development. It is not an agent and not a model: it takes a structured task, drives it through nine normative phases that cannot be removed, grants capabilities deny-by-default, runs validators without a shell, computes the exact set of changes owned by the run against a baseline (the ChangeSet), records hash-chained events, evaluates a fail-closed gate and requires a human decision bound to the ChangeSet digest. If the code changes afterwards, the approval no longer applies.

Warning

Research beta. It is not a sandbox: a process the harness launches keeps the file-system, network, CPU and memory permissions of your user. The local dashboard requires a local bearer token only under the api section that harness init writes (none without it) and must stay on loopback.

A narrative instruction versus an applied control

"Run the tests" in a prompt The same rule in the harness
The agent may or may not run them VERIFICATION is a mandatory phase of every run
"Tests passed" is a claim in the transcript python.pytest is a mandatory validator; its exit code, stdout and stderr are stored as content-addressed evidence
A missing tool looks like success or is ignored A non-success result never becomes success; the gate fails closed
Approval is about "the task" Approval is bound to the digest of the exact ChangeSet, configuration and policy

Normative phases

flowchart TB
  I[INTENT] --> D[DISCOVERY]
  D --> S[SPECIFICATION]
  S --> P[PLANNING]
  P --> M[IMPLEMENTATION]
  M --> V[VERIFICATION]
  V --> R[INDEPENDENT_REVIEW]
  R --> C[DECISION]
  C -->|approve| X[CLOSURE]
  C -->|authorized correction| M
  X -. post-run .-> T[RETROSPECTIVE]

Architecture

flowchart TB
  CLI[CLI] --> APP[Application use cases]
  API[Local API and dashboard] --> APP
  APP --> ORCH[Workflow orchestrator]
  ORCH --> DOMAIN[Domain + state machine]
  ORCH --> GATES[Gate and policy engines]
  ORCH --> PORTS[Ports]
  PORTS --> RUNTIME[Trusted runtime adapters]
  PORTS --> STORES[Event and artifact stores]
  PORTS --> EXT[Extension client/SDK]
  CONFIG[Workflow + profiles + project config + locked policy] --> APP
  EXT --> PY[Python profile/extensions]
  EXT --> NODE[Node profile/extensions]
  EXT --> AGENT[Agent provider]
  EXT --> REPORT[Reporter]

Where to start