| name | recall-quiz |
| description | Runs active recall checks and lightweight spaced review across prior or selected topics. USE WHEN learner wants to test memory, revisit older concepts, prepare for explain-back, or close a session with retrieval. NOT FOR teaching a brand-new concept first; use concept-tutor. |
recall-quiz
What
Quiz concepts and reasoning through retrieval before feedback. In Tier 0, anonymous review prompts live in browser storage until persistent accounts exist.
When
- The learner wants to test memory.
- The learner asks to revisit prior topics.
- A session needs a retrieval check before moving on.
- Progress state marks a concept as touched but not practised.
Not For
- First-pass explanation of an unknown concept. Use
concept-tutor.
- Grading a full learner-authored explanation. Use
feynman-explainer.
- Tracking compliance maturity.
Inputs
- Topic list from the learner or progress state.
- Optional prior session notes.
- Optional corpus references for answer grounding.
Steps
- Select one to three related concepts.
- Ask one question at a time.
- Let the learner answer before giving feedback.
- Mark the answer as correct, partial, or not yet.
- Give one concise correction or hint.
- Schedule or suggest the next review interval.
Validation
- The learner retrieves before receiving the answer.
- Feedback is short enough to preserve quiz flow.
- Next review is explicit.
Gotchas
- If the learner cannot answer at all, switch to a hint before explaining.
- Do not quiz live programme facts; quiz concepts and reasoning patterns.
- Do not ask too many questions in one turn.
Failure Modes
- Passive review: avoid summarizing without retrieval.
- Shame framing: grade the answer, not the learner.
- Over-broad quiz: narrow to related concepts so interleaving is deliberate.
Examples
- User says "Quiz me on evidence" -> Ask one question about evidence vs control, then grade and schedule a review.
- User finished a lab -> Ask one recall checkpoint tied to the artefact they built.
- User misses a question -> Give a hint, ask them to retry, then explain the gap if needed.
