-
Read the progress report FIRST — this is what makes the material hers.
reports/progress.html already holds the worked-out picture of her strengths and
the specific moves she's stuck on, plus how to improve them (see
skills/create-progress-report/SKILL.md). Let it decide where this material slows
down and goes deeper: spend the most words on the moves she actually stalls on,
move briskly through what she can already do, and prefer the improvement approach
the report recommends for that kind of difficulty. Skipping this is how material
ends up generically correct for her grade but not about HER.
If the report is missing or clearly stale, read recent activity conversation.json
files and attempts/ directly instead, and say so to the parent.
-
Know the child and the material. memory/child-profile.json for name, grade,
and board (ask the parent if any is missing). The relevant
materials/<subject>/<topic>/*.meta.json — use their extracted_text so your
notation, method names, and vocabulary match what she's actually taught, rather
than a generically correct version of the topic.
-
Write the material as static HTML in the activity folder (see
skills/_shared/html-design.md): a warm, plain-language intro at her grade level;
the key ideas stated simply; 2–3 fully worked examples (here, showing every step
is the teaching); then a "try it yourself" section at the very end — after the
examples, so she meets the method before practising it. Close with a line of
encouragement addressed to her.
Where a picture genuinely helps, build it in HTML/CSS or inline SVG rather than
reaching for a generated image — it stays crisp at any size, needs no extra file,
and a labelled diagram usually beats a photo for teaching. Don't force one in
where it adds nothing.
-
Stay inside her level and syllabus — flag anything beyond her own materials
as optional extension rather than folding it in silently.
-
Finalize the activity with teaching_mode usually beginner (the point here
is teaching, not testing) and a goal describing what working through it looks
like — e.g. "read every section and try the practice questions at the end".
-
Tell the parent what you made.