quiz-bank

# Quiz Bank

A quiz that only asks "recall this" teaches nothing new. State the Bloom mix first. Trap real misconceptions. Ship a key that explains why.

Inspired by SkillMedev educators-toolkit quiz-generator (MIT). Original Grok remake. Complements pulse-check (tiny 1-3 CFU), study-loop (student flashcards), score-grid (rubrics), glow-grow (feedback). Education only.

Read `references/quiz-rails.md` before you write. Fill the three templates under `templates/`.

## When to use

- Build a quiz, unit check, or review set with a named Bloom's mix
- Multiple-choice items that catch known wrong ideas, not joke options
- Answer key with why-correct and why-each-distractor
- Summary table: question #, level, type, points

## When NOT to use

- Tiny 1-3 item formative CFU with response routing → use pulse-check
- Student flashcards / spaced practice deck → use study-loop
- Essay or project scoring rubric → use score-grid
- Comments on finished student work → use glow-grow
- Opinion polls or research surveys (not knowledge checks)
- Live high-stakes exam keys for an exam in progress

## Inputs

- Topic and objectives / content covered (required)
- Grade band or course level (required)
- Purpose: formative (default), unit exam, or performance/review
- Question count and rough time budget (default ~10; ~1 min MC, 3-5 short answer, 10+ constructed)
- Known misconceptions (ask; if missing, invent typical partial ideas and label them guesses)
- Constraints: paper vs digital, calculator, open notes

## Procedure

1. Read `references/quiz-rails.md`. Refuse live exam keys and out-of-scope siblings.
2. Lock the Bloom mix before any stem. Formative ≈ 40% Remember/Understand, 60% Apply. Unit exam: reach Analyze/Evaluate; ≤50% of points on Remember/Understand. Performance/review: Evaluate/Create lead. All-recall is a red line — rebalance first.
3. Match type to level: MC for Remember/Understand (sparingly Apply+); short answer for Apply–Evaluate; constructed/scenario for Analyze+; true/false only as ungraded diagnostic, never graded summative.
4. Write stems. Lower-order = direct. Higher-order = short scenarios/data, no cultural trivia that muddies the construct.
5. Build MC distractors from misconceptions only. Correct answer must be unambiguous. Parallel length/grammar. No all/none-of-the-above except tightly controlled cases. No joke options.
6. One idea per item. A wrong answer that could mean two different gaps is useless.
7. Fill `templates/bloom-plan.md` with the declared mix and point budget.
8. Fill `templates/item-bank.md` with stems grouped by Bloom level, total points stated.
9. Fill `templates/answer-key.md` with correct answer, one-line rationale, and per-distractor misconception. Offer student-facing copy (no key) separately if asked.
10. Check the summary table against the Step 2 declaration. If points drifted, fix items — don't rewrite the plan to match a weak set.

## Output format

- Bloom plan (declared mix + point budget)
- Item bank (grouped by level, types, points)
- Answer key (rationales + distractor misconceptions) and level/type/points table
- One line: educational assessment bank; not a live exam breach or survey tool

## Safety

- Follow `references/quiz-rails.md` with no exceptions.
- Age-appropriate stems for the grade band. No sexual content involving minors. No self-harm examples.
- Do not invent PII. Do not deliver live high-stakes keys for an exam underway.

## Stop conditions

- Three templates delivered, or refused for wrong skill / live exam key / missing topic or grade