Free to read · no account needed

9 min · prompt

Rubrics and acceptance tests for prompts

Goal: Tell the model how you will score it first—aim at the checklist, not at “feels fine.”

Best for: Recurring tasks where “looks fine” is not enough: apologies, briefs, status updates, study summaries.

A rubric turns taste into tests. Keep it short (4–6 checks). Ask the model to score itself, then revise until checks pass—and you still do the final human gate.

A rubric turns “looks good” into pass/fail. Write 4–6 observable checks before you generate—so you are not grading your own vibe.

Freeze the rubric before you generate. If you rewrite the checklist to match a draft you already like, you are not evaluating—you are decorating.

Tape the rubric where you can see it while the model streams. Changing scores after you fall in love with a draft is cheating.

Why beginners skip this

Editing with no rubric feels like feedback—both sides will disagree on “good.” Write the rubric first.

Step 1 — Tiny rubric template

Copy a tiny rubric and freeze it before you score—do not edit the bar after you like a draft.

Acceptance tests (must pass):
- [ ] Has sections [A/B/C]
- [ ] No invented numbers / URLs
- [ ] ≤ [N] words
- [ ] One concrete next step
- [ ] Tone: [plain/warm/formal]
Score each Yes/No. If any No, revise once and re-score. Do not add new facts to pass.

Step 2 — Customer apology rubric

Example

Filled prompt

Deliverable: Friday update ≤150 words.
Rubric: traffic light · ≤3 owned asks · no new metrics · no fluff opener.
Score a draft; list fails.

What good output looks like

  • Goal/Format/Boundaries all present for “Tell the model how you will score the answer—so it”
  • One example beats stacked IMPORTANT words
  • Version/date kept when template changes
  • Pass/fail: zero clarifying turns on live task

Step 3 — Save rubrics with templates

Store the rubric under the same versioned prompt card. When a new failure mode appears twice, add a checkbox.


Example

Filled prompt

Deliverable: Friday stakeholder update ≤150 words.
Write rubric: 4 pass/fail checks (traffic light, ≤3 asks with owners, no new metrics, no fluff opener).
Run once on a draft; mark fail reasons.

What good output looks like

  • One example beats stacked IMPORTANT words
  • Version/date kept when template changes
  • Pass/fail: zero clarifying turns on live task
  • Goal/Format/Boundaries all present for “Tell the model how you will score the answer—so it”

Save this card

Card: Turn feeling-words into yes/no tests so a stranger can gate your draft. Keep this beside the tool; read before you start.

Before you start

Keep the last failing output visible. You will repair the prompt for “Rubrics and acceptance tests for prompts” against that failure—not a fresh toy ask. Guide: prompt-rubrics-and-acceptance-tests. Keep the real job visible the whole time; a blank box means stop and fetch the artifact first.

How to use this week

This week write 3 scorable criteria + 1 acceptance test for a real task; no stop until they pass.

Close the week by quoting aloud the refuse line you actually used once. If you cannot, rerun Practice now and date the pass/fail (Asia/Shanghai).

Freeze then generate

Changing the rubric to match a draft you like invalidates the test. Paper first.

Keep it real

Run this guide’s Practice now on work you will actually ship this week—not a fictional scenario. Dated notes beat perfect theory.

Do not bookmark-only

Finish Practice now, then tick this guide on your path. Titles unread are not skills.

Close the loop

Write one line: next time I edit with no rubric, I refuse stop.

Example

Filled prompt

Deliverable: image prompt for docs header.
Rubric 4 checks: subject, style, ≥3 must-nots, one revise instruction.
Score my weak prompt, then rewrite to pass.

What good output looks like

  • Version/date kept when template changes
  • Goal/Format/Boundaries all present for “Tell the model how you will score the answer—so it”
  • Pass/fail: zero clarifying turns on live task
  • One example beats stacked IMPORTANT words

Red flag

Feeling-words as Done; stranger cannot gate the draft—convert to yes/no tests.

Pitfalls

PitfallFix
15 vague criteriaCap 4–6 objective checks
Letting “score 10/10” replace Yes/NoPrefer binary pass/fail
Model invents facts to pass length/toneBan new facts in the rubric
Skipping human reviewRubric assists; you ship

Example

Filled prompt

Temptation: skip the habit for prompt-rubrics-and-acceptance-tests to save five minutes.
Job still: Tell the model how you will score the
Smallest correct pass: Done visible · checkable artifact · Unknowns [?].
Boundaries: draft only; no silent send; no invented metrics.
Return: artifact + refuse-line said aloud.

What good output looks like

  • Names the shortcut refused (specific to prompt-rubrics-and-acceptance-tests)
  • Still delivers checkable output for “Rubrics and acceptance tests for prompts”
  • Unknowns labeled; draft-only
  • Pass/fail: refuse-line dated (prompt-rubrics-and-acceptance-tests #4)

Practice now

Golden file: one golden output checked into Save folder (Asia/Shanghai).

Must-pass tag: mark must-pass checks with ★ on the rubric (Asia/Shanghai).

Weight note: mark which rubric check is must-pass vs nice (Asia/Shanghai).

Fail fixture: one intentional failing sample must trip the rubric (Asia/Shanghai).

Rubric drill: write pass/fail rubric with 3 checks; run once on a draft (Asia/Shanghai).

Thin-spot drill: rewrite the Save card with real nouns from your work (repo, doc, inbox). Generic placeholders fail the drill.

Tonight write 3 scorable rubric lines + 1 acceptance veto for a real task; no done until it passes.

Today card (copy) — prompt-rubrics-and-acceptance-tests: 1. Artifact I will produce: ___ 2. Pass/fail check: ___ 3. Refuse-line if tempted to skip verify/send: ___ (date: Asia/Shanghai) 4. One never-do from this guide: ___

Extra pass: do the card on a real file today—reading alone does not count.

Ship-check: artifact path ___ · refuse-line dated Asia/Shanghai ___ · never-do ___

One sentence takeaway

3 scorable criteria + 1 acceptance test; no stop until pass.

Next

Chaining · GFB · Eval outputs

← Back to home · Learn · Tools · Compare · Start