Explicit criteria for precision
What this covers
- Replace vague quality instructions with categorical criteria
- Explain why "be conservative" does not reduce false positives
- Recover developer trust when one category is noisy
- State what to skip as well as what to report
- Define each severity level with concrete code examples
- Choose a written rule when an exclusion is a fact and examples when it is a judgment
Key terms
- Rubric
- A set of written criteria used to judge work consistently.
- Validation set
- Examples kept separate from development and used to measure how well a system works.
Vague instructions do not become precise by being emphatic
"Check that comments are accurate" and "only report high-confidence findings" sound like precision controls. They're not. They give the model no test to apply, so it substitutes its own — and its own varies run to run.
Compare with: flag a comment only when the behavior it claims contradicts what the code actually does. That's a criterion. It can be applied consistently because it says what counts.
The general lesson is that precision comes from defining which findings qualify. An instruction such as "be conservative" doesn't provide a rule the reviewer can apply consistently.
A confidence threshold doesn't tell you whether a finding is useful. A reviewer may correctly identify a pattern that the team intentionally accepts. Confidence measures how certain the reviewer is, not whether the pattern violates the team's rules.
Say what to report and what to skip
Define both sides. Report bugs and security issues; skip minor style and patterns local to this codebase. A reviewer that knows what to ignore is far more useful than one asked to be selective in general.
Use a written rule for clear exclusions. For example, state that import order should be skipped when a formatter already enforces it. Use examples when the difference between acceptable and unacceptable code requires judgment.
How false positives reduce trust
A category with many false positives wastes review time and makes developers less likely to trust other findings. They may then overlook a real bug.
If one category is producing too many false positives, temporarily disable that category while you improve its prompt. This protects trust in the remaining categories.
Severity needs examples
Severity labels are read differently by different people, and by the same model on different runs. Defining each level with concrete code examples is what makes classification consistent — the same move as few-shot examples in 4.2, applied to a labeling task.
A rubric that anchors each level to a construct, so two runs classify the same finding the same way:
critical db.query("SELECT * FROM users WHERE id = " + req.params.id)
high fetchRows() // returns a promise, nothing awaits it
low let tmp = total * 2 // vague name in a ten-line functionNotice that no line uses an adjective. "Serious" and "minor" are the words that drift between runs; a construct a reviewer can point at in the diff doesn't.
review criteriaseverity definitionsfalse positive rates
Field note — common misconceptions
- MythThat asking for higher confidence raises precision
- ActuallyPrecision comes from stating which things qualify; a criterion gives the model a test to apply.
- MythThat a noisy category only costs you that category
- ActuallyA bad false positive rate erodes trust in the accurate categories, so developers skim past all of them.
- MythThat severity levels are self-explanatory
- ActuallyDefining each level with concrete code examples is what makes classification consistent across runs.
Guided review
Review this lesson as a study deck
Review the lesson's main ideas in five guided slides, then test yourself with three flashcards.
Open Task 4.1 study deckCross-domain reasoning
Connect this idea
Evaluation continues through delivery
Clear criteria, examples, repeated testing, continuous integration, independent review, and human review all provide evidence that a change works as intended.
- 3.5 · Apply iterative refinement techniques for progressive improvement
- 3.6 · Integrate Claude Code into CI/CD pipelines
- 4.2 · Apply few-shot prompting to improve output consistency and quality
- 4.6 · Design multi-instance and multi-pass review architectures
- 5.5 · Design human review workflows and confidence calibration
Applied practice
Practice this lesson in a lab
Use a related lab to create a decision, implementation or diagram, evidence record, and review.
- Lab 7 · CI review with a strict output contract
Make a review job distinguish a clean diff from malformed output, execution failure, and invalid evidence.
- Lab 8 · Structured extraction and batch evaluation
Compare extraction strategies against labeled synthetic data without hiding critical-field failures.