promptkbBETA
← Field guidePRACTICAL FIELD NOTE

Test a prompt before you trust it

A small, repeatable test set beats a single impressive example.

A prompt is a hypothesis about how to get useful behavior from a model. One convincing answer is not enough evidence. Start with a few examples whose answers you can actually judge.

1. Define the job and a failure

“Make a good summary” is too broad. Try: “Produce a summary with up to five findings; support each finding with an exact quote; mark missing information instead of guessing.” A failure is then observable: a fabricated quote, an unsupported claim, or an omitted limitation.

2. Keep three small cases

Write the expected behavior before running the prompt. Do not require the exact same prose every time; check the properties that matter. Each template in the library includes sample inputs, checks, and a suggested edge case.

3. Run outside this workbench

Copy the rendered prompt into your chosen AI tool. Use a fresh conversation for each test so old context doesn't change the result. Record the model name, date, settings if available, prompt version, input, and complete output. Repeat important cases: the same model may answer differently on another run.

4. Score with evidence

For each criterion, record pass, fail, or uncertain, plus a quote or concrete reason. For extraction, parse the output and validate types and keys. For code, run relevant tests in an appropriately isolated environment. For claims, verify against the source. An AI-generated self-score is not a substitute for these checks.

Case: incomplete pilot report
Criterion: no invented cost estimate
Result: fail
Evidence: answer states “cost per team was $20”; source has no costs
Change to try: explicitly require unknown costs to be marked unknown

5. Change one thing, then rerun everything

Save the previous prompt before editing. A change that fixes your edge case may break the typical case. Keep a new version only when the results support it. Small test sets catch obvious regressions; they do not establish general reliability or safety.

Keep a local test notebook

In the workbench notebook, choose “Capture current prompt + inputs” before you run the prompt. Name the case and write the expected behavior. Paste the answer from your AI tool, then mark checks pass, fail, uncertain, or unreviewed and give evidence. Captured instructions and inputs stay unchanged as you edit the workbench. Use “Capture next revision” to reuse expectations with the current editor's prompt and inputs; outputs and judgments start empty.

Choose a second record to see both answers and check results. The comparison flags differing inputs or model names. Keep model settings and case inputs consistent when testing a prompt change. Export your current prompt to back up its notebook; all data stays local and clearing browser storage deletes it.

Or use a plain-text test record

Prompt version:
Model / date / settings:
Case name:
Input:
Expected behavior:
Output:
Checks (pass / fail / uncertain + evidence):
Next change:
Try it in the workbench →