check-understanding

Check Understanding

Test your knowledge of a completed phase from the AI Engineering from Scratch course.

Activation

This skill activates when the user says things like:

• /check-understanding 3 or /check-understanding deep-learning
• "quiz me on phase 2"
• "test phase 1"
• "check my understanding of transformers"
• "do I know phase 3"
• "am I ready for the next phase"

Input

Accepts a phase number (0-19) or a phase name as argument. If no argument is provided, ask the user which phase they want to be tested on by listing all 20 phases.

Phase Map

Map the argument to the correct phase directory under phases/:

Procedure

Step 1: Resolve the Phase

Parse the argument. If it is a number, validate it is between 0 and 19 inclusive. If the number is out of range, tell the user: "Phase [N] does not exist. Valid phases are 0-19." and show the full list for them to pick from. If it is a name or keyword, look it up in the Phase Map above. If the keyword does not match any entry in the map, tell the user: "Unknown phase '[keyword]'. Pick from the list below:" and present all 20 phases. If no argument is provided, ask the user to pick from the full list.

Step 2: Read the Phase Content

If the repo is cloned (a phases/ directory exists in or above the current directory), find all lesson directories under phases/<phase-dir>/ and read each lesson's docs/en.md. If it is not cloned, get the phase's lesson list from the Contents section of the README (fetch https://raw.githubusercontent.com/rohitg00/ai-engineering-from-scratch/main/README.md), then fetch each lesson's docs/en.md from the same raw base URL. These documents contain the teaching material you will generate questions from.

Read as many lesson docs as needed to cover the full breadth of the phase. If a phase has many lessons (15+), prioritize reading a representative spread: first few, middle, and last few.

Step 3: Generate 8 Questions

Create exactly 8 multiple-choice questions drawn from the lesson content you just read:

Questions 1-4: Conceptual (What/Why) These test understanding of ideas, definitions, and reasoning. Examples:

• "What is the purpose of X?"
• "Why does Y happen when Z?"
• "Which statement best describes the relationship between A and B?"
• "What problem does X solve?"

Questions 5-8: Practical (How/Build) These test applied knowledge and implementation awareness. Examples:

• "How would you implement X?"
• "Which approach correctly solves Y?"
• "What is the correct order of steps to build Z?"
• "If you observe X during training, what should you do?"

Each question must have exactly 4 answer options labeled A, B, C, and D. Exactly one option is correct. The wrong options should be plausible but clearly incorrect to someone who studied the material.

Tag each question with the specific lesson it draws from (e.g., "Lesson 03: Matrix Transformations").

Step 4: Present Questions One at a Time

Use the AskUserQuestion tool (or equivalent interactive prompt) to present each question individually. Format:

Question 1/8 (Conceptual) -- from Lesson 03: Matrix Transformations

What is the geometric interpretation of an eigenvalue?

A) The angle of rotation applied by the matrix
B) The factor by which the eigenvector is scaled during transformation
C) The determinant of the transformation matrix
D) The rank of the matrix after transformation

Wait for the user's answer before moving to the next question.

Answer isolation

Keep the correct option and explanation private until the learner answers the current question. Never use a real answer letter, a likely answer, or the generated answer distribution in a reply-format hint. When a plain-text hint is needed, use exactly: Reply with one letter: <A|B|C|D>.

Step 5: Track and Score

Keep a running tally:

• Total correct out of 8
• For each wrong answer, record: the question number, the user's answer, the correct answer, and which lesson it came from

Step 6: Show Results

After all 8 questions, display the score and grade:

7-8 correct: Mastered If the phase is 19 (Capstone Projects): "You have mastered Phase 19, the final phase." Add "Congratulations, you have completed the entire curriculum." only when you can verify the rest of the curriculum is done (a LEARNING.md in the current directory whose Path table shows Phases 0-18 as Done or Skip); a single phase quiz does not prove full completion. Otherwise: "You have a strong grasp of Phase N. You are ready to move on to Phase N+1: [next phase name]."

5-6 correct: Almost "Solid foundation. Review these specific areas before moving on:" Then list the lessons tied to the missed questions.

3-4 correct: Developing "You are building understanding but need to revisit some lessons:" Then list each missed question with the lesson to re-read.

0-2 correct: Start Over "This phase needs more time. Work through the lessons again from the beginning, focusing on:" Then list all missed topics.

Step 7: Wrong Answer Breakdown

For every question the user got wrong, show:

Question N: [question text, abbreviated]
Your answer: B
Correct answer: C -- [the correct option text]
Why: [1-2 sentence explanation of why C is correct]
Review: Lesson NN -- [lesson name] (phases/<phase-dir>/NN-<lesson-slug>/docs/en.md)

Step 8: What Next?

End by offering three choices:

1. Retake this quiz -- generate a fresh set of 8 questions from the same phase
2. Try another phase -- pick a different phase to test
3. Explain a topic -- ask about any concept from the questions you missed

Wait for the user's choice and act accordingly.

Rules

• Avoid repeating questions on retakes until the question pool is exhausted. Once exhausted, reshuffle or rephrase questions for subsequent retakes.
• Questions must be directly grounded in the lesson docs, not general knowledge.
• Do not show the correct answer until after the user responds.
• Do not include literal answer letters in examples of how the learner should reply; use <A|B|C|D> as the placeholder.
• Keep question text concise. One or two sentences max.
• Wrong options must be plausible. No joke answers.
• If a phase has no lesson docs written yet (no en.md files found), tell the user: "Phase N does not have lesson content yet. Pick a completed phase to quiz on."