HARNESSCHOICE
An architecture conversation · research snapshot 2026-08-23

Models aren't the whole system.
You're also choosing a harness.

The industry has spent two years comparing models. Meanwhile, two applications running the same model deliver measurably different outcomes — different success rates, different costs, different failure modes — because of the system wrapped around it. That system now has a name, a discipline, and a market. This is a framework for choosing yours.

××××=Outcomereliable work
Context, tools, memory, orchestration, permissions, verification, recovery, cost control — the multiplier this site is about.
02Definition

What is a harness?

Between the application your users see and the model you rent sits a layer most architecture diagrams leave blank. Microsoft now ships a product called an Agent Harness; OpenAI named the discipline harness engineering; Anthropic's Agent SDK is one. Click each layer to place the boundary.

User
A person — or another agent — with a job to be done
Application
Where intelligence becomes business value
This decision
Harness
The system that turns intelligence into reliable work
Model · Tools · Data
Raw capability: intelligence, actuators, knowledge

Harness

Everything between the application and the raw model: context assembly, tool execution, memory, orchestration, state, permissions, verification, guardrails, observability, recovery, and cost control. This layer is the site's subject — and the decision most enterprises haven't consciously made.

  • Context & memory
  • Tool execution
  • Orchestration & state
  • Permissions & guardrails
  • Verification & observability
  • Recovery & economics
Architect view
Microsoft's definition is the cleanest: runtime scaffolding that drives model and tool calls, manages state and context, applies approval policies, and keeps multi-step tasks progressing. Decide which of its eleven capabilities are platform-shared vs workload-specific.
The model
provides intelligence

Reasoning, language, code, judgment — rented by the token from a fast-moving market.

The harness
operationalizes it

Decides what the model sees, what it can do, how work proceeds, what it may never do, and how you know it worked.

The application
delivers the value

The experience or process where converted intelligence meets a business metric.

Idea

The model provides intelligence. The harness determines how that intelligence operates. The application determines where it creates value.

03Taxonomy

Inside the harness: eleven capabilities

A production-grade harness answers eleven questions — from what does the model need to know? to what does a successful task cost? Every team that ships an agent answers all eleven, deliberately or by accident. Explore each layer at your altitude.

Context

What does the model need to know right now?
Architect viewContext engineering is a pipeline: system instructions, user/session context, retrieval over enterprise data, dynamic assembly per step, compression when the window fills, caching of stable prefixes, and prioritization when candidates exceed budget. Anthropic frames this as managing the model's 'attention budget' — more context is not more accuracy.
System instructionsRetrieval / RAGAgentic searchDynamic assemblyCompactionPrompt cachingJust-in-time fetching
Without it: The model guesses. Hallucinated policy, stale data, bloated prompts — and token spend that grows with every feature.
Idea

Your teams are already answering these eleven questions — one improvised answer per team. Harness choice is deciding which answers become shared infrastructure.

04Evidence

Same model, different harness, different outcome

This stopped being a hunch in 2026: benchmarks now score model + harness pairs, and a cluster of research measured what happens when you hold the model constant and swap only the harness. The exhibits below carry their sources and their caveats.

Tokens per solved task: up to 40× apart
Two models run through three open-source harnesses on a Terminal-Bench Pro subset: pass rates moved 0–8 pp, but tokens per solved task varied by up to 40× — harness choice moved cost an order of magnitude more than success.
Most efficient harness1 × tokens/solved task
Middle harness8 × tokens/solved task
Least efficient harness40 × tokens/solved task
Bars are illustrative of the reported spread (up to 40×), not per-harness figures from the paper.
Same model, +7.3 points from a harness swap
With the model held constant, swapping only the harness raised Terminal-Bench 2 pass@1 from 69.7% to 77.0%. The same paper cites 11–15 pp of scaffold-only variation on SWE-bench Verified.
Harness A (same model)69.7 % pass@1
Harness B (same model)77 % pass@1
Position paper; the SWE-bench range cites third-party leaderboard monitoring.
Home-harness advantage on Terminal-Bench
Leaderboard analyses report the same frontier models scoring several points higher in their native harnesses than in the neutral Terminus 2 reference harness — e.g. a ~7-point gap for one frontier model between its own CLI and the reference harness.
Native harness83.4 % (reported)
Reference harness (same model)76.4 % (reported)
Secondary-source figures; gap size varies by model (0.2–7 pts). Verify against the live leaderboard before quoting.
Tool plumbing: −98.7% context overhead
Anthropic's code-execution-with-MCP pattern — the agent writes code against MCP servers instead of loading every tool schema — cut tool-definition overhead from ~150k tokens to ~2k in their published example.
Direct tool definitions150 k tokens
Code execution over MCP2 k tokens
Vendor example with a large tool surface; savings scale with tool count.
Idea

A model benchmark that doesn't disclose its harness is quoting a different test — and a cost-per-token comparison that ignores harness efficiency can be wrong by an order of magnitude.

05Workloads

Choose your workload — watch the requirements move

"Which harness?" is a workload question before it is a vendor question. Coding lives on verification loops; enterprise search lives on identity-aware retrieval; business process agents need nearly everything at full strength. Select a workload to see which capabilities carry it.

Coding

The clearest demonstration of harness differentiation in the market.
Repository contextShell accessTests as ground truthLong-running tasksVerification loops
Coding won first because the harness gets verification for free: compilers, tests and linters give every step a pass/fail signal. Repo-scale context assembly and safe shell/tool access do the rest — which is why the same model scores differently in different coding harnesses.
Common harnesses today: Claude Code · Codex · Antigravity · Cursor · OpenHands · Copilot coding agent
What the harness must be good at here
Context
5/5
Tools
5/5
Evaluation & Verification
5/5
Orchestration
4/5
State
4/5
Recovery
4/5
Economics
4/5
Memory
3/5
Identity & Permissions
3/5
Guardrails
3/5
Observability
3/5
Idea

Workloads disagree about what matters. A single enterprise harness standard either over-constrains your easy workloads or under-protects your hard ones — standardize the control plane, vary the harness.

06Landscape

Six philosophies of the harness

The major ecosystems are not interchangeable products with different logos — they occupy different layers and encode different bets. Facts below are sourced; interpretation is labeled as ours. Snapshot: 2026-08-23.

Full stack, open seams — every layer offered, every layer separable.
Application / surface protocols
MCP (50+ managed servers) · A2A (donated to Linux Foundation) · AP2 payments
Managed runtime
Agent Engine (Sessions, Memory Bank, sandboxed code exec) inside Gemini Enterprise Agent Platform
Harness
ADK (Python/Go/Java/TS, graph runtime in 2.0) · Antigravity harness for coding
Models
Gemini 3.x family + 200-model garden incl. Claude, Llama, Mistral
Context · vendorMemory · vendorTools · sharedOrchestration · sharedState · vendorIdentity & Permissions · vendorEvaluation & Verification · vendorGuardrails · vendorObservability · vendorRecovery · sharedEconomics · shared
Fact
  • At Cloud Next '26 (Apr 2026), Vertex AI was consolidated into the Gemini Enterprise Agent Platform: Agent Studio, Registry, Identity, Gateway, Observability, Simulation. Google Cloud Next '26 recap, 2026-04
  • ADK 2.0 (May 2026) replaced the hierarchical executor with a graph-based workflow runtime; ADK ships in four languages with built-in eval and A2A interop. adk.dev 2.0, 2026-05
  • IAM Agent Identity gives each agent its own trackable identity (mTLS certs rotating every 24h, tokens cryptographically bound); Agent Gateway enforces policy on agent traffic; Model Armor screens prompts and tool traffic. IAM Agent Identity docs, 2026
  • Apigee converts existing API specs into governed MCP tools and syncs API hub with the Agent Registry, so agents discover only cataloged, policy-wrapped tools. Apigee MCP support, 2026
Interpretation (analyst)

Google is betting that the enterprise control plane — identity, tool governance, observability, data — is the durable layer, and keeps model, framework and runtime swappable around it. Selling Claude in its own model garden and donating A2A are consistent with that bet.

Implication for buyers

Strong fit if you want managed harness infrastructure without committing the application layer to one vendor's models. The naming churn (Vertex AI → GEAP) is real migration work; pin product names in contracts.

Portability — models: High — 200+ models incl. Anthropic and open weights on the same plane. Harness: Medium — ADK is open source and runs anywhere; Agent Engine services are Google-managed. Tools: High — MCP everywhere; Apigee wraps existing APIs without rewrites.

Idea

Don't ask "which vendor wins." Ask which layers each vendor wants to own, and whether that matches the layers you want to keep.

07Sourcing

Build, framework, platform — or borrow a specialist

"Should we build our own harness?" is really eleven questions wearing one coat. Four sourcing postures dominate; none is universally right. Compare their trade-offs, then open the full evaluation checklist.

Build custom

Your own orchestration and runtime
Control
Speed
Portability
Reliability
Ops burden

Open framework

LangGraph, ADK, CrewAI, Agent Framework OSS…
Control
Speed
Portability
Reliability
Ops burden

Managed platform

An opinionated enterprise agent runtime
Control
Speed
Portability
Reliability
Ops burden

Application-specific

A purpose-built harness for one job
Control
Speed
Portability
Reliability
Ops burden
Best when
  • Time-to-production and fleet governance outrank bespoke control
  • You need identity, policy, observability and evals as products, not projects
  • Dozens of teams will build agents and you want one control plane
In the market
  • Gemini Enterprise Agent Platform
  • Bedrock AgentCore
  • Foundry Agent Service
  • OpenAI Frontier
Watch out
Portability concentrates at the runtime: the loop may be open source, but sessions, memory, identity and policy configs are platform-shaped. Know your exit story before you need one.

The house view: this is not one decision but eleven. Build the loop only where it differentiates; buy identity, observability and policy everywhere; and let workloads with mature dedicated harnesses (coding) use them — under shared governance.

Idea

Build the loop only where it differentiates you. Buy identity, observability and policy everywhere. And when a workload has a world-class dedicated harness — coding — adopt it under shared governance instead of rebuilding it worse.

08Pairing

Model + harness: evaluate the pair, plan the divorce

The frontier is re-fusing model and harness — vendors now train models inside their own harnesses — while the middle of the market goes model-agnostic. Pick your posture on each axis and see what the combination commits you to. Then: the six forms of portability, honestly.

Model posture
Harness posture
The pragmatic enterprise center

Route cheap steps to fast tiers and hard steps to frontier models, under one identity/policy/observability plane with cost-per-task instrumentation built in. Most large estates land here for the bulk of workloads — with dedicated harnesses carved out where they demonstrably win (coding).

Cost-per-task engineering is native hereWatch runtime coupling: sessions, memory, policy configsCarve-outs for specialized harnesses are healthy, not failures

“If models keep changing, how do we avoid rebuilding everything?”

Portability isn't one property — it's six, and they behave very differently. Click each to see where coupling actually occurs.

Model portabilitymedium coupling
Can I move from Gemini to Claude to an open model?
Harness portabilityhigh coupling
Can the same application move between agent runtimes?
Tool portabilitylow coupling
Can tool integrations be reused across agents and vendors?
Context portabilitylow coupling
Can enterprise knowledge and retrieval stay independent?
Protocol portabilitylow coupling
What do MCP and A2A actually buy me?
Cloud portabilitymedium coupling
What actually remains portable versus cloud-specific?
Idea

Evaluate models together with their harnesses — that pair is what you actually deploy. Then engineer your exit paths deliberately: portability is six different properties, and only some of them are cheap.

09Google Cloud

The harness stack, mapped to Google Cloud

Requirement first, product second: each of the eleven capabilities, Google's architectural approach to it, and the services involved — including where third-party models, open frameworks and custom harnesses are first-class citizens rather than workarounds.

Context
Assemble grounded, governed, cache-efficient context

Managed retrieval as a service (enterprise search + RAG orchestration), grounding on Google Search and Maps, and native context caching so stable prefixes get ~90% cheaper reads.

Vertex AI SearchRAG EngineGrounding with Google SearchContext caching
◇ Open seam: Retrieval APIs work with any model in Model Garden — including Claude — and with custom harnesses.
Memory
Persist session, user and task memory with governance

Memory as a managed runtime service rather than app code: sessions for working state, Memory Bank for topic-extracted long-term memory across sessions.

Agent Engine SessionsAgent Engine Memory Bank
◇ Open seam: Consumable from ADK, LangGraph or CrewAI agents deployed on Agent Engine.
Tools
Expose enterprise systems as governed tools

Treat tools as API products: Apigee converts existing API specs into managed MCP tools with policy attached, and API hub syncs with the Agent Registry so agents discover only cataloged tools. 50+ Google-managed MCP servers cover BigQuery, Maps, databases.

Apigee MCPAPI hub ↔ Agent RegistryManaged MCP servers
◇ Open seam: MCP end-to-end: tools built here are consumable by any MCP client, including non-Google harnesses.
Orchestration
Deterministic workflows plus agentic freedom, multi-agent ready

ADK 2.0's graph-based workflow runtime blends deterministic routing (fan-out/fan-in, loops, retries, human-in-the-loop) with LLM-driven agents and sub-agent hierarchies; A2A handles agent-to-agent interop across vendors.

ADK 2.0A2A protocolAgent-to-Agent Orchestration (GEAP)
◇ Open seam: ADK is Apache-licensed and runs anywhere; A2A is vendor-neutral by governance.
State
Durable, resumable, long-running task state

Managed session persistence in the runtime plus sandboxed code execution; long-running work is a platform property, not per-team plumbing.

Agent Engine RuntimeSecure Sandboxes / Code Execution
◇ Open seam: Framework-agnostic deployment (ADK, LangGraph, CrewAI); Temporal-style external engines also integrate with ADK.
Identity & Permissions
Per-agent identity with delegated, auditable authority

Agents get first-class IAM identities — not shared service accounts — with mTLS certificates rotating every 24h and tokens cryptographically bound to them; the Agent Gateway enforces access policy on agent traffic; audit logs record agent and on-behalf-of user.

IAM Agent IdentityAgent GatewayContext-Aware Access
◇ Open seam: Identity plane covers third-party models and custom harnesses running on Google Cloud.
Evaluation & Verification
Score model-harness pairs before and during production

Evaluation as a service: LLM-judge and custom criteria over final responses and full trajectories, agent simulation for pre-production stress-testing, plus ADK's built-in eval harness for CI.

Gen AI evaluation serviceAgent Simulation (GEAP)ADK eval
◇ Open seam: Evaluates any deployed agent endpoint, including non-Gemini models.
Guardrails
Screen prompts, tools and outputs; contain injections

A dedicated screening layer (prompt injection, jailbreak, sensitive data, URLs) applied at the gateway and on MCP traffic, with streaming sanitization — independent of which model runs behind it.

Model ArmorAgent Anomaly DetectionSafety filters
◇ Open seam: Model Armor screens traffic for any model, including third-party and self-hosted harnesses.
Observability
Reconstructable trajectories and fleet dashboards

OpenTelemetry GenAI semantic conventions as the native format: Agent Engine auto-exports traces to Cloud Trace, console shows span DAGs with inputs/outputs, dashboards track token usage and error rates.

Agent Observability (GEAP)Cloud Trace + OTel
◇ Open seam: OTel-standard output ports to any observability backend you already run.
Recovery
Retries, fallbacks, human escalation as designed paths

Workflow-level retries and human-in-the-loop confirmation in ADK's runtime; model fallback via Model Garden breadth; escalation surfaces in Gemini Enterprise inboxes.

ADK workflow runtimeModel Garden routing
◇ Open seam: Recovery logic lives in open-source ADK code you can take anywhere.
Economics
Engineer cost per successful task, not per token

Structural levers: batch at flat −50%, context caching at ~−90% on cached reads, provisioned throughput for committed capacity, and a fast/cheap Flash tier for routing — plus per-trajectory token accounting in observability.

Context cachingBatch APIProvisioned ThroughputFlash model tier
◇ Open seam: Levers apply to Gemini; third-party models carry their providers' pricing on the same billing plane.
Why build the harness on Google Cloud?
  • Requirement-first coverage: all eleven harness layers have a managed answer, and none of them requires the others — adopt the gateway without the runtime, the evals without the models.
  • Open seams are structural, not marketing: Claude and 200+ models sell in the garden, ADK is Apache-licensed, MCP is native, and A2A was donated to the Linux Foundation.
  • The control plane is the differentiator: per-agent IAM identity, Apigee-governed tools, Model Armor screening and OTel-native observability form the most complete agent security story of the major clouds (analyst judgment).
  • Where you land depends on posture: custom harness on GCE/GKE, open framework on Agent Engine, or fully managed in Gemini Enterprise — all three are supported paths, not workarounds.
Idea

The question isn't "does Google have an agent product" — everyone does. It's whether you can adopt the layers you need, keep the layers you have, and swap the layers you'll regret. Open seams are the differentiator.

10Economics

The cheapest model is not the cheapest task

Procurement compares dollars per million tokens. Production pays for context re-sent every turn, cache misses, extra turns, retries and failures. Move the sliders — the interesting moment is when the cheaper-per-token profile loses on cost per successful task.

Model cost×Harness efficiency×Success rate=Effective task economics
Challenger profile
Re-sends bloated context, no caching discipline, no verification
Efficient harness · frontier modelcheaper / task
$0.744 per successful task
$0.670 per attempt · 1.10 attempts expected · 99% end up succeeding · 1.10M tokens/attempt
Naive harness · frontier model
$4.25 per successful task
$2.63 per attempt · 1.52 attempts expected · 95% end up succeeding · 1.40M tokens/attempt
Read it like a CFO:the anchor profile pays frontier prices but caches 90% of its input, verifies before finishing, and rarely retries. Try dropping the challenger's input price to $0.50 — then watch what its cache misses, extra turns and retries do to the number that matters. Research context: harness choice alone has produced up to 40× differences in tokens per solved task with pass rates nearly unchanged (arXiv:2607.22585), and cached reads price ~90% below uncached on major platforms. Figures here are illustrative profiles, not vendor measurements — plug in your own.
Idea

Buy outcomes, not tokens: cost per successful task — across turns, retries and cache economics — is the metric that survives contact with production.

11Patterns

Reference architectures

Four hypothetical but realistic enterprise patterns. Each flow highlights which harness capabilities do the heavy lifting — the boxes that turn a demo into a system you can audit, afford and trust.

An analyst asks for a competitive briefing. The agent plans, fans out across web and internal sources, verifies claims, and returns a cited brief.

actorAnalyst
question
appResearch app
harnessHarness · plan → fan out → verify
route by step
modelFrontier model (+ fast model for triage)
toolSearch · browser · internal corpus
dataCited brief
OrchestrationPlanner decomposes; subagents read sources in parallel with isolated context; a synthesizer merges.
ContextCompaction keeps hour-three synthesis aware of hour-one findings without blowing the window.
Evaluation & VerificationEvery claim in the brief must trace to a fetched source; unverified claims are flagged, not dropped silently.
EconomicsCheap model triages sources; the frontier model only reads what survives triage.
Why the architecture matters: The deliverable is trust, not text. Without verification and citations this is confident summarizing; with them it replaces days of analyst work.
Idea

In every one of these diagrams the model is one box. The reliability, the safety and the economics live in the boxes around it.

12Assessment

Where does your harness stand today?

Eleven questions, four maturity levels each. Score your current architecture honestly — the profile on the right shows where you're engineered and where you're improvising. Nothing you click leaves this page.

How does enterprise knowledge reach your models?
What persists across sessions today?
How do agents reach enterprise systems?
How does multi-step work happen?
Can a task survive an interruption?
Whose authority does an agent act with?
How do you know an agent change is safe?
Where are 'must never' rules enforced?
Can you reconstruct what an agent did last Tuesday?
What happens when an agent fails mid-task?
What does a completed task cost?

Your harness profile

0 = improvised · 3 = engineered. Scores stay in your browser.
Context
Memory
Tools
Orchestration
State
Identity & Permissions
Evaluation & Verification
Guardrails
Observability
Recovery
Economics
Reading: Answer all 11 to see your profile (0 done).
Idea

You've been deciding which model to standardize on. You should also be deciding what harness architecture you're standardizing around — and this profile is where that conversation starts.