engineering notes · 01

Inside the harness: shipping production software with LLMs —
without losing the plot.

uistory.sk·~6 min read

Anyone can prompt a model into producing code. The hard part is producing software you’d bet a production system on. Our answer is an engineering harness: a pipeline where models check inputs and outputs at every boundary, and a human signs off on every decision that matters.

Why a harness at all

An unharnessed agent optimizes for looking done: implementation before the problem is specified, tests omitted when inconvenient, completion reported without evidence. These are predictable failure modes, and the harness addresses them structurally rather than by prompting harder. Each phase has entry and exit criteria — inputs checked on the way in, outputs reviewed on the way out, first by a model in an adversarial reviewer role, then by an engineer.

In practice: the spec is checked against the original problem before architecture begins. The architecture is checked against the spec before implementation begins. Every diff is checked against the plan, the test suite, and a security checklist before a human reads it — so reviewer attention is spent on judgment, not on catching mechanical errors.

Watch it run

Build pipeline · replay
One engagement, compressed.
The same gates fire on every build — including the one that rejects. Below: a usage-based billing build, replayed phase by phase.
◇ model gate (adversarial) · [HUMAN] sign-off · ● artifact · ↻ reject → loop back
Discover
1
Intentintent.md — onboarding, not the pricing engine
restates the problem, not a solution
2
Validaterisk register
HUMANsign-off: go / no-go — PM
Define
3
Scopespec.md — metric: time-to-first-invoice
spec checked against the problem — every goal traces to intent
HUMANsign-off: spec approved — PM
4
ArchitectADR-001 — idempotency keys + append-only usage ledger
design checked against the spec — no unjustified dependencies
5
Plantickets — file paths + verify steps
HUMANsign-off: plan approved — PM
Build & ship
6
Scaffoldrepo · CI/CD · first green build
7
ImplementRED → GREEN — metering-idempotency.spec(the test fails first, then passes)
diff checked against the plan, the tests, and the security checklist
8
Review
HUMANsign-off: senior engineer review
9
Shipstaging → preview → prod · rollback armed
HUMANsign-off: deploy approved — senior engineer

The rules the pipeline enforces

Under the phase diagram, four rules do the real work:

The pipeline also enforces three hard constraints: models work with sandboxed access and scoped, time-limited credentials; automated security scanning runs on every change; and production secrets and sensitive data never reach a model. No exceptions, no overrides.

What it buys

We instrument every engagement; we don’t estimate. Three numbers tell us whether the harness is earning its keep:

It’s already done its job at least once: on the billing build, the architecture gate rejected a design that would have double-counted usage on retries — before a line of code existed.

We publish these as running averages once the sample is large enough to mean something. Numbers land here as they’re collected.

What it costs

None of this is free. Specs take time before any code appears, gates reject work and force loops, and the pipeline is slower on day one. We accept that, because the cost surfaces early — where it’s cheap — instead of in production.

The line that doesn’t move

The harness makes us faster and stricter at the same time — that’s the whole point. But it never decides. Every architecture choice, every merge, every deploy carries a human signature. You inherit a codebase where each of those signatures is on record.

Want this harness on your project?
30 minutes · you talk to the people doing the work
Intro call →
© 2026 uistory · engineering notes← uistory.sk