Worked Example with Reasoning¶
Artifact — instantiates Cognitive Apprenticeship Modeling
A durable, annotated exemplar that shows not just the finished solution but the decision points, cues, and error checks behind it — a studyable trace of expert reasoning.
A finished solution shows the destination and hides the route. A Worked Example with Reasoning is a durable artifact that captures both: the completed work and, alongside each step, the decision that produced it — why this move and not the obvious alternative, which cue triggered it, and the check that caught an error before it propagated. Unlike a live demonstration it is frozen and re-studyable — a learner can pause on the one step that puzzles them, return a week later, or set it beside a second example to see what varies. Its defining role is to be the reference exemplar: a worked case, authored to teach, that a novice studies to internalize a pattern and that sits in a growing library of such cases.
Example¶
A senior engineer turns a completed beam-sizing calculation into a reference exemplar for the firm's new graduates. The artifact isn't just the final section chosen; every line carries the reasoning. Beside the load combination: "We use 1.2 dead + 1.6 live here — but check whether wind governs. It doesn't for this interior beam; on a perimeter beam it would, so always test it." Beside the deflection check: "Strength passed with margin, but serviceability is what actually sizes this member — the common trap is to stop at strength." A margin note flags a deliberately shown misstep: "First pass I used the wrong effective length; here's how the number looked wrong and how I caught it." A graduate studying it a month later sees not the answer but the judgment — which checks govern, which are formalities, where people slip — and can hold it beside a second exemplar (a column) to see which reasoning generalizes and which was specific to the beam.
How it works¶
What distinguishes it is that it is a durable, annotated artifact built to be studied and reused, not a live event:
- Annotate the why, step by step. Each move carries the reasoning, cue, or rule that produced it, so the trace teaches the decision and not just the result.
- Show the checks and a caught error. Include at least one place where a plausible wrong path is tested and rejected, so the example models verification, not just success.
- Make it re-studyable at the learner's pace. Because it is frozen, it supports pausing, re-reading, and side-by-side comparison — things a live demonstration cannot.
- Design it to sit in a set. It is authored so a family of examples spans the variation a learner must eventually handle.
Tuning parameters¶
- Annotation grain — reasoning on every step vs. only the pivotal ones. Fine grain leaves nothing implicit but buries the key decisions in noise; coarse grain highlights what matters but assumes the reader can fill the gaps.
- Idealization vs. mess — a clean canonical solution vs. one that keeps the false starts. Clean examples are easier to follow; messy ones teach recovery and realism.
- Fading across the set — how much reasoning later examples spell out vs. leave for the learner to supply (a completion example). Withholding reasoning turns study into practice, but too early it just confuses.
- Abstraction level — whether annotations name the transferable principle or stay in the specifics of this case. Naming the principle aids transfer; staying concrete keeps it grounded.
When it helps, and when it misleads¶
Its strength is leverage: authored once, an exemplar teaches many learners on their own schedule, and a well-built set front-loads pattern recognition before a novice ever performs under pressure. Studying reasoned examples is a well-established, efficient way into a new skill.[n1]
Its failure modes come from its passivity. A learner can read a worked example, feel the smooth click of understanding, and walk away unable to generate the same solution unaided — an illusion of competence that fluent reading creates and only doing dispels.[n2] Frozen examples also stale: an exemplar built around last year's tool or policy quietly teaches the outdated move. And because it is authored to look clean, it can hide the floundering that real work involves. The disciplines that guard against this are to require the learner to self-explain or complete the example rather than just read it, to refresh the set as practice changes, and to pair the artifact with live attempts where a coach can see whether the pattern actually took.
How it implements the components¶
visible_reasoning— the annotations externalize the decision points, cues, and error checks behind the solution; here the reasoning is captured in durable, inspectable form rather than spoken once and gone.case_repertoire— authored to sit in a set, worked examples accumulate into the library of cases that spans the variety a learner must eventually handle.
As a static artifact it hosts no live coaching_feedback or learner_articulation (that's Paired Problem Solving and Coached Practice Session), provides no guided_observation_frame for watching real work (that's Shadowing with Debrief), and runs no transfer_check under performance (that's Simulation with Debrief). It is the reference exemplar the learner studies; the doing happens elsewhere.
Related¶
- Instantiates: Cognitive Apprenticeship Modeling — a durable, studyable exemplar of expert reasoning that seeds the learner's repertoire.
- Sibling mechanisms: Think-Aloud Demonstration · Simulation with Debrief · Paired Problem Solving · Shadowing with Debrief · Cognitive Walkthrough · Annotated Decision Record · Case Conference · Coached Practice Session · Learner Explanation Prompt · Apprenticeship Rotation
Editorial Notes¶
Form Classification¶
Form family: Communication, Facilitation & Learning
Rationale: Worked Example With Reasoning is defined in the frozen evidence as: A durable, annotated exemplar that shows not just the finished solution but the decision points, cues, and error checks behind it — a studyable trace of expert reasoning. Its operative deployed or enacted form is therefore Communication, Facilitation & Learning.
Nearest alternative: Interface, Display & Cue — Interface, Display & Cue can support this mechanism, but the evidence centers the concrete operation described above rather than the alternative family's defining operation.
Review outcome: Adjudicated after independent review; medium confidence.
Origin Attribution¶
Primary origin: Education & Pedagogy
Origin pattern: Cross-disciplinary synthesis
Present-day reach: Universal
Rationale: Worked example with reasoning is rooted in education's instruction, assessment, and scaffolded-practice tradition; historically that field developed the defining operation described here: a durable, annotated exemplar that shows not just the finished solution but the decision points, cues, and error checks behind it — a studyable trace of expert reasoning.
Related originating lineages:
- Cognitive Science — Cognitive-science research on representation, learning, and recall has a distinct contributing or parallel lineage for the mechanism's defining operation: a durable, annotated exemplar that shows not just the finished solution but the decision points, cues, and error checks behind it — a studyable trace of expert reasoning.
- Organizational & Management Science — Organizational management's workflow, staffing, review, and coordination tradition supplies an independent formative lineage for the mechanism's worked example with reasoning logic.
- Psychology — Experimental, clinical, and behavioral psychology has a distinct contributing or parallel lineage for the mechanism's defining operation: a durable, annotated exemplar that shows not just the finished solution but the decision points, cues, and error checks behind it — a studyable trace of expert reasoning.
Review resolution: The blind reviewers agree that education_pedagogy is the primary origin and differ only on alternate origin disagreement, origin mode disagreement, domain reach disagreement, encyclopedia synthesis disagreement. I preserve every independently explained alternate from both records rather than imposing a numeric cap. I retain cross_disciplinary_synthesis because the combined evidence shows material contributions from several lineages. The broader reach of universal records portability separately from historical provenance; encyclopedia_synthesis=true preserves the affirmative synthesis judgment where either reviewer identified one.
Encyclopedia synthesis: The exact catalogued form synthesizes established practice rather than reproducing a single standard historical label.
Review outcome: Reconciled after independent review; high confidence.
Notes¶
A worked example is authored to teach, which sets it apart from an Annotated Decision Record that documents a real decision for the record: the example may be idealized, sequenced for a learner, and stripped of irrelevant detail, whereas the record must stay faithful to what actually happened. Reuse a real decision record as a teaching example only after re-annotating it for the learner — otherwise its gaps and context-specific shortcuts teach the wrong lesson.
[n1] Studying worked examples is, for novices, often a more efficient route to skill than unguided problem-solving — the worked-example effect from cognitive-load theory. Its advantage shrinks as expertise grows and problem-solving practice should take over. ↩
[n2] Learners who explain a worked example to themselves — filling the reasoning gaps aloud — learn markedly more than those who read passively; the self-explanation effect. It is the standard corrective to the illusion of competence that smooth reading produces. ↩