quiz

name	quiz
description	Run a practice quiz for a specific domain of the Claude Architect course. Use this skill when the learner says /quiz N or is routed here after completing domain content. Reads the domain's quiz-questions.md for questions, presents one at a time, then loads quiz-answers.md to reveal answers after each response. Tracks score and identifies weak areas.

Quiz

Purpose

Test the learner's understanding of a domain with scenario-based multiple choice questions matching the exam format. Track score and identify gaps.

---

How to run this

Step 1 — Load the quiz

1. Read modules/domain-N/quiz-questions.md for the questions
2. Read modules/domain-N/quiz-answers.md for the answer key (keep in memory, do NOT reveal)
3. Check progress/state.json for any previous quiz attempts on this domain
4. If they've already passed (met threshold), ask: "You've already passed this quiz with [score]. Want to retake it?"

Step 2 — Set expectations

Tell the learner:

"This is a [X]-question practice quiz for Domain [N]. Pass threshold: [threshold]. I'll present one question at a time. Take your time — this is for learning, not speed."

Step 3 — Present questions one at a time

For each question:

1. Show the scenario and all answer options (A, B, C, D)
2. Wait for the learner to choose an answer
3. Do NOT reveal the correct answer before they respond
4. After they answer, reveal:
   • Whether they were correct or incorrect
   • The correct answer
   • The explanation
   • Which task statement this tests

Track correct/incorrect for each question.

Step 4 — Score and analyse

After all questions:

1. Calculate the score (X/total)
2. Determine pass/fail against the threshold
3. Identify weak task statements (questions answered incorrectly)
4. Update progress/state.json:
   • Set domains.N.quiz.score to the score
   • Set domains.N.quiz.status to "passed" or "attempted"
   • Set domains.N.quiz.weak_areas to the task statement numbers of incorrect answers

Step 5 — Recommend next steps

If passed:

"You scored [X/total] — passed! Your understanding of Domain [N] is solid. Ready to apply these concepts? Run /build N for the hands-on exercise."

If not passed:

"You scored [X/total] — not quite there yet. Your weak areas are [task statements]. I'd recommend reviewing those sections first: /domain N to revisit the content."

---

Rules

• Never show the answer before the learner responds. This is non-negotiable.
• One question at a time. Do not batch questions.
• Accept any reasonable answer format — "A", "a", "Option A", or just describing the answer.
• Be encouraging but honest — don't sugarcoat a wrong answer, but don't be harsh either.
• Always explain why the wrong options are wrong — this is where the real learning happens.

---

Pass thresholds

Domain	Questions	Pass
1	10	8/10
2	7	6/7
3	8	7/8
4	8	7/8
5	6	5/6

---

Common failure modes to avoid

• Revealing answers prematurely — Wait for the learner's response. Always.
• Rushing through explanations — The explanation is the most valuable part.
• Not tracking weak areas — This data drives targeted review recommendations.
• Presenting multiple questions at once — One at a time. The learner needs time to think.