All articles
AI does not fail at building software. We fail at building the harness.
The Harness Series — Part 1

AI does not fail at building software. We fail at building the harness.

Nuwan SamaranayakeJune 17, 20264 min read

The model is the brain. The harness is the engineering you wrap around it. Why directed AI ships production software and free AI breaks.

A lot of people tell me the same thing about AI. Too expensive. Burns tokens. Produces broken code. Costs more than a human and ships less. I hear this every week.

They are looking at the wrong part of the system.

The model is the brain. Opus, GPT, Gemini, all of them. Fast, broad, full of knowledge. A brain with no direction wanders. Point a brain at a vague goal and you get a confident answer built on guesses you never approved. The model did not fail. The system around the model failed.

The system has a name. The harness.

Nate writes a widely read Substack on AI. This month he made a sharp point about the harness behind tools like Claude Code and Codex. The tool vendor wraps the model in a harness, and the harness shapes the output more than the model does. He is right. One number from his piece stuck with me. Anthropic ran the same Opus model through two different harnesses. One scored 78 percent. The other scored 42 percent. Same brain. Two bodies. Almost double the result from the harness alone.

I want to add a layer he did not cover. There is a second harness. The one you build yourself.

The harness you build

At AiGNITE I run Opus for software development. Opus is the brain. Opus never works alone and never works free. Opus works inside a harness I built over the last few months and shaped with thirty years of engineering practice.

My harness is not the tool. My harness is the process. Design methods. Architecture rules. Review gates. Quality checks. Testing standards. Deployment verification. Each piece tells the AI what to build, how to build it, and how to prove the build works.

We use Opus. We direct Opus. We do not let Opus run wild.

My hypothesis

AI does not fail to produce software. We fail to engineer the harness around the model.

A directionless AI with no clear goal, no boundaries, and no defined lane will take detours. Some detours look like progress. Then you deploy and the system breaks in production. The road was never cleared. The harness clears the road.

Most people who complain about AI cost run AI with no harness. They type one prompt and expect a production system. They overestimate the model and underestimate the engineering.

Give AI room to assume and AI assumes. Not the way you want. The way the model decides fits best. Every gap in your instructions becomes a guess. Stack enough guesses and you ship software you never asked for.

We work the opposite way. We break every problem into small pieces. We write detailed prompts, sometimes hundreds of lines for one task. We verify each step before the next. From the first line to the deployed product, Claude does the work. Not the raw model. The model running inside the harness.

Why the harness works

The harness comes from hard lessons. I spent thirty years shipping enterprise software at IBM, Infosys, and HPE, on systems for clients like NASA JPL, the US Postal Service, and Hilton. I know where projects break. Silent data failures. Mock fallbacks hiding a dead backend. Partial database migrations. Frontend patches over a broken backend. I encoded each lesson into the harness so the AI never repeats a mistake I already paid for.

The result is software built from inception to deployment by Claude, fast and reliable, because the brain runs inside a structure designed by someone who knew the failure modes in advance.

What comes next

This is the first piece in a short series.

Next I will show you real failures we hit while building Cosmic Nexus and our other products, and how each failure taught us a new part of the harness.

The final piece will show how the harness now stops those failures before they reach production, and how the whole approach makes us faster, not slower.

The lesson is simple. AI needs engineering too. Build the harness first. Then let the brain run.