The prompt is no longer the product; the harness is. The first wave of AI engineering treated prompts as the main leverage point. That made sense when the model only returned text. Coding agents changed the boundary. They run tools, inspect repositories, execute tests, open pull requests, and carry observations forward.

Situation

The first wave of AI engineering treated prompts as the main leverage point. That made sense when the model only returned text. Coding agents changed the boundary. They run tools, inspect repositories, execute tests, open pull requests, and carry observations forward.

The pattern matters for database, cloud, and platform teams because agents do not operate in a vacuum. They inherit repository rules, tool permissions, deployment workflows, incident history, and the quality of the evidence available to them.

Operating layerDefault approachBetter alternative
ContextRely on a long prompt or chat historyGive the agent task-specific evidence and rules
ToolingExpose broad tools and inspect laterExpose narrow tools with clear approval boundaries
VerificationRead the final answerCheck the artifact, trace, and final state

The Problem

Prompt improvement alone cannot make that system safe. A better instruction cannot compensate for missing scripts, unreadable logs, broad permissions, stale repository context, or weak review loops.

The practical question is not whether an agent can produce a convincing response. The question is whether the engineering system around that response makes the work observable, reversible, and reviewable.

Failure pointWhat breaksWhy it matters
Weak boundaryAgent authority is broader than the taskA diagnostic run can become an unsafe change
Missing evidenceThe agent cannot cite the state it usedReview becomes opinion instead of verification
No lifecycleThe workflow ends at a messageOwnership, audit, cleanup, and rollback disappear

Harness Engineering

Harness engineering is the work of designing the execution environment around the model: context assembly, tool access, local scripts, review agents, telemetry, and approval gates.

flowchart TD
    A[task request — bounded intent] --> B[harness engineering — controls]
    B --> C[tool execution — evidence collected]
    C --> D[verification — final state checked]
    D --> E[human handoff — audit retained]
  1. Define the operating boundary.
    Write down the task class, allowed tools, environment, data class, and approval mode before the agent runs.

  2. Shape the evidence.
    Return compact observations instead of raw dumps. The agent should see enough to reason, but not so much that context is wasted.

  3. Require proof of completion.
    Completion should be an artifact or state check: a passing test, a reviewed plan, a valid rollback, a trace, or a linked ticket.

Treat the harness as platform code. Version it, test it, observe it, and review it when it changes.

In Practice

Context: OpenAI’s harness engineering post makes the point directly: productivity comes from the surrounding system, including PR loops, repo tools, local scripts, app metrics, logs, UI legibility, and agent-to-agent review. Source: OpenAI, Harness engineering.

Action: Treat the harness as platform code. Version it, test it, observe it, and review it when it changes.

Result: When the same model behaves differently across repositories, the difference is usually the harness: instructions, tools, scripts, and available evidence.

Learning: Harness engineering is the work of designing the execution environment around the model: context assembly, tool access, local scripts, review agents, telemetry, and approval gates. This is a documented pattern or a direct consequence of how the named systems behave, not a fabricated production story.

Where It Breaks

Failure modeTriggerFix
Prompt-only strategyTeams keep editing text while tools stay chaoticDesign the full execution harness
Unreadable systemLogs and tests cannot be consumed by agentsMake outputs structured and short
No review loopAgent work relies on human rereadingAdd specialized review passes
Harness driftLocal scripts change without agent guidanceVersion and test harness assumptions

What to Do Next

  • Problem: Prompt improvement alone cannot make that system safe. A better instruction cannot compensate for missing scripts, unreadable logs, broad permissions, stale repository context, or weak review loops.
  • Solution: Harness engineering is the work of designing the execution environment around the model: context assembly, tool access, local scripts, review agents, telemetry, and approval gates.
  • Proof: When the same model behaves differently across repositories, the difference is usually the harness: instructions, tools, scripts, and available evidence.
  • Action: List the tools, scripts, repo instructions, logs, and approval steps an agent needs for one real engineering workflow.

The teams that get value from agents will not be the teams with the longest prompts. They will be the teams that turn agent work into a controlled engineering workflow.