Eli Item-Writing Academy
About 35 minutes · Academy module: Difficulty Calibration: Estimating Tiers Honestly.
Every difficulty label in this system is an estimate from item features — never a calibrated psychometric value. The honest copy rule: UI and reports say "estimated difficulty," never "difficulty." Estimates exist to seed adaptive practice and balance exam forms; they are replaced by real response data (p-values) as soon as students answer the item.
The sidecar (see `js/difficulty.js`) scores observable features: longer stems cost more working memory; five options cost more than four; a fact pattern dense with legal detail costs more than a clean hypothetical; multi-step phrasing ("best explains," "most likely," "best defense") signals layered reasoning. Score 0–1 → easy; 2–3 → medium; 4+ → hard. The heuristic is documented, deterministic, and auditable — anyone can recompute any tier by hand.
Once an item has ~30+ responses, compare its estimated tier to its p-value. Systematic mismatches teach you about your own writing: if your "easy" items keep landing at p = 0.45, you're underestimating your distractors' pull. Keep a calibration log — it's the fastest way to become a better estimator.
Never use estimated tiers for high-stakes decisions: pass/fail cut scores, grades, or "readiness" verdicts. Estimates seed practice and balance forms; only response data plus faculty judgment make consequential calls. The system's flags are review signals, never verdicts.
presenting an estimate as a measurement, and worse, as a readiness signal. The label was assigned by heuristic before a single student answered the item.
The honest framing: "estimated hard — long fact pattern, multi-step call." Readiness is a property of students, estimated from response data across many items, never of one item's label.
— how the item should be presented:
Estimated difficulty: hard (long fact pattern, multi-step reasoning). Estimates come from item features, not student data — they'll update as responses come in.
The label is the same; the honesty around it is the fix. Estimates guide practice; they never certify readiness.
Recording it adds the module to your Academy completion record on this device — module, track, level, and date, ready to download from your account page for faculty-development documentation.