I03 · Platform architecture · 8 min read
Harness engineering is platform engineering
The model supplies capability. The harness determines whether that capability can plan, act, recover, prove, and stop inside a real engineering environment.
By AISDLC Editorial · Published 2026-08-08 · Reviewed 2026-08-09
Agentic engineering shifts a large share of reliability work into the environment around the model. The harness decomposes goals, presents tools, manages context, creates checkpoints, runs tests, handles failure, and decides when to continue, escalate, or stop. The execution substrate supplies the isolated workspace, filesystem, browser, network, identity, and compute in which those choices become effects.
A harness must make five promises
Five platform promises
- Legibility
- The agent can discover architecture, constraints, interfaces, tests, and current work without reconstructing the organization from chat.
- Boundedness
- Tools, network, credentials, compute, and side effects remain inside a declared execution envelope.
- Recoverability
- Progress and failures survive context resets; retries introduce new evidence instead of repeating the same action.
- Verifiability
- The harness exposes deterministic checks, evaluator interfaces, logs, and artifacts to independent challenge.
- Interruptibility
- Humans and policy systems can hold, narrow, revoke, or stop work at meaningful enforcement points.
These promises are platform responsibilities because every product team should not reinvent them. A reusable harness can standardize isolated workspaces, credential brokering, tool schemas, run manifests, checkpoint formats, evaluation hooks, and evidence emission. Product teams then specialize intent, domain context, tools, and acceptance criteria without rebuilding the control foundation.
Separate reasoning, action, and durable state
The reasoning model, execution environment, and durable session state change on different timelines. Treating them as one process makes upgrades fragile and incident recovery opaque. A strong architecture allows a model to be replaced, a workspace to be quarantined, or a session to be resumed without losing the attributable record of what happened.
The bounded run loop
- 01 · Plan Translate executable intent into bounded work units and explicit completion conditions.
- 02 · Provision Create an isolated substrate with purpose-bound identity, tools, data, network, and resource limits.
- 03 · Act Execute through typed contracts that preview and record consequential effects.
- 04 · Challenge Run deterministic checks and independent evaluators against outcome, trajectory, and policy.
- 05 · Checkpoint Persist progress, evidence, unresolved questions, and safe continuation state.
- 06 · Dispose Merge, escalate, quarantine, revoke, or destroy the workspace according to outcome.
Failure must be a first-class system state
Naive agent loops treat every failure as a reason to retry. Mature harnesses distinguish transient infrastructure failure, insufficient context, invalid intent, tool rejection, verifier disagreement, policy denial, and exhausted budget. Each state requires a different recovery action. Repeating the same plan after the same evidence is not resilience; it is an uncontrolled loop.
Agent wrapper
- Single prompt loop
- Shared developer workspace
- Static tool list
- Transcript as state
- Retry until completion
Enterprise harness
- Planner, executor, verifier, and disposition states
- Isolated task substrate
- Policy-filtered capability envelope
- Versioned checkpoint and run ledger
- Evidence-aware recovery and stop conditions
Platform backlog
- Repository and service legibility contract
- Isolated task environments and identity brokering
- Typed tool registry with effect classification
- Durable checkpoint and handoff format
- Independent evaluator interface
- Run ledger and evidence schema
- Budget, back-pressure, quarantine, and stop controls
Primary sources
- OpenAI — Harness engineering: leveraging Codex in an agent-first world
- Anthropic — Effective harnesses for long-running agents
- Anthropic — Harness design for long-running application development
- Google Cloud — Agent Sandbox on GKE and Agent Substrate
- OpenAI — An open-source spec for Codex orchestration: Symphony
AISDLC Insights publishes source-informed editorial synthesis and implementation positions. It is reference material, not a standard, certification, legal opinion, or authorization to deploy an agent.