Harness engineering

Definition

Engineering the agent loop, task decomposition, tools, permissions, session state, checks, retries, feedback, checkpoints, and stop conditions that surround a model. The model supplies capability; the harness turns capability into repeatable, inspectable work.

A fast-forming production discipline whose terminology is still new.

Why it matters

The model supplies capability; the harness turns capability into repeatable, inspectable work.

The operating shift is from “Tune the prompt” to “Engineer the working environment.”

System anatomy

Practice 1

Expose tests, logs, and interfaces directly to agents

Practice 2

Encode recovery and back-pressure

Practice 3

Make the repository legible to future agent runs

Important distinctions

Tune the prompt

This concept moves the engineering system toward engineer the working environment.

Implementation signals

• Expose tests, logs, and interfaces directly to agents
• Encode recovery and back-pressure
• Make the repository legible to future agent runs

Failure modes

• Retry loops without new evidence
• A powerful model operating in an underspecified environment

Sources and further study

1. OpenAI — Harness engineering: leveraging Codex in an agent-first world

   A production case study in designing repositories, tools, feedback loops, and environments for agent-first delivery.

   Use in this library: First-party case study. This first-party account documents one organization, product, or implementation context and should not be generalized without local evidence.

   engineering · engineering · Published 2026-02-11
2. Anthropic — Effective harnesses for long-running agents

   Patterns for incremental progress and durable handoffs across context windows and extended execution.

   Use in this library: First-party case study. This first-party account documents one organization, product, or implementation context and should not be generalized without local evidence.

   engineering · engineering · Published 2025-11-26
3. Anthropic — Harness design for long-running application development

   A planner, generator, and evaluator architecture for multi-hour autonomous application development.

   Use in this library: First-party case study. This first-party account documents one organization, product, or implementation context and should not be generalized without local evidence.

   engineering · engineering · Published 2026-03-24