Skip to content
UHPUHPDeveloper Guide
Independent developer guide. Not affiliated with HarnessRouter or the official UHP project.

Harness-of-Harness and HoH-lite: persistent development loops

Harness-of-Harness coordinates repeated planning, coding and independent QA around an evolving project. The project artifact and evidence persist between iterations while existing coding harnesses perform the work.

Page reviewed 4 Oct 2026 Source and review policy

Published evidence; no independent rerun claimed

HoH-lite is now available. The project README at ae7cc6fb announces it on 24 September 2026 and links the lightweight implementation. The earlier “coming soon” statements in the source history below reflect the 4 September cutoff and are superseded for availability.

Public source improves inspectability; it does not independently reproduce the paper’s measurements or establish production readiness. This review checked the repository and release-status evidence, not a multi-day execution.

Persist the handoff before another development iteration

Section titled “Persist the handoff before another development iteration”

The current HoH repository describes stable planner, developer and read-only QA roles operating on one evolving workspace. HoH-lite became available on 24 September; availability does not establish independent reproduction of the paper’s benchmark gains.

requirements → planner brief → developer artifact → read-only QA evidence
↑ │
└──────── committed handoff ───────┘

Before the next iteration, preserve the artifact revision, brief revision, accepted capabilities, failed checks, environment/version coordinates and unresolved blockers in a handoff. Otherwise a restarted planner can confuse “developer said complete” with “QA verified complete,” or inadvertently schedule the same rejected change again.

Handoff resultNext iteration’s treatment
QA verifies capability on exact artifactPreserve it as a regression obligation
QA finds deterministic failurePlan one bounded correction against retained evidence
QA cannot run required checkKeep capability unverified; record missing prerequisite
Process dies during developmentRecover artifact/execution state before new work

Start a trial on an isolated project with explicit budget and stop criteria. Compare artifact quality and evidence retention across iterations, rather than only counting loops. A UHP task server could execute a development step, but the handoff and project-acceptance policy remain outside its wire contract. The published Vanilla/HoH@3 table below keeps its original models, metrics and authors’ claims unchanged.

Requirements + prior evidence
↓
Planner
↓ prioritized work
Developer
↓ changed project
QA tester
↓ verified behavior + remaining gaps
Next iteration reads the project and evidence again

The research project separates these roles so development can build on demonstrated progress. The unit of improvement is the software artifact; the concept does not require rewriting the underlying harness or creating a new interoperability protocol.

Before adopting a loop, identify its stop conditions, budget, retained state and acceptance criteria. Determine which actor can change the artifact, which checks are independent, and how a failed iteration is recovered without losing prior verified work. Inspect the HoH-lite instructions for its actual runtime dependencies instead of inventing a generic one-command installation.

Use the author-published results as hypotheses about the tested harness/model combinations. Do not extrapolate a game’s iteration count into a promise about an unrelated application. UHP can supply an external execution boundary in a separately implemented system; no standard UHP-to-HoH binding or released HarnessRouter integration is established here.

The HoH-lite README at ae7cc6fb requires Python 3.12+, Godot 4, and the selected harness CLI and credentials. Its bundled GameCraft example also needs an external benchmark checkout, Node.js/npm, bubblewrap, Xvfb, xdotool and FFmpeg for MCP and replay. Follow that README’s editable installation, local .env setup and gameloop-godot-mcp-vendor prepare step before running a task. An unrelated application needs its own benchmark/project adapter; this example does not make arbitrary projects runnable unchanged.

From hoh-lite/, after setup, replace the benchmark and task paths with real local inputs:

Terminal window
gameloop --config configs/harnesses/codex-gpt-5.5.json \
--bench /path/to/benchmark \
--task tasks/your-task \
--run-id first-trial \
--attempts 1

The published runner accepts --attempts 1 to limit the trial to one outer iteration; that iteration still invokes the configured roles and can incur model usage. This command is source-checked, not executed here.

After the trialWhat to inspect or preserve
Compare with the paperRead the run’s reproducibility.json: observed tool versions, source/benchmark revisions, role bindings and configuration hash. The paper used Codex CLI 0.142.5; the default profile accepts the installed CLI rather than guaranteeing that version.
Continue a previous runKeep the same --task, pass --resume-from runs/first-trial, and choose a new --run-id. Automatic resume selects the latest completed valid loop.
Recover after interruptionPreserve the old run, including partial work. Automatic resume leaves the interrupted loop there; it does not claim that partial work passed QA or became the new seed.

Reusing an existing run ID fails before its receipts or artifacts can be overwritten. Inspect the retained evidence before starting another loop; a fresh run ID preserves provenance, but does not itself establish acceptance.

Historical source notes — baseline reviewed 4 Sep 2026

The following evidence preserves the earlier review and its links. “Current”, “stable” and “main” inside this section refer to that historical cutoff; they are not new release or compatibility claims. Use the guidance above for the current scope.

Harness-of-Harness (HoH) is a research framework for long-horizon autonomous software development introduced in arXiv preprint 2609.01481, submitted on 1 September 2026. The project builds on existing coding-agent harnesses rather than defining a new agent protocol. Its public experiments use Codex with GPT-5.5 (high), OpenCode with DeepSeek-V4-Pro, and Pi with MiniMax-M3 across GameCraft-Bench, FrontierSWE and ProgramBench.

The current public repository and project page expose the paper, benchmark results, demos and development trajectories. The repository explicitly says HoH-lite, a lightweight implementation of the core workflow, is coming soon. This guide therefore treats HoH as published research and architecture evidence, not as a generally released software package or independently replicated production system.

HoH keeps an evolving software project and an evidence record across repeated iterations while coordinating three stable responsibilities:

  1. Project Planner — reads the requirements and prior evidence, then writes a prioritized development document without modifying the artifact.
  2. Developer — implements that development document in the shared project workspace while preserving already verified behavior.
  3. QA Tester — independently inspects and tests the updated artifact, recording verified behavior and remaining gaps while staying read-only with respect to the artifact.

The resulting artifact state and evidence state become the input to the next iteration. The paper describes this as a planning–coding–testing loop with small verifiable increments, independent evaluation, structured outputs, progressive disclosure of deliverables/tools/skills and versioned project history.

The architectural distinction is important: HoH does not require the base coding-agent harness to become a new protocol endpoint. It repeatedly uses an existing harness as the execution substrate while the project evolves from loop to loop.

Requirements / PRD
│
▼
Project Planner
│ development plan
▼
Developer on an existing coding-agent harness
│ updated artifact
▼
Independent QA Tester
│ evidence + unresolved gaps
└───────────────┐
│ next iteration
▼
Project Planner

The project reports Vanilla versus HoH@1–3 results for three harness/model pairs. The table below reproduces only the published Vanilla and HoH@3 endpoints so the direction and scale of the measured change stay visible without turning the guide into a leaderboard.

Harness + modelMetricVanillaHoH@3Reported absolute gain
Codex + GPT-5.5 (high)GameCraft-Bench Overall49.5871.52+21.93
Codex + GPT-5.5 (high)FrontierSWE Dominance44%71%+27 pp
Codex + GPT-5.5 (high)ProgramBench Pass Rate60.4166.50+6.09
OpenCode + DeepSeek-V4-ProGameCraft-Bench Overall26.9048.98+22.08
OpenCode + DeepSeek-V4-ProFrontierSWE Dominance25%44%+19 pp
OpenCode + DeepSeek-V4-ProProgramBench Pass Rate45.2757.56+12.29
Pi + MiniMax-M3GameCraft-Bench Overall42.1658.78+16.62
Pi + MiniMax-M3FrontierSWE Dominance35%64%+29 pp
Pi + MiniMax-M3ProgramBench Pass Rate35.8352.68+16.85

Across all reported benchmark settings, the paper summarizes an average relative gain of 52.25% and a maximum relative gain of 82.86% after three iterations. Those are author-reported aggregate results for this experimental design, not universal performance guarantees for the underlying harnesses.

The project also reports Fusepoint, a single-player narrative first-person shooter built from an empty workspace containing only a product requirements document. The project page says HoH ran for more than 70 iterations without a human in the loop and produced a human-playable game with implemented core mechanics, storyline, visuals and audio.

This case is significant because the unit of autonomy is not one coding turn or one benchmark patch. HoH attempts to preserve verified progress and evidence over many repeated development cycles, making long-horizon artifact continuity itself part of the harness-level architecture.

The public repository links the Fusepoint trajectory so the development history can be inspected. The project also reports another game, Mournlight, at more than 80 loops, but the paper’s principal public multi-day example is Fusepoint.

The name can be misleading. HoH is not primarily a system for rewriting the underlying coding-agent harness. The paper positions it around continual improvement of the software artifact while operating on existing harnesses. Planner, developer and tester roles, runtime conditions and the base harness/model pairing are held stable within an experimental run while the artifact and evidence evolve.

That makes HoH different from work whose objective is to optimize prompts, tools, skills or execution logic inside the harness itself. The “harness-of-harness” layer is an orchestration envelope around repeated harness executions, not evidence that the base harness has become self-modifying.

HoH, UHP and FrontierHarness answer different questions

Section titled “HoH, UHP and FrontierHarness answer different questions”
LayerPrimary questionUnit being controlled or measured
Harness-of-HarnessHow can repeated harness executions improve one software artifact across many autonomous iterations?Planner/developer/QA loop, project artifact and evidence state
UHPHow can a client execute a selected complete harness through one interoperable HTTP contract?Client ↔ UHP server ↔ harness task/session execution
FrontierHarness EvalHow differently do frozen harness/model/runtime configurations perform on the same benchmark tasks?Harness + model + runtime configuration

These layers can be complementary without being interchangeable. HoH provides a long-horizon orchestration strategy; UHP provides an external execution contract; FrontierHarness provides comparative evaluation evidence. None of the three automatically establishes the other two.

HoH adds a useful architectural pattern to the emerging harness-engineering vocabulary: continual artifact improvement through evidence-grounded repeated harness execution. The key design choices are not simply “run the coding agent longer.” The framework explicitly separates planning, implementation and independent QA, carries evidence forward, constrains work to bounded increments, and preserves versioned history so later loops can distinguish verified capability from unresolved work.

For interoperability work, the lesson is narrower. A protocol such as UHP can standardize how a harness is addressed and executed, but long-horizon project orchestration still needs its own policy for iteration boundaries, evidence retention, role separation, acceptance criteria and recovery. HoH is one research design for that layer; it does not alter the UHP specification.

  • The currently exposed primary artifact is an arXiv preprint plus project/repository materials; this guide does not treat it as a standards-track document or certification.
  • The authors state that HoH-lite is not yet publicly released, so complete implementation-level reproducibility is not available from a packaged HoH runtime at this cutoff.
  • The published benchmark covers three harness/model pairs and three software-development benchmarks; it does not establish behavior across arbitrary harnesses, models or domains.
  • The benchmark and case-study results are author-published. No independent replication was verified in this research pass.
  • The reported gains measure final artifact quality under the HoH experimental setup. They do not measure UHP conformance, protocol interoperability or native UHP adoption.

Read harness composition and subagent delegation for child-agent and cross-harness runtime topologies, FrontierHarness Eval for controlled harness benchmarking, and UHP conformance for protocol-contract verification. The individual Codex, OpenCode and Pi pages track current integration/upstream evidence separately from the versions and models used in the HoH paper.