← All topics (review home)

Skill: write-like-james @ b0fa825 · the build: write-lesson, write-mcqs, write-video-script, review-lesson (two blind reads and a re-read), review-figures, review-accuracy @ b0fa825

Topic 17 "What a rock is made of" — your read (2 October 2026)

Skim first

The lessons in teaching order, each with its one rule sentence; then the intro script; then the question types. The review page follows.

The lessons and their rules

LessonAtomRule sentence
L01 Describe a rock by its grains and its shineEAR4-001The small pieces you can see are grains. Say its colors and whether you can see its grains. Say how it feels, and shiny or dull.
L02 Rocks are made of mineralsEAR4-002A rock is made of grains of minerals. A mineral is one kind of stuff. The same all the way through.
L03 Test a mineral to tell it apartEAR4-003Test its color and its luster. Test its hardness and its streak. Write each result in a table.

The intro script (114 words, about 57 s)

Here's Gloria at Enchanted Rock in Texas, a huge pink dome of rock. She picks up a loose chunk. Up close, it has white bits, glassy gray bits, and black bits that glitter in the sun. Her dad says it is one rock. But it looks like lots of little pieces stuck together. So is a rock one thing, or many? And if it is many things, Gloria would need a way to tell them apart. To find out, we will look at how to describe a rock, what rocks are made of, and how to test the pieces inside. Okay, so are you ready to find out what a rock is made of?

The question types (from TYPES_G4T17.md)

  1. Type 1 (easy, medium · MCQ · EAR4-001): which describing question a word answers; which four things a geologist says; why 'hard' alone is not a description — the four describing questions (ASK4), or four statements
  2. Type 2 (easy · MCQ, drawn · EAR4-001): what a geologist writes about the grains of a drawn close-up (the box drawn at the teaching figure's scale, in the stone's own colors) — big enough to see / you can just see them / too small to see / glittery
  3. Type 3 (easy, medium · MCQ; one drawn · EAR4-001): which describing question is still unanswered (a card with an empty row; three facts given); which question could still tell two alike rocks apart — the four describing questions (ASK4)
  4. Type 4 (medium · MCQ, drawn · EAR4-001): which rock matches a filled card — four rock descriptions in words
  5. Type 5 (easy, medium · MCQ · EAR4-002): what a rock is made of; what a mineral is; which sentence is true of every rock; which of four things is a mineral; the cereal-box meaning — four things or four statements
  6. Type 6 (easy, medium · MCQ · EAR4-002): rock, mineral, soil or a grain of sand from a description; which sentence is true of a described rock — a rock / a mineral / soil / a grain of sand (WHAT4), or four statements
  7. Type 7 (medium · MCQ · EAR4-002): the made-of analogy carried to a new made thing, not a food — four parts of the scene
  8. Type 8 (medium, hard · MCQ · EAR4-002): which sentence is true when a size, inside or 'just sand' claim is made (the claim in the stem, four single statements as options) — four single statements
  9. Type 9 (easy · MCQ · EAR4-003): which test a described action is — color / luster / hardness / streak (TEST4)
  10. Type 10 (easy, medium · MCQ · EAR4-003): the hardness result from a scratch story; which thing to try first; which luster word fits — a fingernail / a penny / a steel nail / nothing (SCRATCH4), or the luster words
  11. Type 11 (medium, hard · MCQ, drawn; one multi-select · EAR4-003): which test (or which two tests) tells two lettered minerals apart, read from a drawn test table — color / luster / hardness / streak (TEST4)
  12. Type 12 (medium, hard · MCQ; one drawn · EAR4-003): reasoning about results: what to say when all four match; which result shows a second mineral is different (read against a drawn one-row table, mineral W); a color-only claim; a streak that differs from the color — four statements or four results
  13. Type 13 (hard · typed · all three): the coined term recalled from its meaning on a fresh case — accept lists: grain · mineral · luster · hardness · streak, with article, plural and child spellings; lustre accepted

Three lessons: a geologist describes a rock by its colors, whether you can see its grains, how it feels, and whether it is shiny or dull, and the small pieces you can see are called grains; a rock is made of grains of minerals, and a mineral is one kind of stuff, the same all the way through; two minerals that look alike are told apart by four tests (color, luster, hardness and streak), each result written in a table. This topic opens Earth and Space, so it also carries a 90-word opening video that teaches nothing. Two cold readers failed one key (fixed, below), a third reader agreed every key on the rebuilt bundle, and the figure review and the guidance-and-accuracy review are applied. Pictures are placeholders until you answer.

1. Does "how it breaks" (cleavage) stay out of L03?

Florida's standard lists cleavage among a mineral's properties. L03 already carries four tests in a 147-word video and a five-column table, and no released Grade 5 item asks about cleavage. Mica's "black flaky" sheets in L02 carry the idea as a describing word.

Built: left out.

Recommendation: leave it out. If you want the Florida word honoured, one caption on the three-minerals picture does it and nothing else changes: "Mica breaks into thin flat sheets. How a mineral breaks is another clue geologists use."

Leave out / add the caption

2. Should Topic 17 say once that glassy obsidian is the one rock with no grains you can see?

Topic 17 teaches that a rock is made of grains of minerals. Topic 18 meets obsidian, a black rock that is smooth like glass, and its review softened that lesson's line to "no grains you can see, even up close", so the two topics no longer contradict each other. Topic 18's reviewer asked whether Topic 17 should carry a scope line too.

Built: no line in Topic 17.

Recommendation: no line. A child meets obsidian in Topic 18, where the softened line sits, and naming an exception before the fact is learned blurs the fact.

No line / add one line

3. Should the register's mineral definition carry "natural / not from a living thing" as a scope line only?

The register's atom says minerals are "natural, non-living material". The lesson says "one kind of stuff a rock is made of, the same all the way through", and the accuracy reviewer confirmed that as right for the grade. Grades 3-5 never say "non-living", so the words would sit on the register, not on a page.

Built: no student line; the definition stands as written.

Recommendation: yes, a scope line on the register only (an atom edit in the knowledge-graph repo; no student text changes).

Scope line / leave the register

The lessons

4. L01 Describe a rock by its grains and its shine — Hadley and Heidi each write "gray and hard" for their rock, and nobody can tell which rock is whose; a geologist asks four questions instead, worked on a chunk of granite from Enchanted Rock, then sandstone and limestone; the small pieces you can see are called grains. page

5. L02 Rocks are made of minerals — Gloria's granite under a magnifying glass is three kinds of grain, each one kind of stuff the same all the way through: feldspar, quartz and mica; a cookie is made of flour, sugar and chocolate chips the same way; a pebble off a boulder is the same rock. page

6. L03 Test a mineral to tell it apart — Hadley's two white minerals look alike; color, luster, hardness and streak go in a table, and the one test with two different results (a penny scratches calcite) tells them apart; pyrite's greenish black streak shows why color alone is not enough. page

Applied without asking

Two cold readers failed one key: the drawn "you can just see them" box showed its speckles at five times the teaching figure's size, so both answered "no" to "Can you see the grains?" where the key said "yes"; the three grain items now ask which of the three taught labels goes in the GRAINS row, every item box draws at the teaching figure's size, and the re-read agreed all three. Also applied: L03 says on the page how Hadley knows the scratched mineral is calcite (Miss Burke's mineral chart) and states the deciding rule in the body; the quartz and calcite streaks are tested too; the streak card's mark is greenish black, not olive; the hardness card has one arrow style and shows "nothing" as a result, not a thing to scratch with; "shine" and "lustre" are accepted on every typed luster item and "hard" on the hardness ones; the worked quartz-and-calcite case left the bank (a pink glassy mineral on its own table replaces it); five re-skinned items got fresh scenes; a "why not" stem became a positive one; one article line joins "a sand grain is a bit of rock" to "a grain of a mineral"; and the re-read's five soft notes are in (a "polished" face, the cookie analogy as a fruitcake, a granite-looking driveway stone, a rock of one mineral, the hardness stem).

Also on the site

Topic intro and poll · summary and three questions · mixed practice · the PP100 bank · the type sheet

After you answer

Nothing on the page changes if you keep all three. The caption is one line in L02; a Topic 17 scope line is one article line; the register line is an atom edit in the knowledge-graph repo. Either way the picture pass starts, and the five-video batch is built and checked, ready to send once you have read the scripts.

The build record (v1, v2 and the v3 polish)

Skill: course-build → write-lesson (L01 a describing routine with rock words, coins "grain"; L02 a fact true of every rock in the fact form, coins "mineral", the cookie analogy once; L03 a four-test routine worked on quartz and calcite then pyrite, recorded in a table, coins luster, hardness and streak) → write-example-sequence, design-check-sequence, sentence-atomise, write-explanation, write-mcqs; write-video-script (the Earth and Space opening video, the intro, three lesson scripts, the summary; the elementary micro-lesson anatomy); review-figures (author self-check on fourteen renders; a non-author pass is owed) @ b0fa825

Grade 4 Topic 17 — What a rock is made of — build record (v1, 2 October 2026)

What this is, in plain words

Three short lessons, one per atom, in one classroom: Miss Burke's, with Gloria, Hadley and Heidi. First the child learns that "gray and hard" describes almost every rock and so describes none — a geologist asks four questions instead (its colors; can you see its grains; how it feels; shiny or dull), and the small pieces you can see get their name, grains. Then the child looks at granite through a magnifying glass and finds it is not one thing: it is grains of three kinds, each one kind of stuff the same all the way through, and that kind of stuff is a mineral — granite is made of feldspar, quartz and mica the way a cookie is made of flour, sugar and chocolate chips. Last, the capstone: two white minerals that look alike are told apart by testing — color, luster (how shiny it looks), hardness (what can scratch it: a fingernail, a penny, a steel nail) and streak (the color of the mark on a white tile) — with each result written in a table. It is also the first topic of Grade 4 Earth and Space, so it carries the opening video "Before we start: Earth and space" (90 words, one scene, teaches nothing). Built with no blueprint, under the Grade 4 standing brief; the structural decisions are below.

Structural decisions (in place of a blueprint)

LessonTitle (the skill in student terms)Headache sceneExample sequence / worked casesCheck typeVideo?
L01 EAR4-001Describe a rock by its grains and its shineHadley and Heidi each have a gray rock and both write "gray and hard"; Miss Burke holds up the two rocks and asks which is whose; nobody can tella ROUTINE, so no example sequence: four describing questions worked on granite (the card fills row by row; the coin "grain" arrives in the GRAINS row), then the same four on sandstone (Arizona) and limestone (Florida), so three cards carry three rocks; the grain_sizes figure shows the three grain answers side by side(a) fluency: one Grade 3 recall (property) → three "which question does this word answer?" on the fixed set → three drawn "Can you see its grains?" (y y n) → one apply → the "all rocks are gray and hard" claim → term recognition → term typed lastvideo and article (the video drops limestone for the word budget; the article keeps it)
L02 EAR4-002Rocks are made of mineralsGloria's dad said her granite chunk is one rock, but through the magnifying glass it looks like lots of little pieces stuck together; "Is a rock one thing, or lots of things stuck together?"the FACT form (write-example-sequence's test: no non-example differs from "a rock" by one feature only — a single mineral chunk is the sibling class, not a near miss — so examples only, rule last): granite's three grains → each one kind of stuff, the same all the way through → the coin "mineral" → the three named → the cookie table once → sandstone (mostly quartz) and limestone (calcite, too small to see) carry the fact → the two things the word does not mean (cereal-box minerals; a pebble is the same rock as its boulder) → rule(a) fluency with the claims: one Grade 3 recall (soil's bits of rock) → a four-item rock / mineral run (r m m r) → one analogy transfer → three bare claims (n n y; the TRUE one is the pebble) → term recognition → term typed lastvideo and article (the video drops sandstone / limestone and the pebble paragraph; the quiz and practice carry the pebble)
L03 EAR4-003Test a mineral to tell it apartHadley has two white minerals, quartz and calcite, that look alike; Miss Burke asks "Which is which?"; looking is not enougha ROUTINE worked on the page, one test per subtitle: color (same) → luster (same; the coin after "how shiny it looks"; the three luster words on a card) → hardness (different: a penny scratches calcite, nothing scratches quartz; the coin after the scratch test) → streak on pyrite (greenish black; gold's is yellow; the coin after the mark) → the finished three-mineral table → rule; Grade 3's table rule is recalled by one item(b) scaffolded → bare: one SR3 recall (a heading on every column) → three scaffolded items on a SECOND case (a purple mineral) → two drawn "which test tells them apart?" tables (J / K streak; L / M hardness) → one bare "what next" → two claims (color-only gold, No; same color different minerals, Yes) → two recognition items → "streak" typed lastvideo and article

Why these calls: the atom titles give the order and the capstone. L01 is a routine (describe), so it has worked cases rather than an example sequence; the headache is the real one children produce — "gray and hard" (Ford 2005) — and the card is the thing that shows why four questions beat two words. L02 took the fact form after the write-example-sequence test: the only candidate non-example is a chunk of a single mineral, which is the sibling class and would need the full mineral definition grades 6-8 own; so the lesson shows the fact on three rocks and gives the rock | mineral table as its sorting figure. The cookie analogy is used once, in the article and the video, with its table (the coordinator's standing analogy). L03 is one routine with four tests inside it (Florida 4.E.6.2's menu); "cleavage" is not named (below). The minerals were chosen so that every hardness claim is honest on a classroom kit: calcite (a penny scratches it; a fingernail does not), quartz and pyrite (nothing in the kit scratches them). Hematite was NOT used because kit hematite sits on the steel-nail line (hardness 5–6.5 against the nail's 5.5), so pyrite carries the streak surprise (brassy yellow, greenish black streak, against gold's yellow) — the type sheet bars hematite and galena from hardness items for the same reason.

Questions for James

Counts

3 lessons · scripts 149 / 149 / 147 spoken words (cap 150) · intro 114 words, 2 question marks · summary 139 words (cap 175) · Earth and Space opening video 90 words (target ≤ 90) · article student text (idea + rule + subtitle lines) 281 / 280 / 296 words (Grade 3 median 308; brief's ceiling 300) · idea lines 17 / 17 / 17 (longest 20 / 18 / 17 words) · subtitles 3 / 4 / 5, figures 10 / 8 / 10 per article (never more than 8 idea lines without one) · quizzes 11 / 11 / 12 items · attached questions 3 + 3 (summary), key string in video order B A C C B B (B 3 of 6) · practice 13 (10 MCQ, 2 typed, 1 written; 3 Grade 3 retrievals) · PP100 bank 53 items: 47 four-option MCQs, 5 typed, 1 multi-select; EAR4-001 17 (11 easy, 5 medium, 1 hard) · EAR4-002 16 (6 / 7 / 3) · EAR4-003 20 (5 / 8 / 7); keys on the four-option MCQs A 9 · B 12 · C 13 · D 13 · figures 46 (29 SVG, 13 photo_ph, 4 cartoon_ph).

The per-lesson table

LessonCoinsLexicon sentences (word for word in the rule step and the script)Recall item (Grade 3)Misconception itemsTerm items
L01grain"The small pieces you can see in a rock are called grains." / "To describe a rock, say its colors, whether you can see its grains, how it feels, and whether it is shiny or dull."q1: which is a property (MAT3-001, Topic 16 L03)q9 every rock is gray and hard (Ford 2005; Happs 1982) — Noq10 recognition (crumbs / grains / chips), q11 typed
L02mineral"A rock is made of grains of minerals." / "A mineral is one kind of stuff a rock is made of, the same all the way through."q1: where the bits of rock in soil came from (Topic 26 L02)q7 one solid thing with nothing inside (Happs 1982) — No; q8 a mineral is a kind of vitamin (Happs 1982) — No; q9 a pebble off a boulder is made of the same minerals (Happs 1982; Kusnick 2002) — Yesq10 recognition (grain / mineral / layer), q11 typed
L03luster, hardness, streak"How shiny a mineral looks is called its luster." / "What can scratch a mineral tells you its hardness." / "The color of the mark a mineral leaves on a white tile is called its streak." / "To tell a mineral apart, test it: its color, its luster, its hardness and its streak, and write each result in a table."q1: a heading on every column (SR3; Topic 22 L04)q8 yellow so it must be gold (Ford 2005: color as the sole identifier) — No; q9 two minerals can share a color — Yesq10 luster, q11 streak (recognition among the four test words), q12 "streak" typed; hardness and luster recognition + typed in PR-10, PR-12, PR-13

design-check-sequence records

`

Skill: design-check-sequence @ b0fa825

Part: L01 (one part)

Type: (a) — the student sorts a describing word to its question, or reads a close-up for its grains: one step, one of four labels.

Plan: 11 items; 1 recall (3 options) → 3 fixed-set MCQs (ASK4) → 3 drawn yes / no (q_grains_big, q_grains_small, q_grains_none; key string y y n) → 1 apply (3 options) → 1 claim yes / no → 1 recognition (3 options) → 1 typed. Stems ≤ 20 words.

Belongs in practice/test instead: card-matching (PP type 4); two-rock comparisons with three facts (PP type 3 medium).

Part: L02 (one part)

Type: (a) with the three claim items — the student places a description in rock / mineral (one step) and judges three documented beliefs.

Plan: 11 items; 1 recall → 4 two-option sort (r m m r) → 1 analogy transfer (3 options) → 3 claims yes / no (n n y) → 1 recognition → 1 typed.

Belongs in practice/test instead: rock / mineral / soil / sand four-way sorts; "which sentence is true" claim forms (PP types 6, 8).

Part: L03 (one part)

Type: (b) — four tests in order, each with a right answer; the student can be right on luster and wrong on hardness.

Plan: 12 items; 1 recall → 3 scaffolded on a SECOND case (the purple mineral: which test is the tile; which thing to try next; which column 'shiny like glass' goes in) → 2 drawn bare reads on a THIRD and FOURTH case (tables J / K, L / M) → 1 bare "what next" → 2 claims → 2 recognition → 1 typed. The worked case (quartz / calcite / pyrite) appears in no item. [v2 correction: this claim was false — PP-51 was the quartz / calcite case with the names removed; it is now mineral W, pink and glassy, on its own drawn table, and L03 has three recognition items (luster, hardness, streak).]

Belongs in practice/test instead: the multi-select on a table (PP-51); results-reasoning items (PP type 12).

`

The key strings

The example sequences, written out

The rules applied

Rule (vault note / brief)Where it bites here
"grain" = the small pieces you can see in a rock, never "crystal" (the brief)the coin line in L01's GRAINS row; "crystal" appears nowhere (grep 0)
The mineral definition rides inside EAR4-002 in Grade 3's style; the full condition test is grades 6-8 (cross note)"A mineral is one kind of stuff a rock is made of, the same all the way through." — the lexicon sentence, L02's rule and every term item; no "natural", "solid", "crystal structure"
Grades 3-5 say "not alive", never "non-living" (2 Oct)the register's "non-living" is not carried into any student line; the definition does without it
"stuff" beside "material"; the cookie analogy once with its figure (the brief)"one kind of stuff"; the made_of_table figure in L02's article and video, nowhere else (the muffin and fruitcake items are transfers, not re-teaching)
US spelling luster / color / gray (S14 0); "luster" explained as "how shiny it looks" before the wordL03: "Hadley turns each mineral in the light, and both look shiny like glass." then "How shiny a mineral looks is called its luster."
A headache scene could really happen; the question from a person who would ask ittwo children writing "gray and hard"; a dad who says "one rock"; a teacher asking "which is which?"
The headache figure is the teaching figure with the answer's layer offdesc_card_headache is the granite card with its right column blank and the question above; test_table_headache is the test table with blank cells
A verdict mark names its questionthe hardness card ("What scratches it?"), the streak card ("What color is the mark?"), the luster card ("How shiny does it look?"), the grain figure ("Can you see the grains?")
Code draws what must be exact; David's pack renders what must look real (2 Oct)29 SVG cards and tables; every real rock, mineral, penny, nail, tile and cookie is a photo_ph; the four classroom scenes are cartoon_ph; IMAGE_BRIEFS for all 17
An item figure's blind text is DATA, never the verdict (the coordinator, 2 Oct)every grain box lists its fill and speckle count and size; every item table lists each cell; the one card item lists its four cells; grep of the bundle's [Drawing: lines for "tells them apart / the answer / differ / verdict / you can see the grains / is a rock / is a mineral" → 0
Every sentence has a subject and a verb (S38 0)"Both minerals are white, and both look shiny like glass." (was "Both are white."); no colon fragment
Connectives carry cause; the positive word; compound names whole"so" / "because" / "But" through every article; "stays smooth", "nothing scratches"; "magnifying glass", "steel nail", "white tile"
Lesson text states the fact, never the topic that taught it"A property is something you can say about an object…", "One column for each thing you record, a heading on every column." as facts in fb / why; no "in Grade 3"
Recognition before recall; every coined term has both (S33 / S34 0)grain: L01 q10 → q11; mineral: L02 q10 → q11; luster / streak: L03 q10 / q11 → q12 (streak), PR-10 → PR-12 (luster) and PR-13 (hardness); bank typed items PP-43, 44, 48, 49, 50
A typed answer only where the question is closed; every correct answer accepted (S30 0 / 0)ten typed items, every key a coined term; accept lists carry article, plural and child spellings; "lustre" via TOPIC["synonyms"]
A stem never names its own answer (S13 0)L03 q3 rewritten from "a steel nail scratches it → what is the result" to "which thing should she try next"
A quiz stem never names the lesson's own scene object (S10 0)"A stone is made of grains…" (was "a chunk"); no quiz item names a notebook, a magnifying glass, a desk, quartz, calcite or granite
Hard means more of the skill; a three-sentence stem is hard (S23 0)every hard item carries a "hard because"; two multi-sentence easy / medium stems were shortened
A test item is a fresh instance; freshness judged on the scene, re-performed (the brief)the noun grep below; five shared nouns found on the first pass (gold, purple, dark gray, garden soil, pebble / boulder in the bank) were re-scened: tables R / S recoloured green, T / V silver-gray; a chip off a stepping stone; a blue mineral; Gloria's red minerals
One atom per bank item; coverage even; difficulty rises with atom order (S11, S31 clean)17 / 16 / 20; EAR4-001 one hard (the typed term), EAR4-003 seven hard
A claim-maker once per topic in the bank; names from the topic's row onlyHeidi (PP-33), Hadley (PP-46), Gloria (PP-52); the names run below
The intro coins nothing, ≤ 120 words, ≤ 3 question marks, ends on a ready line and a poll (S15 / S20 / S21)114 words, 2 question marks; "To find out, we will look at how to describe a rock, what rocks are made of, and how to test the pieces inside."
The opening video ≤ 90 words, one scene, teaches nothing, names the year's subjects, "strand" never said (S37 0)90 words; one hill at sunset; the map line names rocks forming, land wearing away and layers telling time, the ground shaking, water going round, weather and climate, energy, the Sun's path, the stars and the Moon
A summary opens "Here's everything we found out about…", recaps rules not examples, ≤ 175 words, three attached questions139 words; every lexicon sentence spoken word for word (S15 no miss)
Every lesson video opens on its scene and people; "Okay, now your turn."; the rule spoken naturally"Here's Hadley and Heidi in Miss Burke's class…"; L01 "So, to describe a rock…", L02 "So, a rock is made of…", L03 "So, to tell a mineral apart…"
Closing bullets a few words each; summary bullets ≤ 4 (R79)check_brief.py: L01–L03 and the summary clean; the intro's "no closing bullets" hit is the standing accepted one (an intro has no rule slide)
Grade-level words questioned (S36)26 words, each answered below

Misconception rows (the catalogue is silent on rocks; the literature named)

BeliefSourceWhere the lesson confronts itItems
All rocks are gray and hardFord 2005 (third graders' rock descriptions); Happs 1982 (LISP, rocks and minerals)L01's headache ("gray and hard" fits both) and the three cards (pink, red-brown, pale cream)L01 q9 (No); PP-16 "which sentence is true of every rock" (gray as a distractor); PP-26 why "hard" is not a description
A rock is one solid thing with nothing inside itHapps 1982L02's headache and its answer: "No, a rock is not one thing"L02 q7 (No); PP-12, PP-16 (distractor); PP-31 (broken in half); PP-45 (no grains show)
Minerals are vitamins / foodHapps 1982 (children link "mineral" to food and health)L02 "Two things the word does not mean": the cereal box vs. scienceL02 q8 (No); PP-17; distractors in PP-13, PP-27, PP-33, PP-34
A pebble is a different kind of thing from a boulder (size is a kind)Happs 1982; Kusnick 2002L02: "a pebble broken off a granite boulder is made of the same minerals… size is not a kind of rock"L02 q9 (Yes, the true form); PR-6 (No); PP-31; PP-46
Color alone tells a mineral; a yellow shiny mineral is goldFord 2005L03's pyrite paragraph: "the greenish black streak shows this is pyrite, not gold"L03 q8 (No), q9 (Yes); PP-52; PP-53 (streak differs from color)

Checker: 0 FAIL, 26 WARN (python3 build_tools_check_topic.py grade4/topic17_build/content/G4T17.py)

All 26 WARNs are S36 (grade-level words). Answered one by one:

WordCountAnswer
granite, quartz, calcite, pyrite, feldspar, mica24, 16, 13, 13, 5, 5kept — the topic's named rocks and minerals; each is introduced with its look before its name; every one is a word the standards and the released items use
geologist15kept — defined in L01 ("A geologist is a scientist who studies rocks."); the atom title's word
gritty20kept — the feel word for sandstone and sand; Grade 3 Topic 26 taught "gritty" for sandy soil
chunk17kept — an everyday word for a broken-off piece; "piece" is used beside it
boulder15kept — the misconception's own word (pebble / boulder), needed to confront it
speckle, glassy, glittery, glitter, sparkly, flecks, flaky9, 8, 6, 5, 5, 4, 3kept — the describing words the lesson teaches children to use; each is shown on a photo or card before it is asked
greenish, brassy6, 2kept — pyrite's honest colors; "brassy yellow" is the standard description
vitamin, vitamins5, 1kept — the misconception's own word
muffin4kept — one quiz transfer item; a US child knows it
dome2kept — Enchanted Rock is a dome; said with "as big as a hill" removed for words, "a huge pink dome of rock" is pictured on the photo
climate1kept — the opening video must name "weather and climate" (the brief); Topic 27 teaches it
scientist1kept — Grade 3 vocabulary
bumpy1kept — Rock L's feel word; everyday

Names run (python3 build_tools_names.py Burke Gloria Hadley Heidi → exit 0, all four free)

Miss Burke; Gloria, Hadley, Heidi — the Topic 17 row of grade4/NAMES_POOL.md. No other name appears in a student string.

Bank freshness (re-performed; the scene-noun grep)

Scene nouns of every lesson, quiz, attached and summary item: granite, Enchanted Rock, Texas, sandstone, Arizona, limestone, Florida, cookie, chocolate chips, feldspar, quartz, mica, calcite, pyrite, gold, notebook, magnifying glass, pebble / boulder, muffin / blueberries, the purple mineral, the gray rocks, dark green, the smooth brown stone, garden soil, the yellow shiny mineral. Grep of the bank and the practice set: granite 0 · Enchanted 0 · Texas 0 · sandstone 0 · Arizona 0 · limestone 0 · Florida 0 · cookie 0 · chocolate 0 · feldspar 0 · quartz 0 · mica 0 · calcite 0 · pyrite 0 · gold 0 · notebook 0 · magnifying 0 · muffin 0 · blueberr 0 · purple 0 · "gray rock" 0 · "dark gray" 0 · "dark green" 0 · "smooth brown" 0 · "garden soil" 0 · "yellow mineral" 0. Pebble / boulder: the bank keeps "a pile of mixed pebbles" (an option, not the misconception scene) and "gray pebbles" on Rock L's card; the two size-claim items were re-scened (a chip off a stepping stone; a big park rock); PR-6 keeps the taught scene as the practice claim, by design (practice may recall; the bank must not). Bank scenes: a driveway in Ohio, a Lake Michigan beach, a Colorado riverbed, a Georgia garden, a Utah desert, a kitchen countertop, a garden stepping stone, a fruitcake, minerals N / P, R / S, T / V, a spoon's shine, red, blue and green minerals.

Blind bundle

grade4/topic17_build/blind/2026-10-02/BLIND_BUNDLE_G4T17.md (94 MCQ, 10 typed, 1 written, 1 multi; keys sequestered). Every [Drawing: …] line is data (fill, speckle count and size; every table cell; every card cell); grep for "tells them apart", "the answer", "differ", "verdict", "you can see the grains", "is a rock", "is a mineral" → 0.

Sentence-atomise self-check (one row per lesson; every paragraph read; S1 / S38 clean)

LessonIdeas countedFixes applied
L0117 idea lines, one idea each; longest 20 words"Back at the table, Hadley writes…" (24 words) → "Hadley writes…" (19); the four questions each get their own line with the answer in the next clause
L0217 idea lines; longest 18 wordsthree lines cut for the 300-word ceiling (the grain colors moved to the caption; "Think of a cookie" into the caption; the "every rock" restatement dropped because the rule says it); "that is exactly right" → "she is right"
L0317 idea lines; longest 17 wordsthe two color lines merged ("Both minerals are white, so color does not tell them apart."); the two hardness-result lines merged; the luster words moved to the card's caption; "Both are white." → "Both minerals are white" in the script
Scriptsevery beat one or two sentences (S8 0)three-sentence beats split in all three scripts (L01 10 beats, L02 8, L03 10) at no word cost
fb / why≤ 30 / ≤ 60 words (S5 0); one causal link per <br> lineclaim items' two fb differ (confirming fact / correction)

Figures (46; author's review-figures self-check on fourteen renders, a non-author's pass owed)

Rendered with headless Chrome at 1000 px and opened: desc_card_granite, desc_cards_three, desc_card_headache, pp_card_m, grain_sizes, q_grains_small, test_table_three, test_table_headache, q_table_jk, hardness_card, streak_card, luster_card, made_of_table, rock_vs_mineral. Every cell's text sits inside its column (the table drawer asserts tw(v) < cw − 8); the speckle guard places 15 / 90 non-overlapping speckles per box from one seed; the headache card and table carry their question and blank cells; no item figure carries a chip, a tick or a verdict. Two item cards drawn but unused (Rock J, Rock K) were removed. Photo and cartoon placeholders render as the pale box with grey text; IMAGE_BRIEFS carry the 17 picture briefs (David's pack, after James's sign-off on the question above).

Judgement calls, recorded

  1. Pyrite, not hematite, carries the streak test. Hematite is the textbook streak mineral, but a kit hematite's hardness sits on the steel-nail line, and the table prints a hardness cell for every mineral. Pyrite's results are honest on any kit (nothing in the kit scratches it; greenish black streak). Hematite appears nowhere; the type sheet bars it from hardness items.
  2. The hardness result is "the first thing that scratched it" (a fingernail / a penny / a steel nail / nothing), not a number. Mohs numbers are grades 6-8; the four-word result is what a Grade 4 table can hold and what the released items ask.
  3. "Cleavage" is not named. Question for James above.
  4. The L02 fact form. A single-mineral chunk was rejected as a non-example (sibling class); the rock | mineral table does the sorting instead.
  5. The opening video is exactly 90 words after three trims; the warm rock underfoot went. Eight subjects are named in one map sentence (the brief's list), the longest beat in the topic (50 words) — the generator should read it at speech pace; check_brief.py passes it.
  6. The intro's second question became a statement ("Gloria would need a way to tell them apart") to sit at two question marks instead of three.
  7. L03's article is 296 words, the longest in the topic, because its rule step carries four lexicon sentences (three coins and the routine). Subtitles sit every 2–4 idea lines, so no stretch runs long.
  8. The quiz claim items are bare yes / no; the bank's are "which sentence is true" with the claim in the stem, so no option bundles a verdict with its reason (the bank needs four options).
  9. Written to /tmp only. The brief scopes writes to grade4/topic17_build/; the page was built to /tmp/g4t17_test.html (with the opening-video card added by content/add_strand_intro.py), the batch to handoff/G4T17/videos/ (the tool's own output path; NOT sent), the bundle to grade4/topic17_build/blind/2026-10-02/.

Owed

v2 — reviews applied (2 October 2026)

Skill: course-build → write-lesson (the article lines) → write-video-script (the L03 chart beat) → write-mcqs (every item change) → write-explanation (the fb / why lines) → sentence-atomise (every new sentence) @ b0fa825

In plain words. Three review records went through the topic in order of authority — the blind read (one key did not survive), the guidance / questions / accuracy review, and the figure review — and every Essential and Worth-fixing row is now in the files. The failed key is fixed at its root: the three drawn grain items no longer ask yes / no about a drawing that sits on the boundary; they ask which of the three taught labels goes in the GRAINS row, and the drawing renders at the teaching figure's size, so the right answer is the level the picture plainly shows. L03 now says on the page how Hadley knows the scratched mineral is calcite (Miss Burke's mineral chart) and states the deciding rule in the body. Nothing was cut from the bank, so no renumbering; every count the brief asks for still holds. Commit nothing was the instruction; nothing is committed.

Finding → change

RecordFindingChange
BlindL01-06 key failed: both readers said "no" on the 90-speckle boxL01 q5–q7 are three-label items ("What would you write in the GRAINS row of its card?", options GRAINS3 = big enough to see / you can just see them / too small to see; keys 0 1 2), with fb for every option; _grain_item passes disp=320, so a 120-wide box renders at 240 px (2×, the grain_sizes scale) and a 1.6 px speckle stays a 3 px dot. Opened at page width: q_grains_big shows separate pea-sized speckles — plainly big enough to see; q_grains_small a fine texture of tiny dots — plainly you can just see them; q_grains_none one even cream fill — plainly too small to see
BlindPP-06 two defensible at three levels; PP-06 / 07 / 09 are lesson scenes renamedPP-06 is pinned by L01's three-label run at the same scale; PP-06 and PP-07 re-scened as a gray driveway stone (light gray fill; white, dark gray and black speckles) and a smooth mid-gray pebble (fill #a3a7aa), new seeds, stems name the stone and the pebble; PP-09 re-scened as a dark green gritty rock whose grains you can just see (the reviewer's wording)
Blindhardness has no definition item in L03L03 q11 added: "What do we call what can scratch a mineral?" (TEST4, key C); streak recognition and the typed streak item move to q12 / q13
Blind + Review"shine" refused on typed luster; "lustre" everywhere; "hard" on PR-13LUSTER_ACCEPT += shine, shiny, shininess, the shine, its shine, how shiny it is; HARDNESS_ACCEPT += hard, how hard it is; PR-12 and PP-47 ask for "the geologist's word" and their why opens "'Shine' is the everyday word. The geologist's word is luster."
Blind"geologist" in eight bank items, no lesson itemkept: L01's article names it ("A geologist is a scientist who studies rocks.") and L01's script speaks it ("like a geologist does") — the lesson line the ruling asks for already stands in both alternatives; no stem cut
Blind + ReviewPP-26 "why not" stem; "hard" does describe the rock"A boy writes 'hard' as the only word for a rock. Which sentence is true about the word 'hard'?" — key "'Hard' fits almost every rock."; the why ends "does not tell this rock from other rocks"
BlindPR-04 vs PP-33 read as a contradictionL02 article: "Sandstone is made of minerals too: its tiny grains of sand are mostly quartz." then "So a grain of sand is a tiny bit of rock, and it is also a grain of a mineral."
Blind + ReviewPP-51 long stem; the worked case with the names removed (the reviewer's "PP-52")PP-51 is a drawn item on the one-row table pp_table_w (mineral W: pink, shiny like glass, a penny, white); "A second pink, glassy mineral gets one different result. Which result shows it is a different mineral?" — key "A fingernail scratches it." (C)
Blindquiz term order (grains, streak, luster used before their recognition items)no change: the lessons coin each term before the quiz; the guidance review confirms
Review (Essential)L03: how does Hadley know the scratched one is calcite; the deciding rule not in the bodyArticle, after the scratch result: "The test that gives two different results tells the minerals apart." / "Miss Burke's mineral chart says a penny scratches calcite, and not even a steel nail scratches quartz." / "So the scratched one is calcite, and the other one is quartz." Script beat 6: "Miss Burke's chart says a penny scratches calcite, so that one is calcite, and the other is quartz." (the screen shows the chart as a two-row card). The reviewer's "nothing in the kit" became "not even a steel nail" — "kit" was never introduced and S36 flagged it
Reviewquartz / calcite streaks untested in the articleTest 4: "Hadley rubs the quartz and the calcite on the tile too." / "Both leave a white mark, so streak does not tell those two apart." (two lines: S1 caps an idea line at 22 words)
ReviewL03 q3 offers "nothing" as a thing to tryoptions a fingernail / a penny / a steel nail, key C; the fourth fb cut
ReviewPP-5 "speckled" also answers the grains question"A rock is described as 'black and white'."
ReviewPP-9, PP-12, PP-20, PP-49 (the reviewer's number; PP-48 in the bundle), Summary Q1 re-skinnedPP-9 dark green gritty rock; PP-12 "A rock's card reads 'gray, smooth, dull', and its GRAINS row is still empty. What is the rock made of?"; PP-20 "In a geologist's table, one column holds the color of the mark each mineral left on a white tile. Which test is this column?"; PP-48 "Nothing scratches an orange mineral, not even a steel nail." (the reviewer wrote green; PR-7 is already Gloria's green mineral and hardness, so green would re-skin the practice item); Summary Q1 "A rock has a polished cut face. The face is black and shiny, and its grains are too small to see." → key "How does it feel?"
ReviewL02 attached: both fb identicalthe no-fb is now "Each pink grain and each black grain is one kind of stuff, the same all the way through. So each grain is a mineral."
Reviewhadley_heidi_cartoon brief drew four rocks; made_of_table aria-label "colour"brief: exactly two gray rocks, both in Miss Burke's hands; aria-label "color"
Reviewrecord line "the worked case appears in no item"; ⟂ pairscorrected below; PP-37 ⟂ PP-48 and PP-20 ⟂ L03 attached added to the type sheet
Figures 1streak_card olivemark #1f2a1e (opened: a near-black green)
Figures 2item grain boxes at 5.5×disp=320 on every item box; the bank's "none" box in the pebble's mid gray
Figures 3rule cards' last line on the edgeh = 40 + 20·n (opened: clear on all three)
Figures 4hardness_card two arrow styles; glyphs cross edges; arrow into "nothing"boxes 90 wide at step 110; two joins drawn by _arrow with the same 7 px head as the softer → harder line; "nothing" a grey fourth card with no arrow into it (opened)
Figuresdesc_card_limestone unplaceddeleted (its values still feed desc_cards_three)
Figuresstreak_plate_photo unplacedplaced in L03 between "Hadley rubs the pyrite across a white tile…" and streak_card; caption "Hadley rubs the pyrite across the white tile." (the reviewer's "Rubbing a mineral across the white tile." has no subject and verb; S38)
Figures minorluster_card pyrite-yellow chip; pp_card_m empty text node; two brief lines; desc_cards_three small on a phoneLIGHT for all three chips; an empty cell emits no text; "quartz on the LEFT … calcite on the RIGHT"; "cubic faces (square, flat, meeting at right angles)"; the three-card figure accepted as is
Leave rowsmineral defined without "natural / not alive"; the penny on calcite; calcite fizzing absent; quartz streak white; pyrite "nothing"; hematite excluded; limestone's grains; the opening videoleft as they say

The question for James (cleavage) — built as recommended: left out. The reviewer's zero-cost alternative (one caption on three_minerals_photo: "Mica breaks into thin flat sheets. How a mineral breaks is another clue geologists use.") is offered on the type sheet under "Questions for James — built as recommended".

Counts after v2

3 lessons · scripts 150 / 149 / 147 spoken words (cap 150; L03's beat 6 grew by five words and beats 3 and 7 gave five back) · intro 114 · summary 139 · opening video 90 · articles 281 / 302 / 343 words (check_g4_articles.py WARNs above 300; L02 carries the one sand line the blind read asked for, L03 the Essential chart lines and the streak line — kept, the Grade 3 approved range runs to 505) · idea lines 17 / 18 / 21 · quizzes 11 / 11 / 13 · attached 3 + 3 · practice 13 · bank 53 (47 four-option MCQs, 5 typed, 1 multi; EAR4-001 17 · EAR4-002 16 · EAR4-003 20; easy → medium → hard sorted; mean depth 0.41 / 0.81 / 1.10 rising with atom order; four-option keys A 9 · B 12 · C 13 · D 13 unchanged) · figures 46 (29 SVG, 13 photo, 4 cartoon: desc_card_limestone out, pp_table_w in).

Key strings. Attached (video order) B A C A B B (B 3 of 6). L01 quiz: 4-option 2 0 1; 3-option 0 0 1 2 2 1; 2-option 1. L02 quiz: 3-option 0 0 1; 2-option 0 1 1 0 1 1 0. L03 quiz: 3-option 0 2 0; 4-option 3 1 3 2 0 2 3; 2-option 1 0. Practice: 3-option 0 0 2 1 2 (the v1 record's "0 0 2 2 2" misread PR-7's key, which is 1 and was not changed); 4-option 2 1 3 1; 2-option 1. Bank: A 9 · B 12 · C 13 · D 13; multi C D.

Record line corrected. v1's design-check-sequence note "The worked case (quartz / calcite / pyrite) appears in no item" was false: PP-51 was the quartz / calcite case with the names removed. It is now mineral W, pink and glassy, on its own drawn table.

Checker results

Items whose stem, options, key, model, figure, blind text or accept list changed

L01-05, L01-06, L01-07 (stem, options, key, fb, why; figure display size and blind text) · L02-V1 (fb) · L03-03 (options, fb) · L03-11 (new; hardness recognition) · L03-12, L03-13 (renumbered from q11, q12; unchanged) · SUMMARY-01 (stem, key, fb, why) · PR-12 (stem, why, accept list) · PR-13 (accept list) · PP-05 (stem, why) · PP-06 (stem, why, figure colours and blind text) · PP-07 (stem, why, figure colour and blind text) · PP-09 (stem) · PP-12 (stem, why) · PP-20 (stem, why) · PP-26 (stem, options, why) · PP-47 (stem, why, accept list) · PP-48 (stem, why, accept list) · PP-51 (stem, options, figure added, why). Article and script lines changed: L02 a19–a20 (sand), L03 a20–a22 (the rule and the chart), a27–a28 (streak plate photo; quartz and calcite rubbed), L03 script beats 3, 6, 7.

Sentence-atomise, the new lines

LineIdeasCheck
"The test that gives two different results tells the minerals apart."1named actor (the test), verb carries the cause
"Miss Burke's mineral chart says a penny scratches calcite, and not even a steel nail scratches quartz."2 facts the chart states, one sourcethe chart is the actor; "not even" the positive form of "nothing scratches"
"So the scratched one is calcite, and the other one is quartz."1 conclusion"So" joins cause to effect
"Hadley rubs the quartz and the calcite on the tile too." / "Both leave a white mark, so streak does not tell those two apart."1 + 1split from one 24-word line (S1)
"So a grain of sand is a tiny bit of rock, and it is also a grain of a mineral."1 (two faces of one thing, joined with "also")the second-face rule
L03 beat 61spoken at 18 words, under the two-sentence cap

v3 — polish (2 October 2026, the re-read's five soft notes)

Skill: course-build → write-mcqs (SUMMARY-01, PP-06, PP-28, L03-11) → write-lesson (the one L02 article line) → write-explanation (the PP-06 and PP-28 why lines) → sentence-atomise (every new sentence) @ b0fa825

In plain words. Reader C agreed every key on the v2 bundle and left five soft notes. All five are in: the summary question no longer half-answers the feel question with "polished"; the bank's made-of analogy is a quilt of cloth patches, not the lesson's cookie or the quiz's muffin with a new noun; the bank's big-grain stone is black with white, yellow and light gray speckles, so it no longer looks like granite moved to a driveway; L02 says in one line that a rock can be many grains of one mineral, so PP-29 sits on taught ground; and L03's hardness recognition item names the test plainly. Nothing was cut or moved, so no renumbering and no key change. Commit nothing was the instruction; nothing is committed.

NoteChange
SUMMARY-01 "polished" half-answers "How does it feel?"stem "A rock is cut in half. The cut face is black and shiny, and its grains are too small to see. Which describing question is still not answered?" (key, fb, why unchanged)
PP-28 is the cookie analogy with a new noun (fruitcake; L02 q6 has the muffin)grep of lessons, quizzes and bank for cookie / muffin / fruitcake / cake confirmed the family; the new instance is a made thing that is not a food: "A quilt is made of red, blue and white patches of cloth sewn together, the way a rock is made of grains of minerals. Which part of the quilt is like one mineral grain?" — the whole quilt / the bed it lies on / one patch of cloth / the needle that sewed it (key C, as before)
PP-06 is granite under a lens on an Ohio driveway (gray fill; white, dark gray, black speckles; 15 of them)a black playground stone in Minnesota: fill #2b2f33, 12 speckles in white, yellow and light gray (BLACK_STONE, BLACK_SPECKS, n=12, seed 13), the same 5–7 px sizes, the same disp=320; the why names the three colours; blind text "black fill, 12 round speckles … in white, yellow and light gray". Opened the render at the item's page width: twelve separate pale discs on near-black, plainly big enough to see and nothing like granite's pink-white-black
PP-29 sits on a boundary L02 did not state (many grains of ONE mineral)L02 article, after "Limestone is made of a mineral called calcite, in grains too small to see.": "So a rock can also be many grains of one mineral, stuck together." (the second-face rule's "also"; the sibling class, a single piece of one mineral, is met two steps later on rock_vs_mineral)
L03-11 stem "What do we call what can scratch a mineral?" reads loosely"What do we call the test that finds what can scratch a mineral?" (options, key C, fb, why unchanged)

Changed ids. SUMMARY-01 (stem) · PP-06 (stem, why, figure colours, speckle count and seed, blind text) · PP-28 (stem, options, why) · L03-11 (stem) · L02 article a21 (one new idea line). Type sheet rows 2 and 7, their exemplars and inventory row 7 updated to match.

Checks. build_tools_check_topic.py → 0 FAIL, 25 WARN (v2's 24 S36 words plus "sewn" on PP-28 — fine, a grade-4 child knows sewing; kept). grade4/check_g4_articles.py → 0 FAIL; opening video 90 words; L02 article 315 (one line added; the Grade 3 approved range runs to 505). Site built to /tmp/g4t17_v3.html (46 figures, 0 missing) and add_strand_intro.py added the opening-video card. Four-option keys A 9 · B 12 · C 13 · D 13, unchanged. Fresh bundle blind/2026-10-02-v3/ (95 MCQ, 10 typed, 1 FRQ, 1 multi; keys sequestered); its 13 [Drawing: …] lines are data only.

Sentence-atomise, the new lines.

LineIdeasCheck
"A rock is cut in half." / "The cut face is black and shiny, and its grains are too small to see."1 / 2 givens of one facenamed thing (the rock, the cut face); the feel is now unsaid, so the key stands alone
"So a rock can also be many grains of one mineral, stuck together."1"So" joins to the limestone line; "also" marks the second face of "made of grains of minerals"
"One patch of cloth is one of the pieces the quilt is made of." / "So one patch of cloth is like one mineral grain."1 / 1named actor, one link per line
"This surface shows separate white, yellow and light gray speckles, each easy to pick out."1the drawing described in colours and separateness, never the label
The guidance, questions and accuracy review

Skill: course-build → review-lesson (Roles B, B2) → review-questions → review-accuracy (non-author pass; filed by the coordinator from the reviewer's hand-back) @ b0fa825

Topic 17 — guidance, questions and accuracy review, 2 October 2026

The topic is sound and nearly ready. Every count the record claims is true when re-run (scripts 150 / 149 / 147; intro 114; summary 139; opening video 90; articles 281 / 280 / 296; bank 53, 17 / 16 / 20 per atom, difficulty rising; keys spread; five typed terms whose stems never print the key; "lustre" accepted; the three Grade 3 recall sentences word for word). The science on a school kit is right, and pyrite over hematite is the correct call. Two things want fixing before the keys ship: L03 has a reasoning gap a nine-year-old will feel ("how does Hadley know the scratched one is calcite?") and never states the capstone's deciding sentence in the article body; and the freshness claim is false for PP-52 (the quartz / calcite worked case with the names removed) and thin for four attached items re-skinned.

The author's question (cleavage): leave it out, as the author recommends; mica's "black flaky" sheets already carry the idea as a describing word. If James wants the Florida word honoured at zero cost, one caption on three_minerals_photo: "Mica breaks into thin flat sheets. How a mineral breaks is another clue geologists use."

Leave (science confirmed): mineral defined without "natural / not alive" (a register scope line, no text change); the post-1982 penny still marks calcite with firm pressure (a teacher note at the kit stage); calcite fizzing rightly absent; quartz streak "white" the standard table value; pyrite "nothing" right; hematite excluded rightly; limestone "grains too small to see" a fair simplification; the strand intro states no later rule.

wherefindingrule brokenseveritythe rewrite
L03 article line ~300 and script beat 6"Calcite is the softer one" with nothing on the page that told Hadley so; the deciding rule only in the forest and the whysevery causal link stated; the rule on the pageEssentialArticle: "The test that gives two different results tells the minerals apart." then "Miss Burke's mineral chart says a penny scratches calcite, and nothing in the kit scratches quartz. So the scratched one is calcite." Script: "Miss Burke's chart says a penny scratches calcite, so that one is calcite, and the other is quartz."
PP-52the worked case with the names removedfresh instanceEssentialpink glassy mineral; second pink glassy mineral with one different result: "A fingernail scratches it." (key C)
PP-9, PP-12, PP-20, PP-49; Summary Q1attached / summary items re-skinned; Summary Q1 is L01's limestonecheck 43Worth fixingas the reviewer wrote (dark green gritty rock; the card with GRAINS row missing; the geologist's table column; the green mineral nothing scratches; the polished cut face)
L03 article, Test 4quartz / calcite streaks in the table untestedthe drawing shows what the text saysWorth fixing"Hadley rubs the quartz and the calcite on the tile too. Both leave a white mark, so streak does not tell those two apart."
L01 q5–q7 (and L01-06's failed key)yes / no on a three-label scaleoptions are the taught labelsWorth fixing → Essential given the blind read"What would you write in the GRAINS row?" big enough to see / you can just see them / too small to see; drawn at the teaching figure's size
L03 q3"nothing" offered as a thing to tryreal distractorsWorth fixinga fingernail / a penny / a steel nail; key C
PP-5"speckled" also answers the grains questionone true optionWorth fixing"A rock is described as 'black and white'."
PP-26"why not" stempositive stemWorth fixing"A boy writes 'hard' as the only word for a rock. Which sentence is true about the word 'hard'?"
PR-12, PP-48 (typed luster)"shine" refused with no lineevery correct answer accepted; sister-term lineWorth fixing"Type the geologist's word for how shiny a mineral looks."; why: "'Shine' is the everyday word. The geologist's word is luster."
L02 attached fbboth fb identicalcheck 36Worth fixingno-fb: "Each pink grain and each black grain is one kind of stuff, the same all the way through. So each grain is a mineral."
hadley_heidi_cartoon brief; made_of_table aria-labelfour rocks drawn, two in the story; "colour"figures tell the truth; US spellingWorth fixingtwo rocks, one in each hand; "color"
record line "the worked case appears in no item"; ⟂ PP-37 ⟂ PP-49, PP-20 ⟂ L03 attached——recordcorrect; add
The figure review

Skill: course-build → review-figures (non-author pass; filed by the coordinator from the reviewer's hand-back) @ b0fa825 — figures at g3-5-science commit 0828919

Topic 17 — figure review, 2 October 2026

Clean, calm tables and cards that read in one glance: the four-row describing card, the five-column test table with a heading on every column, the three grain boxes side by side. The one picture that makes a claim with colour, the streak card, says the wrong colour: the text says "greenish black" and the tile shows a mid olive green. Every real thing (rocks, minerals, penny, nail, tile) is still a placeholder, so the lesson has no rock in it yet. Four fixes before a cold read, two unplaced keys.

  1. streak_card mark is olive, not greenish black (#6b7a3a). Use a near-black green, about #1f2a1e, 9 px stroke.
  2. Item grain boxes display at 5.5× the teaching size. _grain_item frames are 160 × 114 at width="100%", so the 1.6 px "you can just see them" speckles render at about 9 px on the page — plainly visible dots, three times the teaching figure's. The picture teaches that "just see them" looks like "big enough to see" (and both blind readers answered L01-06 the other way). Pass disp=320 so the item box renders at the teaching figure's 2×; same for pp_grains_*. Frame-floor rule.
  3. Rule cards' last line sits on the card's bottom edge (rule_describe, rule_minerals, rule_test). h = 40 + 20·n.
  4. hardness_card has two arrow styles and the small glyphs cross box edges. Boxes 90 wide at step 110; the three joins as short lines with the same head as the bottom arrow; "nothing" is a result, not a scratcher — keep it as the grey fourth card with no arrow into it.

Unplaced: desc_card_limestone — delete; streak_plate_photo — place in L03 between "Hadley rubs the pyrite across a white tile" and streak_card, caption "Rubbing a mineral across the white tile."

Minor: desc_cards_three small text on a phone (accept or stack); q_grains_none and pp_grains_none identical renders (give the bank one the pebble's mid grey); luster_card colours the SHINY LIKE METAL chip pyrite-yellow (LIGHT for all three); pp_card_m emits one empty <text>; quartz_calcite_photo brief needs "quartz left, calcite right"; pyrite_photo brief "cubic faces". Test-table truth confirmed (quartz nothing / white; calcite a penny / white; pyrite nothing / greenish black, metallic); the hematite exclusion is right. Blind texts and alts carry data only; headache figures show the answer's layer off; Grade 3 Topic 17's drawers imported as Grade 3 drew them; no caption says "real"; all 17 placeholder briefs complete and specimen-named.

keykindused byverdictwhat is wrongthe fix
desc_card_headache, desc_card_granite, desc_card_sandstone, grain_sizes, pp_card_l, made_of_table, rock_vs_mineral, test_table_headache, test_table_two, test_table_three, q_table_jk, q_table_lm, pp_table_np / rs / tvsvgL01–L03, itemsPASS——
desc_card_limestonesvgnoneDELETEunplaceddelete
desc_cards_threesvgL01minorsmall on phoneaccept or stack
rule_describe, rule_minerals, rule_testsvgL01–L03FIXlast line on the borderh = 40 + 20n
pp_card_msvgbankminorempty text nodeskip ""
q_grains_big, q_grains_small, q_grains_none, pp_grains_big, pp_grains_nonesvg itemL01 quiz / bankFIX5.5× display; twin rendersdisp=320; grey fill on the bank one
hardness_cardsvgL03FIXtwo arrow styles; glyphs cross edges; "nothing" in the chainlines + one head; no arrow into "nothing"
streak_cardsvgL03FIXolive, not greenish black#1f2a1e
luster_cardsvgL03minoryellow metal chipLIGHT chips
enchanted_rock_photo, granite_photo, two_gray_rocks_photo, sandstone_photo, limestone_photo, granite_lens_photo, three_minerals_photo, cookie_photo, pebble_boulder_photo, penny_nail_photophotointro–L03PASS——
quartz_calcite_photo, pyrite_photophotoL03minorleft/right; "cubic faces"add
streak_plate_photophotononePLACEunplacedL03 before streak_card
gloria_enchanted_cartoon, hadley_heidi_cartoon, gloria_lens_cartoon, hadley_test_cartooncartoonintro–L03PASS——

Three best: test_table_three, grain_sizes, made_of_table. Three weakest: streak_card, hardness_card, the item grain boxes as displayed.

The blind read and the v2 re-read

Skill: course-build → review-lesson (Role A blind key read, two readers; Role C adjudication by the coordinator) @ b0fa825

Topic 17 — What a rock is made of — blind read, 2 October 2026

One key did not survive: L01-06. Both readers answered "no" to "Can you see the grains?" on a drawing of 90 speckles of 1.6 px; the key is "yes". A drawn fine texture reads as visible dots to one reader and as too-small-to-see to another, so the item has two defensible answers as drawn. Everything else agreed (106 items each; MCQ disagreements 1 of 106 for both; PP-50 multi B, C matched; the FRQ model in the key's words). The intro poll is not bundled by design.

Flags carried into the fix pass

ItemWhoFlagRuling
L01-06A, Bkey "yes" against two "no" reads; 1.6 px speckles are at the edgeredraw with a flat fill (the answer "no") or with grains plainly big enough (the answer "yes"), and say in the stem which drawing level it is; or use the three-level options
PP-06A, Btwo defensible: no drawing marks the boundary between "big enough to see" and "you can just see them"pin the three levels with a reference strip in L01, or re-key to two options
PP-06, PP-07, PP-09A, Blesson scenes renamed (L01-05, L01-07, SUMMARY-01 with a place or colour added)re-scene
hardnessA, Bluster and streak each have a definition item in L03; hardness has noneadd one
PR-12, PP-47 (typed luster)A, Bthe rock card prints SHINE and L01 says "shiny or dull"accept "shine" / "shiny" / "shininess", and "lustre" everywhere; PR-13 accept "hard"
"geologist"Beight bank items, no lesson itemone lesson line names it, or cut from the stems
PP-26 stemA, B"hard" does describe the rock; it fails to tell rocks apart"Why does 'hard' not help tell this rock from other rocks?"
PR-04 vs PP-33B"a sand grain is a tiny bit of rock" and "a grain of a mineral" read as a contradictionone line in L02 (sand grains are bits of rock, which are grains of minerals)
quiz orderB"grains" used at L01-04 before L01-10 defines it; "streak" L03-02 before L03-11; "luster" L03-04 before L03-10the lessons coin them first; the guidance review confirms
PP-51Blong stem for the agea small table

Readers' files: blind/2026-10-02/READER_A.md, READER_B.md.

v2 re-read, 2 October 2026 (Reader C on blind/2026-10-02-v2, the whole bundle)

Every key agreed (107 items; MCQ disagreements 0; PP-50 multi C, D matched; the five typed answers on the lists; the FRQ model in the key's words). The failed key is gone: the three grain items each pin one level (15 speckles at 10–14 px on the page = big enough to see; 90 dots at about 3 px = you can just see them; even fill = too small to see), and PP-06 / PP-07 reuse the two clear ends. Soft notes to the polish pass: SUMMARY-01 drop "polished" (it half-answers the feel question); PP-28 is the cookie analogy with a new noun; PP-06 is the granite-under-a-lens scene on a driveway; L02 should say in one line that a rock can be many grains of one mineral (PP-29 sits on that boundary); L03-11's stem wording. Reader's file: READER_C.md.