Home / Techniques that change the result
Checking a prompt the way you check a result
An eval is a fixed set of tests that scores a prompt, and meta-prompting uses Claude to improve an existing prompt, but in both cases the result stays a draft to test, never a final answer.
A prompt that has answered correctly three times in a row on the examples you happened to try has not been checked, it has only been tried by chance. An eval changes this situation: it is a fixed set of test cases, written in advance, that automatically scores a prompt on each of them, exactly as a test suite scores a programme.
What an eval actually measures
Claude's documentation describes this cycle in one clear sentence: building a successful application starts with defining success criteria, then designing evaluations that measure performance against those criteria, a central cycle of prompt engineering (platform.claude.com, section on testing and evaluation, accessed 2 September 2026). A minimal eval fits in three lines.
cas 1 : entree "Le colis est arrive casse" -> attendu "reclamation"
cas 2 : entree "Merci, tout est parfait" -> attendu "compliment"
cas 3 : entree "Quel est le prix du modèle B" -> attendu "question"
Run your classification prompt on these three inputs and compare each output obtained to the expected one. A score of two correct answers out of three does not say the prompt is generally good or bad, it says which of the three cases fails, and that is the one to fix first.
Meta-prompting writes a draft, not an answer
Meta-prompting means asking Claude to improve an existing prompt rather than rewriting it alone from a blank page. The Metaprompt tool in the recipe collection published by Anthropic is designed to solve this blank page problem and give a starting point to iterate from, and its documentation says so without hedging: the prompt obtained at the end is not guaranteed optimal in any way, do not hesitate to change it (Anthropic cookbook, Metaprompt page, accessed 2 September 2026). A prompt that comes out of meta-prompting therefore carries no more authority than a first draft written by hand, it must go through the same fixed set of cases before being adopted.
The same set of cases, before and after
The rule linking the two halves of this technique fits in one sentence: do not improve a prompt without retesting it afterwards on exactly the same set of cases that was used to judge it the first time. Changing the test cases between the two passes amounts to comparing two prompts on two different problems, which proves nothing about actual progress. The figure alongside shows this full cycle. This principle connects with test the checker before trusting its verdict: an eval is also a check, and a check that changes cases between two measurements no longer measures the same thing. It carries straight through into asking several times, and contradicting yourself, which applies another form of stress test, this time to a single answer rather than to a whole prompt.
The eval and meta-prompting cycle, from the first score to adoption
A person writes three fixed test cases for a customer message classification prompt, each case pairing an input with the expected category. She runs the current prompt on these three cases and gets two correct answers out of three. She then asks Claude to improve the prompt based on this result, then runs the improved prompt on the same three cases and gets three correct answers out of three.
Write in one sentence what this situation establishes, and in one sentence what it does not establish.
What this establishes: On these three specific cases, the improved prompt fixes the error the initial prompt was making, going from two correct answers out of three to three out of three.
What this does not establish: This does not establish that the improved prompt correctly classifies customer messages absent from this set of three cases.
The three most common miscalibrations
- Too broad The improved prompt now correctly classifies every possible customer message, beyond these three tested cases.
- Too narrow This result proves nothing at all, since the test set contains only three cases among all possible customer messages.
- Beside the point This result shows that Claude is capable of proposing relevant test cases for a classification prompt.
- An eval is a fixed set of test cases that automatically scores a prompt, the way a test suite scores an entire programme.
- A partial score points to which specific case failed, something an overall judgement of the whole prompt never lets you spot on its own.
- Meta-prompting produces a starting point to work on further, never a guaranteed optimal result, according to the very tool that produces it.
- An improved prompt gets retested on the exact set of cases used to judge it at the start, never on a different set.
Write three fixed test cases for a prompt you use regularly, input and expected output for each, run your current prompt on them, and note how many cases get the expected answer before attempting the slightest improvement.
These points depend on an interface or a rule that may have changed since this was written. Check them on your own screen before relying on them.
- On the platform.claude.com testing and evaluation page, check on your screen that the cycle of success criteria then evaluation is still described there, as this documentation has already merged several pages in 2026.
Every datable claim in this lesson links here to the public text behind it. A source that does not open proves nothing.
- Define success criteria and build evaluations consultée le 2026-09-02
- Metaprompt (Anthropic cookbook) consultée le 2026-09-02