Docs · skills/heuristic-audit/reference/rubric.md

Audit rubric

Nielsen's ten, sharpened into things you can actually observe, plus four that matter in enterprise and regulated software.

#HeuristicWhat counts as evidence
1Visibility of system statusA state change with no feedback; a wait with no indicator; a saved thing that doesn't say it saved
2Match to the real worldInterface language that isn't the user's language; ordering that follows the data model, not the task
3User control and freedomNo undo; no exit from a flow; destructive action with no confirm or no recovery
4Consistency and standardsThe same action named two ways; the same control behaving two ways; platform conventions broken without reason
5Error preventionInput that can be wrong but isn't constrained; irreversible action adjacent to a common one
6Recognition over recallInformation needed here shown only there; codes the user must memorise
7Flexibility and efficiencyNo path for the expert; bulk work only available one row at a time
8Aesthetic and minimalist designCompeting emphasis; more than one primary action; decoration carrying no information
9Error recoveryErrors that state a code, not a cause; errors with no next step; errors that lose the user's input
10Help and documentationHelp that isn't where the task is
11Data density and legibilityDense data with no hierarchy; numbers not right-aligned or not tabular; tables with no fixed reference column
12State coverageEmpty, loading, partial, error, permission-denied, offline — any one missing is a finding
13Trust and explainabilityAutomated or AI output with no confidence signal, no source, and no correction path
14AuditabilityAn action with consequences that leaves no visible record

Scoring a component or pattern

Five axes, 0–3 each. Anything scoring 0 on states or accessibility is a finding regardless of total.

Axis0123
StatesDefault onlySomeMostAll, documented
AccessibilityBarriersPartialConformantConformant and documented
DocumentationNoneA screenshotUsage guidanceUsage, do/don't, code parity
AdoptionUnusedOne teamMost teamsEverywhere it should be
Code parityNo coded twinExists, divergedMatches visuallyMatches in name, structure, behaviour

The method, written down

Every page here is one file from the skill library. The folder is loadable as a Claude project as-is.