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

@ -93,6 +93,20 @@ from the original, keeps "Select all that apply." and no longer opens the repeat
Calculations keep their wording. The writing rules, the batch prompt (which names openers already
overused) and the planner (setting, role, trigger) also ask for varied openings.
**Item style** is modelled on a real course exam (`NCLEX_RULES`, editable in Settings →
Templates as "NCLEX style"). Stems are short and plain, usually 15 to 30 words: only the cues
needed, then one direct question in the exam's own phrasing ("Which action should the nurse take
first?", "Which statement by the parent indicates a need for further teaching?"), in one
paragraph with no scene-setting that does not change the answer. About a third may ask directly
about a fact the nurse uses (an injection site, a pain tool, expected lab results). Bold or
underlined words are removed from generated stems (`plainStem`). Choices are concise and
parallel: a term or value when that is what is asked, a 4 to 12 word action or finding, or quoted
speech for client statements and nurse responses. Explanations go in each choice's "why" (1 or
2 sentences), not on the end of the choice. Distractors come from related facts in the material.
Select-all items have exactly 6 choices with 2 to 5 correct, most often 3 or 4. The same rules
appear in the batch prompt, the planner, the review and proofread rewrites, "improve questions"
and the outside-chatbot instructions.
**Rationales** are asked for as Markdown: one bold key sentence, then 2 to 4 short bullet points,
without repeating the per-choice "why" (`RATIONALE_FORMAT`, also in the question schema, the
review's rewrite schema, "improve questions" and the outside-chatbot instructions). The web app