| name | worked-example |
| description | Generate ONE worked example with clear step-by-step solution for a given objective. Use this atom when lesson-planner needs a model problem for direct instruction or guided practice. Do NOT use for generating practice sets or assessments. |
worked-example
Creates a single worked example with numbered steps, reasoning annotations, and common-error callouts. Designed for teacher modeling during direct instruction.
Input
{
"objective": "Students will solve two-step equations.",
"grade": "7",
"subject": "Math",
"difficulty": "medium"
}
Output
{
"tool": "worked-example",
"example": {
"problem": "Solve for x: 3x + 7 = 22",
"steps": [
{"step": 1, "action": "Subtract 7 from both sides", "result": "3x = 15", "reasoning": "Isolate the variable term by undoing addition"},
{"step": 2, "action": "Divide both sides by 3", "result": "x = 5", "reasoning": "Undo multiplication to find x"}
],
"check": "3(5) + 7 = 15 + 7 = 22 ✓",
"common_error": "Students may try to divide by 3 first, getting x + 7/3 = 22/3 — remind them to undo operations in reverse order (PEMDAS backward)"
},
"human_review_required": true
}
Do NOT use this atom for
- Practice problem sets (use atom-activity-generate)
- Assessment items (use atom-assessment-item)
- Problems without step-by-step solutions
Pipeline note
Follows references/method.md at the Generation step (worked example). Output conforms to protocol-layer/metadata-schema.md. human_review_required: true — mathematical accuracy and grade-level appropriateness must be verified.
