Search⌘ K
AI Features

Test the Harness, Not the Agent

Explore how to design and test harness controls that monitor AI coding agents, ensuring that scope boundaries and gates function correctly. This lesson helps you understand the importance of asserting specific outputs over prose and keeping fixtures isolated. You'll learn to identify dead or unprotected gates and run deterministic tests that do not rely on live models, improving reliability in multi-session coding agents.

Wrenfold’s harness had grown into real machinery. A Scope Contract with a diff check, a feature gate with typed refusals, an authority policy, a claim-to-proof matrix, and a verification route that replayed the concurrent booking race.

Then session forty-one shipped an out-of-scope rewrite of the patient route inside a CLIN-547 waitlist ticket. The diff check had run. It had printed SURFACE OK.

The check ran git diff --name-only with no revision argument. Every edit the agent made was already staged, so the command returned nothing, so the comparison found no path outside the expected surface. It had returned SURFACE OK for eleven consecutive sessions, including four that drifted.

Nobody noticed, because a gate that never fires looks exactly like a gate with nothing to catch. Both print green.

Why didn’t anyone notice a dead gate?

Because green is two different messages wearing the same color.

“I checked, and the work was clean” and “I am incapable of finding anything” produce identical output. The only way to tell them apart is to hand the gate something it should reject and confirm it does.

The booking code has 14 unit tests and an end-to-end route. The gates that judge it had none. They were written once, watched by hand, and trusted for eleven sessions.

This is the reliability side of the course’s line pointed at the harness itself. The model was capable, the contracts were correct on paper, and one line of shell in one gate quietly removed the whole scope boundary.

What is actually under test here?

Invert the usual arrangement. In a harness test, the agent is not the subject. It is part of the fixture.

The system under test is the control: diff check, transition guard, coverage rule, authority function, or exit ...