Week 2 of 12 · The Craft

Why the Rubric Is the Job

The guideline is the highest-leverage artifact a data lead owns — every label your team produces is capped by it

Day 6 ~70 minutes Concept

Day 6 of 66

The artifact that decides everything

Last week you learned to see the training loop. This week you learn to control it — and control runs through one document. A rubric (also called annotation guidelines, a labeling spec, or a scoring guide) is the written definition of what "good" means for a task. It's the instruction every tutor reads before they rate a Grok image, and it's the only thing standing between a team and a pile of inconsistent, unusable labels.

The thesis of the week

Every label your team produces is capped by the quality of your rubric. A brilliant annotator following a vague guideline produces vague data. A mediocre annotator following a razor-sharp guideline produces usable data. You cannot out-hire a bad rubric. As a lead, the rubric is the single biggest lever you own — and authoring it is the work, not paperwork around the work.

This reframes the whole job. As a tutor, you follow rubrics; the quality of your output depends on your skill. As a lead, you write them; the quality of an entire operation's output depends on your specification. The leverage is enormous — and so is the responsibility.

Better instructions beat more QA

There's a tempting wrong answer to inconsistent data: add a review layer. Hire QA reviewers to catch the bad labels after the fact. It feels like diligence. It's mostly waste.

Core Theory

The research consensus across labeling operations is blunt: improving the instructions yields a larger, cheaper, more durable quality gain than adding inspection downstream. A QA layer catches errors one at a time, forever, and never fixes the cause. A clearer guideline removes the error at the source — for every annotator, on every future item, at no recurring cost.

Inspection scales linearly with volume; you pay for it on every item you ever label. A guideline fix is paid once and amortized across all future work. This is why a lead's hours spent sharpening a rubric are the highest-return hours in the operation — and why "we'll just review harder" is the signature of a team that doesn't understand where quality comes from.

This is the same data-centric instinct from Week 1, aimed one level down: don't patch the symptom (bad labels) with more labor (review); fix the system (the guideline) that produced them. Snorkel's writeup makes the downstream version of this argument — guideline quality propagates straight into model quality — and it's the case you'll make when you ask leadership to fund rubric work instead of more reviewers.

The five components every great rubric needs

A rubric isn't a paragraph of good intentions. It's a structured document. After studying the best public guides (Eugene Yan's is the canonical one; V7's is the visual, industry view), the same five components show up every time. Memorize them — your Week 2 portfolio rubric must contain all five.

#ComponentWhat it doesWhat breaks without it
1Clear scale & class definitionsDefines every label and every point on every scaleTwo people read "3" differently
2Weighted dimensionsSays which qualities matter and how muchPretty-but-wrong outputs pass; the team optimizes the wrong thing
3Worked examplesShows real items with their correct label and the reasoningThe definition stays abstract; nobody knows what a 4 looks like
4Counter-examplesShows near-misses: what looks like a 4 but is a 3, and whyThe boundaries blur exactly where judgment is hardest
5Edge-case & "uncertain" rulesTells annotators what to do with weird cases and how to skip/flagPeople silently guess, and the guesses become invisible noise
The principle behind components 3 and 4

Examples over prose. One labeled example teaches more than a paragraph of definition, and a well-chosen counter-example teaches more than two paragraphs. Prose describes the rule; examples pin it to reality at the exact boundary where annotators hesitate. When you find yourself adding a third sentence of explanation, stop and add an example instead. Eugene Yan's whole structure is built on this — steal it.

Component 5 deserves a special note because it's the one beginners drop. A rubric that has no rule for "I'm not sure" forces annotators to fabricate certainty. The fix is an explicit skip / uncertain / flag path — a legitimate place to put the cases the guideline doesn't yet resolve. That's not a weakness in the rubric; it's the rubric's feedback channel, and you'll learn to mine it on Day 9.

Disagreement is a guideline problem, not a people problem

Here is the single most important reframe of the week, and the bridge to Week 3.

When two good annotators disagree, look at the rubric first

Low inter-annotator agreement — two people scoring the same item differently — is almost never because one of them is careless. It's because the guideline left room for two honest readings. The instinct to blame the people ("retrain the annotators") is the wrong instinct nearly every time. The right move is to find the case they split on and ask: what did my rubric fail to specify? Then fix that. Week 3 gives you the numbers to measure agreement; this week you build the document that creates it.

This is why rubric-writing is a leadership skill and not a clerical one. The lead who treats disagreement as a defect in people manages by blame and never improves. The lead who treats disagreement as a defect in the specification has a precise, fixable signal pointing at exactly which sentence to rewrite. You are training to be the second kind.

One scale up, the same idea defines a whole alignment technique. Anthropic's Constitutional AI replaces a pile of human safety labels with a short written "constitution" — a set of principles the model applies to itself. Read that as proof of the thesis at maximum scale: a constitution is just a rubric, applied at model scale. The clearer the principles, the better the behavior. The artifact you're learning to write this week is the same artifact, smaller.

Your work today

Read the masters & pick your task

~70 minutes

  1. Read Eugene Yan on writing labeling guidelines closely. As you read, map each thing he recommends onto the five components above. His structure becomes your skeleton.
  2. Skim V7's five best practices for the visual, image-domain framing — it's closest to your image/video world.
  3. Pick the task you'll write a real rubric for this week. Choose one you already know cold — image-generation quality is the strongest default. Write one sentence naming it and what "good" roughly means.
  4. Open a notes file and start collecting raw material: jot down where the guidelines you currently follow at xAI feel ambiguous. Every ambiguity you remember is a component-5 edge case in waiting.

The full curated resource list for the week is at the bottom of this page — those three reads are today's required ones.

The lead move

A tutor follows the rubric and produces good labels inside it; their ceiling is their own skill. A lead writes the rubric, and so sets the ceiling for everyone — a sharp guideline makes a mediocre annotator usable, and no amount of hiring out-runs a vague one. The altitude jump is from "I label accurately" to "I author the document that decides whether anyone can."

Say this in an interview: "When labels come back inconsistent, I don't reach for more reviewers — review catches errors one at a time forever and never fixes the cause. I'd fund the rubric, because a guideline fix is paid once and removes the error at the source for every annotator on every future item."

Today's Takeaways