Skip to main content

Paid Chronicle · Public Preview

Reliability Is a Harness Property: The Agent Engineering Dossier

Diagnose agent failures as task, context, tool, state, verification, or recovery failures before spending more on a model swap.

Paid edition · $19 one-time · lifetime read access with email recovery · article only, no software license.

Read the sample, then see what is included and unlock
  • The cited evaluations use different environments and do not form one uniform comparator.
  • Private traces and proprietary operating details are withheld from the public preview.
  • The scorecard is an engineering framework, not a universal measured reliability score.
Public companion: Read the related memory article
Read a sample · Complete section

Greyforge’s proposed diagnostic ordering

A failed run is often described as a model failure because the model produced the visible mistake. That diagnosis is too shallow when the task never had a testable completion contract, the context mixed stale and current evidence, the tool surface granted ambiguous authority, or the run was allowed to close on plausibility instead of proof.

Greyforge recommends classifying task and harness failures before treating a model swap as the default remedy. A model change may improve results, but it does not itself define the task, resolve conflicting authority, or establish an independent verification requirement.

When those contracts are adequate and the trace still suggests a reasoning limit, compare model changes under matched tasks and scoring. This is a proposed ordering for diagnosis, not a measured rule about which intervention works best.

Failure taxonomy

Task contract
Completion was vague, contradictory, or impossible to test.
Context contract
Evidence was missing, stale, excessive, or internally inconsistent.
Tool contract
Authority was too narrow to finish or too broad to remain safe.
State contract
The run mixed epochs or trusted derived state over the canonical owner.
Verification
Confidence or a partial check was mistaken for completion evidence.
Recovery
Repeated fixes continued without a circuit breaker or fresh diagnosis.

Included in this edition

Everything below is part of the article itself unless it says otherwise. No software, repository access, or product license is included.

  • Reliability failure taxonomy

    Table in the article

    Six proposed categories for investigating failures.

  • Eight-layer harness architecture

    Table in the article

    Intake, context, tools, ledger, verification, loop, recovery, and memory.

  • Illustrative trace ledger

    Table in the article

    A reviewable sequence of evidence, action, result, and unresolved assumption.

  • Reliability scorecard

    Table in the article

    Contract and evidence checks for deciding whether a run can close.

  • Model-swap decision rule

    Checklist in the article

    Candidate interventions to compare against a defined baseline.

Continue reading · Public introduction

The argument in context

Model capability, task difficulty and the surrounding system jointly affect reliability. Greyforge proposes explicit contracts for context, tools and verification, and recommends evaluating their contribution.

Harness engineering reliability artwork
Featured Chronicle Image

The Model Is Not the Operating System

A failed run can motivate a model change, a harness repair or both. Choosing between them requires a diagnosis and a defined comparison.

Missing context, stale state, ambiguous authority and incomplete verification are candidate failure causes. This edition does not measure their frequency relative to model limitations.

The contract model is Greyforge operating doctrine. It does not establish that harness changes generally outperform model upgrades.

Selected Research and Its Limits

The selected papers evaluate agents through repository tasks, interactive environments, tool interfaces and execution feedback. Their results are bounded by their own protocols; they do not validate one universal harness.

Source-selection method: sources were selected when they expose real repository or computer tasks, explicit tool interfaces, executable scoring, or adversarial tool-use conditions. General model leaderboards and vendor claims were excluded because they do not isolate the harness boundary discussed here.

Claim-to-source map for the public Harness edition
ClaimEvidence sourceBoundary
Repository-scale evaluation needs executable environments and testable outcomes.SWE-bench; SWE-agentEvidence from benchmark design, not proof that one harness works for every repository.
Interface choices affected results within the tested SWE-agent settings.SWE-agent; ReAct is discussed in the full dossierScoped research evidence; Greyforge's contracts are proposals, not model-independent findings.
Utility and adversarial pressure should be evaluated together for tool-using agents.AgentDojoSupports the evaluation principle, not Greyforge's exact approval policy.
Task, context, tool, verification, recovery, and memory contracts form Greyforge's reliability stack.Greyforge operating doctrineA position derived from operations, not a controlled external benchmark result.

Illustrative Trace-Ledger Example

This illustrative trace shows a possible record shape. It is not a retained run or measured result. Keeping the failed check visible alongside its repair is the proposed documentation practice.

Illustrative agent trace ledger
PhaseRecorded eventGate result
IntakeChange a parser without altering public outputOwner and completion test recorded
ContextLoad parser contract and focused fixturesUnrelated memory excluded
ActionPatch one owned moduleWrite set remains bounded
VerificationFocused fixture fails on an edge caseCompletion blocked; no success claim
RecoveryRevise parse boundary and rerun focused checksPass recorded with full gate deferred

The Public Rule

Greyforge recommends explicit task, context, tool and verification contracts. Whether those controls improve reliability or security requires evaluation in the intended environment.

The task contract tells the agent what done means before it starts.
The context contract decides what evidence is loaded and what stale memory is rejected.
The tool contract narrows authority before a command, write, or external call happens.
The verification contract decides whether a run can close or must repair itself.

This is the same doctrine behind Memory Quality Without an LLM Judge: make the cheap boundary deterministic before spending a model call on what a gate could have rejected. It also explains why memory continuity and operations control matter so much. An agent that cannot inherit the right state cannot be trusted to finish the right job.

Editorial review · September 5, 2026. No controlled Greyforge reliability, security, cost or model-swap outcome is reported. The sample is an operating position. Read the correction and source boundary.

Edition
Engineering dossier 1.0
Published
Updated
Reading time
7 minutes
Full edition
1,718 words
Article status
Current record

Who this is for

  • Builders of long-running tool-using agents.
  • Reviewers designing acceptance, trace, and recovery gates.
  • Operators deciding whether to repair a harness or change the model.

Not for

  • Readers seeking a model leaderboard, a universal reliability score, or a prompt-only recipe.

Detailed contents

  1. 01

    Reliability is a systems property

  2. 02

    Public research basis

  3. 03

    Six failure classes

  4. 04

    Eight harness layers

  5. 05

    Action and trace ledger

  6. 06

    Verification and loop control

  7. 07

    Recovery contract

  8. 08

    Reliability scorecard

  9. 09

    Model-swap decision rule

  10. 10

    Minimum reference architecture

Evidence and method

mixed: Selected literature synthesis plus Greyforge operating proposals. The sample is a diagnostic position; no controlled Greyforge reliability, security, cost or model-swap outcome is reported.

Limitations

  • The cited evaluations use different environments and do not form one uniform comparator.
  • Private traces and proprietary operating details are withheld from the public preview.
  • The scorecard is an engineering framework, not a universal measured reliability score.
Full research disclosure
Research disclosureinferredCurrent record

Literature Synthesis

Secondary class: Position Note

Research question or engineering problem
Which system layers determine whether an agent can complete real repository work reliably?
Principal finding
Selected evaluations support studying agents in their environments; the Greyforge contract stack is a proposed design, not a measured comparative result.
Evidence type
Selected public research plus Greyforge operating doctrine.
Method summary
Select research on real environments, repository tasks, tools, and adversarial conditions, then map its signals separately from Greyforge policy.
Scope
Agent harness architecture; not a universal model leaderboard or controlled cross-platform benchmark.
Limitations
  • The source set is selected rather than systematic.
  • No controlled Greyforge reliability, security, cost or model-swap outcome is reported.
  • Greyforge doctrine is operating judgment, not external experimental proof.
Public source or reproduction note
Editorial review and source boundary
Published
2026-02-18
Last verified
2026-09-05
Status
Current record

Access and updates

Purchase includes lifetime read access to this edition, email-based recovery, and revisions published to the same edition.

Public companion: Read the related memory article