All notes

A demo proves nothing. Ship on an eval gate instead

You can get an impressive LLM demo in an afternoon. The model does the task once, on an input you picked, and everyone nods. That demo proves almost nothing. I’ve argued before that evals are just taste written down as a number, and the harder version of that idea is this: the thing that separates a prototype from a product isn’t more features. It’s a gate you refuse to ship without.

What is the gap between a demo and a product?

A demo is a single curated success. A product is a distribution of real inputs, and most of them are ugly. The demo hides the failure rate on the long tail, the bill when a thousand users arrive, and the day the model returns malformed output or gets prompt-injected. None of that shows up in the screenshot you posted.

Thoughtworks calls this the production gap, and their 2026 field research is blunt about it: stakeholders see a demo and assume the team is 90% done, when they’re closer to 10%. They cite figures suggesting roughly 95% of generative AI pilots fail to deliver meaningful results because the strategy and integration work never happens. The demo isn’t the product. The demo is the part that was always going to be easy.

What is an eval gate?

An eval gate is a rule: a change ships only if it clears a quality bar you measured. You keep a test set of representative inputs with expected properties, and a scorer grades any candidate — a new prompt, a different model, a changed pipeline — against it. Quality stops being “looks good to me” and becomes a number.

The discipline comes from Anthropic’s own engineering guidance on building evals for AI systems, which frames an eval as an input plus grading logic that measures success. They recommend deterministic graders where possible and model-based graders where necessary. That’s the whole trick. Instead of shipping on three examples you happen to like, you ship on a score across a hundred — and you block the change that improves your favorites while regressing everything else.

How do you build your first eval set?

Don’t start with the feature. Start with the test.

  • Collect real inputs. Grab the prompts and documents your users actually send, including the weird ones. A eval made of tidy examples will lie to you.
  • Write expected properties, not just a perfect answer. For most tasks you want a rubric: tone, structure, the facts that must be present. Code-graded checks are best when they fit; a model grader with a clear rubric covers the rest.
  • Run it before you build. The eval is the instrument that makes everything else measurable. Without it, you’re flying on vibes and finding out in production.

The point isn’t to reach 100% overnight. It’s to make “should we ship this?” a computation instead of a feeling.

Why does this matter more for solo founders?

Solo, there’s no second pair of eyes. You write the prompt, you merge the change, you go to sleep. A regression you shipped on a hunch reaches users before you notice, and you’re the only one who can catch it.

An eval gate is cheap insurance for exactly that. It’s the difference between “I tweaked the prompt and it felt better” and “the score moved and I can see which cases broke.” You don’t need a QA team. You need a test file and the discipline to run it. The models make building trivial; the gate is what makes shipping safe. Build the boring thing first, and the impressive thing lasts longer than a weekend.

Frequently asked questions

  • A demo runs one curated input and looks impressive. A product has to be right on the messy long tail of real inputs, affordable at volume, and dependable under load. The gap between the two is where most AI features quietly die.

About the author

mosh

mosh is a product designer and design engineer working with design systems, LLM-powered prototypes, agent-safe interfaces, production UI, and automated workflows.

Keep reading