Quest Ladder
TeachFORGE.ai
Quest Ladder / Solutions
Solution steps and common errors
What a learner reads after they have answered, and what you want them to take from it.
The solution is the lesson. Most learners read it.
What it is
Solution steps are the step-by-step worked solution shown after the attempt. Each step is its own editor step, and the two labels you see refer to the same thing: the sidebar calls it Solution 2 and the bottom bar Step 2. There is no separate solution method with sub-steps inside it.
Each has a Step heading, the content itself built from content blocks, and Marks for this step where the format is marked by hand.
Writing them
The solution is read by more learners than any other part of the question, because it is read by everyone who got it wrong and most of the people who got it right. It deserves more care than it usually gets.
- One idea per step. A step that does three things is a step a learner cannot locate their mistake in.
- Say why, not only what. Divide both sides by 4 is a move; divide by 4 to isolate x is a method.
- Insert the variables rather than typing numbers, so the solution matches the version the learner actually saw.
- End at the answer, and no further. A step after the answer is a new lesson.
The most common defect in a generated solution is a typed number that no longer matches the generated stem. Read one sampled solution end to end against its own stem before publishing — it takes a minute and catches almost every instance.
Common errors (author notes)
Each step has a Common errors (author notes) field. It is not shown to learners: it is a note to yourself and to whoever maintains this type next, recording what tends to go wrong at this step.
It earns its keep twice. It tells the AI on the assisted lanes what to watch for when it drafts feedback, and it tells you what distractors to write when you come back to improve the options.
Marks per step
On formats that reach the marking queue, the marks on each step become the rubric you mark against, and the composed total updates as you enter them.
Put the marks where the thinking is rather than spreading them evenly. If step two is the insight and step three is arithmetic, a learner who reaches step two has earned most of the credit, and a rubric that says so marks thirty scripts consistently.