get started

Prompt regression testing without freezing your roadmap

Every prompt edit is a production deploy with no compiler, no type checker, and no test suite — unless you build one. The result is a strange industry equilibrium: teams either ship prompt changes recklessly, or freeze their prompts entirely out of fear. Both lose. The exit is regression testing built from your own recorded traffic.

The mechanism

prompt vN+1replay gatefails → revisepasses → canary → ship
The gate is recorded reality: past failures replayed against the candidate. What cleared the gate ships with its scores attached.
  • Record decisions continuously — inputs, context, outputs, outcomes. (One wrapper if you're on OpenAI or Anthropic clients.)
  • Curate the regression set from failures. When a bad output gets fixed, the case that exposed it joins the set permanently — that behavior is now protected.
  • Replay candidates against the set and score with versioned rubrics — your policies, not generic helpfulness. Weakest criterion weighs heaviest.
  • Canary what passes, rubrics still scoring live, then promote. Every step lands in the signed trail: what changed, what the replay said, who approved it.

Why "don't touch the prompt" is the worse bet

Prompt freezes feel safe but decay silently: your traffic drifts, your model gets deprecated (the same clocks that rot test sets), and the freeze converts small continuous risk into one giant migration risk. Meanwhile regulation is arriving at the opposite conclusion — the EU AI Act's change-control expectations assume systems change and demand the change bedocumented, not prevented. A replay gate produces that documentation as a free by-product: every shipped prompt carries evidence of what it was tested against.

Start with one protected behavior

Don't boil the ocean. Pick the behavior that would page you at 2am, find the three recorded cases that exercise it, write the rubric, and gate this week's prompt edit on them. Experimentation platforms (Braintrustis good at this) help you iterate toward the candidate; the gate is what stands between the candidate and your users.

FAQ

What is prompt regression testing?

Before a prompt change ships, replay it against a curated set of recorded real interactions — especially past failures you already fixed — and score the outputs against your rubrics. The change ships only if it clears the gate. It is the AI equivalent of running the test suite before merging.

Why not just eyeball a few examples?

Because prompt changes have non-local effects: tightening the refund language can break the escalation behavior three instructions away. Eyeballing catches the failure you were looking at, not the four you were not. Replay against a broad set is how the four get caught.

What belongs in the regression set?

Recorded production traffic, weighted toward pain: every incident, every clustered failure, every case a customer escalated. Synthetic cases pad coverage, but real failures are the load-bearing members — they encode exactly the behaviors you cannot afford to lose again.

Does this slow shipping down?

It replaces fear with a gate. Teams without regression testing ship prompts slowly because every change is a gamble; teams with it ship weekly because the gamble is bounded. The gate runs in minutes; the roadmap freeze it prevents costs quarters.