The code wrapped around an AI model shapes its behavior as much as the model itself — so why do we design it carelessly?
How should harness scaffolding be treated as a first-class object?
This explores what it means to treat the harness — the scaffolding of prompts, tools, memory, and evaluation wrapped around a model — as something you design, version, and measure in its own right, rather than as invisible plumbing around the model.
This explores what it means to treat the harness — the scaffolding of prompts, tools, memory, and evaluation wrapped around a model — as a designed object in its own right rather than invisible plumbing. The corpus keeps circling one idea: the harness is where a lot of an agent's real behavior lives, so it deserves the same scrutiny we give the model. One striking result is that a behavior-centric reorganization of a harness repository — mapping runtime behaviors to the code that produces them — let a weaker planner match a stronger model's accuracy while using fewer tokens Can explicit behavior maps help weaker planners compete with stronger models?. That's the first-class-object claim in miniature: how you structure the scaffolding can substitute for raw model capability.
But treating something as first-class also means measuring it honestly, and here the corpus gets skeptical. Harness evolution — letting an agent rewrite its own scaffolding — is itself a search loop, so its gains get confounded with sheer search effort. Only improvements beyond an equal task-level search budget can actually be credited to design, and you need held-out tasks to rule out memorization Are harness evolution gains really from better design?. Inspecting what those self-edits actually contain deflates the hype further: most persist task-specific fixes the agent could have rediscovered in a single rollout, caching shortcuts rather than distilling reusable strategy Do harness edits learn strategies or just memorize fixes?. And the ability to benefit isn't uniform — the capacity to write useful harness edits is flat across model tiers, but the capacity to actually gain from them peaks in the middle, since weak models don't invoke the scaffolding and strong models chafe against following it Do stronger models always evolve harnesses better?.
The deeper move is architectural: decompose the harness so its parts can be inspected. AgentCompass separates evaluation into distinct Benchmark, Harness, and Environment components, and that separation is what makes reward-hacking and other failure modes visible in trajectories that a single scalar score would hide How can separating evaluation components make reward-hacking visible?. First-class means legible: you can only govern or debug a layer you've named and pulled apart.
What makes this genuinely interesting is that the same principle shows up in adjacent territory the question doesn't literally mention. Governance works far better when the rules live inside the runtime memory the agent actually consults during decisions, rather than as an external policy appendix it never reads Can governance rules embedded in runtime memory actually protect autonomous agents?. Context itself improves when treated as an evolving playbook, updated incrementally to avoid collapsing detail, instead of rewritten wholesale Can context playbooks prevent knowledge loss during iteration?. And context management can even be offloaded to a separate trained module tuned to the agent's reliability Can external managers compress context better than frozen agents?. The through-line: prompts, tools, governance, and context are all becoming durable, versioned, separately-optimized artifacts — the harness stops being a wrapper and becomes a stack of first-class objects, each of which you can design, measure against a fair baseline, and hold accountable on its own.
Sources 8 notes
A behavior-to-code mapping representation improved win rates by 10–19 points while reducing planner tokens by 8–13%. Weaker planners using this mapping matched stronger models' code localization across all precision and recall metrics.
Harness evolution is itself a search loop, so its reported improvements are confounded with search effort. Only improvements beyond equal task-level search budget can be attributed to harness design, and held-out evaluation is needed to rule out task memorization.
Inspecting evolved harness edits reveals rational changes across prompt and tool layers, but most persist fixes the agent could rediscover in one rollout. Gains remain limited because edits cache shortcuts for already-solvable tasks rather than converting failures into successes.
Model capability to produce useful harness edits stays constant across tiers, but capacity to actually benefit from those edits follows an inverted U-shape, peaking in mid-tier models. Weak models fail to invoke harnesses; strong models struggle with faithful instruction-following.
AgentCompass shows that separating Benchmark, Harness, and Environment into independent components enables comprehensive trajectory analysis that exposes reward-hacking and other failure modes invisible in scalar scores. This architectural shift makes evaluation both reproducible and diagnostically transparent.
Show all 8 sources
A persistent agent recorded 889 governance events across 96 active days, with safeguards encoded directly into the memory layer the agent consulted during operation. Runtime-resident governance proved more effective than external policies because the agent actually accessed it during decision-making.
The ACE framework treats contexts as evolving playbooks using generation-reflection-curation loops rather than full rewrites. This prevents knowledge loss from compression and detail erosion, achieving +10.6% on agentic tasks and +8.6% on finance without labeled supervision.
An external RL-trained manager can adaptively prune context for frozen agents, with the key insight that stronger agents benefit from high-fidelity preservation while weaker agents need aggressive compression to stay reliable.
Papers this line draws on 8
The research behind the notes this line reads — ranked by how closely each paper relates.
- From Model Scaling to System Scaling: Scaling the Harness in Agentic AI
- Scaling Laws for Agent Harnesses via Effective Feedback Compute
- Harness Updating Is Not Harness Benefit: Disentangling Evolution Capabilities in Self-Evolving LLM Agents
- Rethinking the Evaluation of Harness Evolution for Agents
- Harness Handbook: Making Evolving Agent Harnesses Readable,Navigable, and Editable
- Externalization in LLM Agents: A Unified Review of Memory, Skills, Protocols and Harness Engineering
- Large Language Model Agents Are Not Always Faithful Self-Evolvers
- SearchSwarm: Towards Delegation Intelligence in Agentic LLMs for Long-Horizon Deep Research