Write quiz questions in the style of the course's real exams
All checks were successful
Verify and publish V2 container / build-and-push (push) Successful in 30s

Modelled on a real 50-question course exam and the V1 question set:
- Stems are short and plain (usually 15-30 words, one paragraph, no
  scene-setting), end in the exam's own question phrasing, and about a
  third may ask directly about a fact the nurse uses.
- Bold and underline are stripped from generated stems (plainStem).
- Choices are concise and parallel: a term or value, a 4-12 word action
  or finding, or quoted speech; explanations go in "why" (1-2 sentences).
- Distractors come from related facts in the material.
- Select-all items have 6 choices with 2-5 correct, mostly 3 or 4.
- The planner varies the kind of question instead of setting and role.
- Review, proofread, "improve questions" and the outside-chatbot
  instructions follow the same rules.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Elijah 2026-11-16 14:56:14 -07:00
parent 5fef59b07b
commit 39a85ebb0c
6 changed files with 55 additions and 21 deletions

View file

@ -634,10 +634,11 @@ Use exactly this shape:
Rules:
- "type" is "single" (multiple choice), "multi" (select all that apply) or "numeric" (the student types a number).
- "single" questions have exactly 4 options and exactly one with "correct": true.
- "multi" questions have 5 or 6 options, 2 to 5 of them correct, and the stem ends with "Select all that apply."
- "multi" questions have exactly 6 options, 2 to 5 of them correct (most often 3 or 4), and the stem ends with "Select all that apply."
- Use "numeric" for calculations (dosages, IV rates, drip rates, conversions, intake and output). Its "options" holds only the correct answer, e.g. [{ "text": "12.5 mL", "correct": true, "why": "Show the calculation" }]. The stem states the unit and how to round, e.g. "Round to the nearest tenth." Only the number is checked, so units in the answer are optional.
- Write NCLEX-style questions that test clinical judgment: a short client scenario (vary how stems open so they do not all start the same way), one clear question, priority wording where it fits (first, best, most important), and distractors that are plausible but wrong for a specific reason. Never use "all of the above" or "none of the above".
- Every option needs a one-sentence "why". The "rationale" explains the principle behind the correct answer, laid out for quick reading: one bold key sentence, then 2 to 4 short bullet points (use \\n between lines).
- Write NCLEX-style questions that test clinical judgment: a short, plain stem of usually 15 to 30 words with only the cues needed (vary how stems open so they do not all start the same way, and use no bold in stems), then one direct question such as "Which action should the nurse take first?" or "Which statement by the parent indicates a need for further teaching?". About a third may ask directly about a fact the nurse uses ("Which injection site is most appropriate?"). Never refer to the material itself in a question.
- Answer choices are concise and parallel: a term or value when the question asks for one, otherwise a short action or finding (about 4 to 12 words), or one or two sentences of quoted speech for client statements and nurse responses. No explanation tacked on, and the correct one never stands out as the longest or most detailed. Build distractors from related facts (a similar condition, a different stage, another drug or test) so they are plausible but wrong for a specific reason. Never use "all of the above" or "none of the above".
- Every option needs a "why" of 1 or 2 sentences with its specific clinical reason. The "rationale" explains the principle behind the correct answer, laid out for quick reading: one bold key sentence, then 2 to 4 short bullet points (use \\n between lines).
- "topic" is a short label. Reuse the same label for related questions and keep the number of different topics small.
- "difficulty" is "easy", "medium" or "hard".
- Markdown is allowed inside strings (bold, lists, tables). Write line breaks inside strings as \\n.