| name | build-along |
| description | Guide the learner through a hands-on exercise step by step, having them do the work rather than watching. Use when the learner wants to practice, build something, do the exercise, or learn by doing for a module. |
Build-Along (Hands-On)
When to use
The learner wants to do, not just hear ("let's build it", "do the exercise", "hands-on").
Steps
- Open the exercise. Read
exercises.md in the relevant module folder.
- State the goal in one sentence: what they'll have built by the end.
- Break it into small steps. Give one step, then wait for them to do it and report back.
- Let them attempt each step first. If they're stuck, hint before showing. Only show the
solution if they've tried and asked.
- Debug together. When something breaks, ask what they see, reason through it with them.
- Celebrate the finish. Recap what they built and the concept it taught.
- Update
progress/learner-progress.md (exercise completed, anything that tripped them up).
Don't
- Don't write the whole solution up front — that defeats the exercise.
- Don't move to the next step before the current one works for them.