T1 · Beginner · 6 minStable · Last reviewed: 2026-08-19Early draft

Prompt Iteration — Improving It in Passes

In one line · A first prompt is rarely the final one; improving it is iterative: try, see what's wrong, change one thing, and compare.

Glossary:ProbabilisticPromptRubric
Why it matters

People give up on a prompt after one failed try and say 'the model is dumb'. The problem is usually the wording, and the fix is a small deliberate tweak.

Like tuning a SQL query: you run it, look at the result, change one condition, and run again — you don't rewrite it from scratch each time.

An analogy

Treat each version of the prompt as a small commit: one clear change, so if it breaks you know what to revert.

Reply too long? Add 'in one sentence'. Still too formal? Add 'in a friendly tone'. Change one thing at a time so you know what actually moved the needle.

How it works

Work it like any debugging loop: fix a small test set (5-10 real inputs), run the prompt over it, and note the recurring failures. Change one thing aimed at the most common failure, rerun on the same set, and compare. The fixed set is the key — without it you're judging by feel, and since model output is probabilistic, a single example can fool you in either direction.

Practice

🧪 Try it yourself: take the weak prompt in the linked exercise and fix 5 test inputs. Do 3 passes: change exactly one thing per pass, and score all five before and after. At the end, look at the log: which change actually made the biggest difference?

Common mistakes
  • Changing 3 things at once, so when results improve (or break) you can't tell which change did it.
  • Judging a tweak from one example — a better result can be pure sampling luck.
  • Keeping no versions of old prompts, so when a tweak breaks something that worked, there's nothing to roll back to.
When to use it

Any prompt headed for production, and any prompt with shaky results or failures on specific kinds of inputs.

When NOT to use it

If you've reworded 5-6 times and results haven't budged, stop rewording — the problem is usually deeper: you need examples (few-shot), missing context (RAG), or the task is beyond the model itself.

LET'S BUILD ITDone reading — now build it yourself.Improve a weak prompt over 3 passes