@graffiticode/l0175 0.2.0 → 0.3.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/compiler.d.ts.map +1 -1
- package/dist/compiler.js +94 -130
- package/dist/compiler.js.map +1 -1
- package/dist/embedding.d.ts +1 -0
- package/dist/embedding.d.ts.map +1 -1
- package/dist/embedding.js +105 -11
- package/dist/embedding.js.map +1 -1
- package/dist/index.d.ts +4 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2 -0
- package/dist/index.js.map +1 -1
- package/dist/lexicon.d.ts +7 -0
- package/dist/lexicon.d.ts.map +1 -1
- package/dist/lexicon.js +16 -8
- package/dist/lexicon.js.map +1 -1
- package/dist/static/examples.md +105 -0
- package/dist/static/instructions.md +397 -47
- package/dist/static/language-info.json +19 -4
- package/dist/static/lexicon.json +112 -0
- package/dist/static/scope.json +9 -8
- package/dist/static/spec.html +81 -15
- package/dist/static/stems.md +181 -5
- package/dist/static/targets.json +279 -0
- package/dist/static/template.gc +7 -67
- package/dist/static/unparse-hints.json +3 -0
- package/dist/static/usage-guide.md +48 -5
- package/dist/targets.d.ts +27 -0
- package/dist/targets.d.ts.map +1 -0
- package/dist/targets.js +250 -0
- package/dist/targets.js.map +1 -0
- package/dist/verify-example.d.ts +27 -0
- package/dist/verify-example.d.ts.map +1 -0
- package/dist/verify-example.js +82 -0
- package/dist/verify-example.js.map +1 -0
- package/package.json +2 -2
- package/spec/#template.gc# +20 -0
- package/spec/docs.md +51 -16
- package/spec/examples/c1-t1-tm1-multiplechoice.expect.json +1 -0
- package/spec/examples/c1-t1-tm1-multiplechoice.gc +27 -0
- package/spec/examples/c1-t1-tm2-multiselect.expect.json +1 -0
- package/spec/examples/c1-t1-tm2-multiselect.gc +27 -0
- package/spec/examples/c1-t1-tm3-hottext.expect.json +1 -0
- package/spec/examples/c1-t1-tm3-hottext.gc +27 -0
- package/spec/examples/c1-t10-tm1-multiplechoice.expect.json +1 -0
- package/spec/examples/c1-t10-tm1-multiplechoice.gc +15 -0
- package/spec/examples/c1-t10-tm2-multiselect.expect.json +1 -0
- package/spec/examples/c1-t10-tm2-multiselect.gc +15 -0
- package/spec/examples/c1-t10-tm3-hottext.expect.json +1 -0
- package/spec/examples/c1-t10-tm3-hottext.gc +13 -0
- package/spec/examples/c1-t11-tm1-ebsr.expect.json +4 -0
- package/spec/examples/c1-t11-tm1-ebsr.gc +30 -0
- package/spec/examples/c1-t11-tm2-hottext.expect.json +4 -0
- package/spec/examples/c1-t11-tm2-hottext.gc +30 -0
- package/spec/examples/c1-t11-tm3-shorttext.expect.json +4 -0
- package/spec/examples/c1-t11-tm3-shorttext.gc +30 -0
- package/spec/examples/c1-t2-tm1-multiplechoice.expect.json +1 -0
- package/spec/examples/c1-t2-tm1-multiplechoice.gc +29 -0
- package/spec/examples/c1-t2-tm2-multiselect.expect.json +1 -0
- package/spec/examples/c1-t2-tm2-multiselect.gc +28 -0
- package/spec/examples/c1-t2-tm3-ebsr.expect.json +1 -0
- package/spec/examples/c1-t2-tm3-ebsr.gc +29 -0
- package/spec/examples/c1-t2-tm4-hottext.expect.json +1 -0
- package/spec/examples/c1-t2-tm4-hottext.gc +19 -0
- package/spec/examples/c1-t2-tm5-shorttext.expect.json +1 -0
- package/spec/examples/c1-t2-tm5-shorttext.gc +20 -0
- package/spec/examples/c1-t4-tm1-ebsr.expect.json +4 -0
- package/spec/examples/c1-t4-tm1-ebsr.gc +30 -0
- package/spec/examples/c1-t4-tm2-hottext.expect.json +4 -0
- package/spec/examples/c1-t4-tm2-hottext.gc +30 -0
- package/spec/examples/c1-t4-tm3-shorttext.expect.json +4 -0
- package/spec/examples/c1-t4-tm3-shorttext.gc +30 -0
- package/spec/examples/c1-t8-tm1-multiplechoice.expect.json +1 -0
- package/spec/examples/c1-t8-tm1-multiplechoice.gc +25 -0
- package/spec/examples/c1-t8-tm2-multiselect.expect.json +1 -0
- package/spec/examples/c1-t8-tm2-multiselect.gc +25 -0
- package/spec/examples/c1-t8-tm3-hottext.expect.json +1 -0
- package/spec/examples/c1-t8-tm3-hottext.gc +25 -0
- package/spec/examples/c1-t9-tm1-multiplechoice.expect.json +1 -0
- package/spec/examples/c1-t9-tm1-multiplechoice.gc +23 -0
- package/spec/examples/c1-t9-tm2-multiselect.expect.json +1 -0
- package/spec/examples/c1-t9-tm2-multiselect.gc +24 -0
- package/spec/examples/c1-t9-tm3-ebsr.expect.json +10 -0
- package/spec/examples/c1-t9-tm3-ebsr.gc +30 -0
- package/spec/examples/c1-t9-tm4-hottext.expect.json +10 -0
- package/spec/examples/c1-t9-tm4-hottext.gc +20 -0
- package/spec/examples/c1-t9-tm5-shorttext.expect.json +10 -0
- package/spec/examples/c1-t9-tm5-shorttext.gc +20 -0
- package/spec/examples.md +100 -86
- package/spec/instructions.md +367 -44
- package/spec/language-info.json +18 -3
- package/spec/rag-examples-design.md +74 -0
- package/spec/scope.json +9 -8
- package/spec/spec.md +90 -15
- package/spec/stems.md +181 -5
- package/spec/template.gc +7 -67
- package/spec/usage-guide.md +48 -5
package/spec/instructions.md
CHANGED
|
@@ -1,8 +1,7 @@
|
|
|
1
1
|
<!-- SPDX-License-Identifier: CC-BY-4.0 -->
|
|
2
|
-
<!-- gc:model=opus -->
|
|
3
2
|
# L0175 Dialect Extensions
|
|
4
3
|
|
|
5
|
-
_Revised: 2026-
|
|
4
|
+
_Revised: 2026-08-28_
|
|
6
5
|
|
|
7
6
|
L0175 composes 5th-grade ELA assessment items (Smarter Balanced · Grade 5 · Claim 1 ·
|
|
8
7
|
Reasoning & Evidence) from an authored, inline superset of tagged content. One language serves
|
|
@@ -14,10 +13,33 @@ Always declare a top-level `target` (the SBAC learning target the program compos
|
|
|
14
13
|
|
|
15
14
|
- **`c1-t4`** — Target 4: Reasoning & Evidence over **literary** texts (RL standards). Dimensions:
|
|
16
15
|
`character`, `setting`, `event`, `point-of-view`, `theme`, `topic`, `narrators-feelings`,
|
|
17
|
-
`character-relationship`.
|
|
16
|
+
`character-relationship`. Companion standards by dimension: `character` / `character-relationship`
|
|
17
|
+
/ `setting` / `event` → `rl-3`; `point-of-view` / `narrators-feelings` → `rl-6`; **`theme` /
|
|
18
|
+
`topic` → `rl-2`** (the CCSS theme standard — **not** `rl-9`). `rl-1` (cite evidence) is always
|
|
19
|
+
added. You normally **omit** `standard` and let the dimension pick its companion; the full
|
|
20
|
+
Grade-5 **RL** strand (`rl-1`–`rl-7`, `rl-9`) is accepted if you author one explicitly.
|
|
21
|
+
**`theme` vs `topic`** (same `rl-2`, different dimensions): `topic` = what the text is *about*
|
|
22
|
+
(cued by "**mostly about**" / "what is the story about"); `theme` = the *lesson/message* (cued by
|
|
23
|
+
"the theme" / "the message" / "the lesson"). Tag a "mostly about" prompt `topic` and phrase its
|
|
24
|
+
correct answer as a subject statement, not a life lesson.
|
|
18
25
|
- **`c1-t11`** — Target 11: Reasoning & Evidence over **informational** texts (RI standards).
|
|
19
26
|
Dimensions: `relationships-interactions`, `author-use-of-information`, `point-of-view`,
|
|
20
27
|
`purpose`, `authors-opinion`. Standards: `ri-1` (always) + `ri-3` / `ri-6` / `ri-7` / `ri-8` / `ri-9`.
|
|
28
|
+
**`purpose` vs `point-of-view`** (both read "author's …", different companions): `purpose` = *why
|
|
29
|
+
the author wrote it* (cued by "author's purpose") → `ri-8`; `point-of-view` = *the author's stance*
|
|
30
|
+
(cued by "author's point of view") → `ri-6`. Tag by the cue and prefer to **omit** `standard` so
|
|
31
|
+
the dimension infers the right companion.
|
|
32
|
+
- **`c1-t2`** — Target 2: **Central Ideas** over **literary** texts (RL standards). The **literary
|
|
33
|
+
twin of `c1-t9`** and, with it, the only target offering **all five** item types
|
|
34
|
+
(`multiple-choice`, `multi-select`, `ebsr`, `hot-text` single-part, `short-text`). Dimensions:
|
|
35
|
+
`theme`, `central-idea`, `key-detail`, `summary` — all four answer to `rl-2`, so `standards`
|
|
36
|
+
composes to `["rl-1", "rl-2"]`. **DOK 2** (3 for the written response). Same **significance**
|
|
37
|
+
distractor taxonomy as T9 (`too-narrow`, `too-broad`, `misreads-detail`, `insignificant`).
|
|
38
|
+
**Two T2-only rules:** (1) **theme leads** — for a story or poem prefer `theme` and phrase the
|
|
39
|
+
correct answer as a *lesson or message*, not a plot summary (`central-idea` is for a "main idea"
|
|
40
|
+
prompt); (2) **summary is scoped** — the guideline forbids asking students to summarize the
|
|
41
|
+
*entire* text, so every `summary` stem must point at a section or key event ("Summarize what
|
|
42
|
+
happens after…"). `key-detail` covers the guideline's "key events".
|
|
21
43
|
- **`c1-t9`** — Target 9: **Central Ideas** over **informational** texts (RI standards). A
|
|
22
44
|
DIFFERENT skill from Reasoning & Evidence — synthesize and condense: the main/central idea, the
|
|
23
45
|
key details that build it, and summary (NOT inference + justification). Dimensions: `central-idea`,
|
|
@@ -27,6 +49,16 @@ Always declare a top-level `target` (the SBAC learning target the program compos
|
|
|
27
49
|
the correct selection). Distractors use a **significance** taxonomy (`too-narrow`,
|
|
28
50
|
`too-broad`, `misreads-detail`, `insignificant`) — usually true statements that just aren't the
|
|
29
51
|
central idea.
|
|
52
|
+
- **`c1-t1`** — Target 1: **Key Details** over **literary** texts. The **literary twin of `c1-t8`**
|
|
53
|
+
and the same model: the inference/conclusion is **GIVEN in the stem**, and the student selects the
|
|
54
|
+
supporting **evidence**. Dimension: `supporting-evidence`. Standard: **`rl-1` and nothing else** —
|
|
55
|
+
the guideline names no companion, so a composed item's `standards` is exactly `["rl-1"]`; omit
|
|
56
|
+
`standard` on the outcome. **DOK 1–2**. Item types: `multiple-choice`, `multi-select`, `hot-text`
|
|
57
|
+
(single-part) — no EBSR, no short-text. **Author ONE supported `claim` = the given inference (its
|
|
58
|
+
`focus`), state it in the `stem`, and author `source`s as the options: `directly-supports` =
|
|
59
|
+
correct evidence (with a `quote`), `supports-wrong-claim`/`irrelevant` = distractor evidence. No
|
|
60
|
+
distractor claims.** Its stems offer `line` as a selectable unit and say `[author/narrator]`;
|
|
61
|
+
Multi-Select is exactly **two** correct.
|
|
30
62
|
- **`c1-t8`** — Target 8: **Key Details** over **informational** texts (RI standards). A DIFFERENT
|
|
31
63
|
model: the inference/conclusion is **GIVEN in the stem**, and the student selects the supporting
|
|
32
64
|
**evidence** (the answer is evidence, not a chosen statement). Dimension: `supporting-evidence`.
|
|
@@ -46,22 +78,25 @@ Always declare a top-level `target` (the SBAC learning target the program compos
|
|
|
46
78
|
(Multi-Select) `status correct` + `status distractor` meanings (each with a T10 `error-type`
|
|
47
79
|
+ `rationale`). The outcome's `focus` names the word; state the word + its context in the `stem`.**
|
|
48
80
|
|
|
49
|
-
**Infer the target — the user need not state it.**
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
`target
|
|
64
|
-
|
|
81
|
+
**Infer the target — the user need not state it.** Pick on **two axes: the skill asked, and the
|
|
82
|
+
text type.** Most skills exist in both a literary and an informational target, so decide the skill
|
|
83
|
+
first, then the text type:
|
|
84
|
+
|
|
85
|
+
| Skill — how to recognize it | **Literary** (story / poem / narrative) | **Informational** (article / report) |
|
|
86
|
+
|---|---|---|
|
|
87
|
+
| **Reasoning & Evidence** — infer/conclude AND justify ("infer/conclude/why") | `c1-t4` | `c1-t11` |
|
|
88
|
+
| **Central Ideas** — theme, main idea, the key details that build it, or a summary ("theme/message/main idea/summarize") | `c1-t2` | `c1-t9` |
|
|
89
|
+
| **Key Details** — the request **states an inference and asks which detail/sentence supports it** (the answer is evidence) | `c1-t1` | `c1-t8` |
|
|
90
|
+
| **Word Meanings** — "what does [word] mean [in context]" | — | `c1-t10` |
|
|
91
|
+
|
|
92
|
+
The skill cues also point at a dimension: character / theme / narrator's point of view → the R&E
|
|
93
|
+
literary target. When the **text type** is genuinely ambiguous, prefer the literary target; when the
|
|
94
|
+
**skill** is ambiguous, match the verbs in the request. Write the choice as the first top-level
|
|
95
|
+
form: `target c1-t11`. Use the dimensions, standards, and stem catalog (in `stems.md`) for that
|
|
96
|
+
target; mixing targets' vocabularies is a compile error, and the passage `type` must match the
|
|
97
|
+
target (literary for T4/T2/T1; informational for T11/T9/T8/T10). If `target` is omitted entirely
|
|
98
|
+
the compiler defaults to `c1-t4` and warns — so always emit one explicitly rather than relying on
|
|
99
|
+
the default.
|
|
65
100
|
|
|
66
101
|
## Authoring contract
|
|
67
102
|
|
|
@@ -85,7 +120,7 @@ Quote free text (`text`, `rationale`, `subject`, passage heading) and id labels
|
|
|
85
120
|
|
|
86
121
|
## Forms and attributes
|
|
87
122
|
|
|
88
|
-
- **target** `c1-t4` | `c1-t11` — top level; selects the learning-target profile (dimensions,
|
|
123
|
+
- **target** `c1-t4` | `c1-t11` | `c1-t2` | `c1-t9` | `c1-t1` | `c1-t8` | `c1-t10` — top level; selects the learning-target profile (dimensions,
|
|
89
124
|
standards, stem catalog). Always author one; if omitted, the compiler defaults to `c1-t4`.
|
|
90
125
|
- **grade** `<n>` — optional, top level (e.g. `grade 5`). The reading-level target the compiler
|
|
91
126
|
checks the passage against. Defaults to the guideline/target's grade (5 for `c1-t4`/`c1-t11`);
|
|
@@ -115,8 +150,11 @@ Quote free text (`text`, `rationale`, `subject`, passage heading) and id labels
|
|
|
115
150
|
(required — the id of the supported correct claim; on `multi-select` a **list** of ids = the
|
|
116
151
|
correct set), `stem` (required — the Part A / single-question stem / short-text prompt, authored
|
|
117
152
|
from `stems.md`), and on EBSR `stem-b` (required — the Part B stem). Optional: `subject`,
|
|
118
|
-
`standard`, `dok`,
|
|
119
|
-
|
|
153
|
+
`standard`, `dok`, `task-model` (`tm1`..`tm5` — the per-target task model; the compiler resolves
|
|
154
|
+
it to the item type for the program's `target` and hard-errors if it disagrees with `type`, so it
|
|
155
|
+
both documents and guards intent — see "Task models are per-target" below), and `rubric`
|
|
156
|
+
(short-text only — a list of `band score <n> descriptor "…"` elements; defaults to a 0/1/2 rubric
|
|
157
|
+
if omitted).
|
|
120
158
|
- **band** — a rubric row: `band score 2 descriptor "…" {}`. Used only inside an outcome's `rubric`.
|
|
121
159
|
- **word** / **meaning** (**target `c1-t10` only**) — a top-level `words` list of `word`s; each
|
|
122
160
|
`word` has `id`, `text` (the targeted word/phrase), optional `line`/`quote` (its context), and a
|
|
@@ -138,14 +176,62 @@ Quote free text (`text`, `rationale`, `subject`, passage heading) and id labels
|
|
|
138
176
|
in the focus word's paragraph are warned and dropped.
|
|
139
177
|
- A top-level **`title`** attribute (before `passage`) names the assessment; it is echoed on the output.
|
|
140
178
|
|
|
141
|
-
## Stems (Appropriate Stems
|
|
179
|
+
## Stems (Appropriate Stems)
|
|
142
180
|
|
|
143
181
|
**You author the stem; the compiler does not generate it. Use the guideline's Appropriate-Stem
|
|
144
|
-
templates verbatim — do not invent phrasings.**
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
182
|
+
templates verbatim — do not invent phrasings.** `stems.md` has a **section per target** (T4, T11,
|
|
183
|
+
T9, T8, T10), each with its own task models — open the section for the `target` you picked. For
|
|
184
|
+
each item, pick the one template that matches the item type and the task, and fill its bracketed
|
|
185
|
+
`[...]` slot. Author `stem` (Part A / single-question / short-text prompt) and, on EBSR, `stem-b`
|
|
186
|
+
(Part B).
|
|
187
|
+
|
|
188
|
+
### Task models are per-target — a number alone is meaningless
|
|
189
|
+
|
|
190
|
+
⚠ **Task-model numbers are PER-TARGET and COLLIDE across targets.** The same number maps to a
|
|
191
|
+
different item type depending on the `target`. Look at `tm3` alone:
|
|
192
|
+
|
|
193
|
+
| Number | `c1-t4` / `c1-t11` | `c1-t2` / `c1-t9` | `c1-t1` / `c1-t8` / `c1-t10` |
|
|
194
|
+
|--------|--------------------|-------------------|------------------------------|
|
|
195
|
+
| **tm3** | short-text | **ebsr (two-part)** | hot-text |
|
|
196
|
+
|
|
197
|
+
So "task model 3" cannot be resolved without first knowing the target. **Do not assume the
|
|
198
|
+
Reasoning & Evidence (T4/T11) numbering applies elsewhere** — under the Central Ideas targets
|
|
199
|
+
(`c1-t2`, `c1-t9`), Task Model 3 is EBSR, Task Model 4 is Hot Text, Task Model 5 is Short Text.
|
|
200
|
+
|
|
201
|
+
The full per-target task-model → item-type mapping (the compiler enforces exactly this):
|
|
202
|
+
|
|
203
|
+
<!-- GENERATED:task-models START (from targets.json — regenerated by tools/build-static.js; do not edit by hand) -->
|
|
204
|
+
| Target | tm1 | tm2 | tm3 | tm4 | tm5 |
|
|
205
|
+
|--------|-----|-----|-----|-----|-----|
|
|
206
|
+
| `c1-t4` — Grade 5 · Claim 1 · Target 4 (Reasoning & Evidence) | ebsr | hot-text | short-text | — | — |
|
|
207
|
+
| `c1-t11` — Grade 5 · Claim 1 · Target 11 (Reasoning & Evidence) | ebsr | hot-text | short-text | — | — |
|
|
208
|
+
| `c1-t2` — Grade 5 · Claim 1 · Target 2 (Central Ideas) | multiple-choice | multi-select | ebsr | hot-text | short-text |
|
|
209
|
+
| `c1-t9` — Grade 5 · Claim 1 · Target 9 (Central Ideas) | multiple-choice | multi-select | ebsr | hot-text | short-text |
|
|
210
|
+
| `c1-t1` — Grade 5 · Claim 1 · Target 1 (Key Details) | multiple-choice | multi-select | hot-text | — | — |
|
|
211
|
+
| `c1-t8` — Grade 5 · Claim 1 · Target 8 (Key Details) | multiple-choice | multi-select | hot-text | — | — |
|
|
212
|
+
| `c1-t10` — Grade 5 · Claim 1 · Target 10 (Word Meanings) | multiple-choice | multi-select | hot-text | — | — |
|
|
213
|
+
<!-- GENERATED:task-models END -->
|
|
214
|
+
|
|
215
|
+
**Normalization rule (required).** When a request names a task model by number ("TM3", "task
|
|
216
|
+
model 3"), **resolve it against the row for the program's `target`** in the table above — never the
|
|
217
|
+
T4/T11 default. Before composing, echo the resolution, e.g. `target c1-t9, TM3 → ebsr`, and author
|
|
218
|
+
that item type.
|
|
219
|
+
|
|
220
|
+
**Author it whenever the request specifies a task model.** When the request names a task model —
|
|
221
|
+
by number ("TM3") or via an item type that implies one — author the resolved number directly on the
|
|
222
|
+
outcome as `task-model tm3` (alongside `type`). The compiler resolves it against the target's table
|
|
223
|
+
and **hard-errors on a mismatch** with `type` (or supplies `type` when you omit it) — so
|
|
224
|
+
`outcome … task-model tm3 type ebsr` on `c1-t9` is self-checking, and `task-model tm3 type
|
|
225
|
+
short-text` is rejected. It stays optional (the compiler emits a non-blocking warning when an
|
|
226
|
+
outcome omits it), but specifying it makes the task model explicit and verifiable — so include it
|
|
227
|
+
whenever it is known.
|
|
228
|
+
|
|
229
|
+
The task-model mapping and Part-A choices below are the **Reasoning & Evidence (T4/T11)** catalog
|
|
230
|
+
(EBSR → Task Model 1, Hot Text → Task Model 2, Short Text → Task Model 3; task = inference vs.
|
|
231
|
+
conclusion vs. author-intent; plain subject vs. narrator's-feelings vs. relationship). **T9, T8,
|
|
232
|
+
and T10 use different task models and stems** — see their `stems.md` sections (e.g. T9 "Which
|
|
233
|
+
sentence best shows the main idea…", T8 states the inference then "Which detail … best supports
|
|
234
|
+
this conclusion?", T10 "What does the word … most likely mean?"). Common R&E Part A choices:
|
|
149
235
|
|
|
150
236
|
- inference — "Which of these inferences about [...] is supported by the passage?"
|
|
151
237
|
- conclusion — "Which of these conclusions about [...] is supported by the passage?"
|
|
@@ -182,6 +268,15 @@ outright is literal recall and out of scope.
|
|
|
182
268
|
|
|
183
269
|
## Authoring guidance
|
|
184
270
|
|
|
271
|
+
The distractor-pool, error-type-coverage, and EBSR Part-B rules below are the **Reasoning &
|
|
272
|
+
Evidence (T4/T11)** contract — they apply wherever wrong answers are authored as `distractor`
|
|
273
|
+
claims. The other targets author their wrong answers differently (see Step 0): **T9** uses
|
|
274
|
+
`distractor` claims too but with the significance taxonomy (`too-narrow` / `too-broad` /
|
|
275
|
+
`misreads-detail` / `insignificant`); **T8** has **no distractor claims** — its foils are
|
|
276
|
+
non-supporting `source`s (`supports-wrong-claim` / `irrelevant`); **T10** authors distractor
|
|
277
|
+
`meaning`s, not claims. The grade-level, length-balance, and stem-wording rules apply to **all**
|
|
278
|
+
targets.
|
|
279
|
+
|
|
185
280
|
- For each EBSR/Hot-Text outcome, author **at least 5 viable distractor claims that `targets`
|
|
186
281
|
it**, covering all three error types (`misreads-detail`, `erroneous-inference`,
|
|
187
282
|
`faulty-reasoning`) — with ≥2 alternatives in at least two of the types. An item draws only 3
|
|
@@ -269,17 +364,17 @@ outright is literal recall and out of scope.
|
|
|
269
364
|
|
|
270
365
|
## Built-in enumerations
|
|
271
366
|
|
|
272
|
-
- `target`: `c1-t4`, `c1-t11`, `c1-t9`, `c1-t8`, `c1-t10` (top level; always author one — defaults to `c1-t4` if omitted)
|
|
367
|
+
- `target`: `c1-t4`, `c1-t11`, `c1-t2`, `c1-t9`, `c1-t1`, `c1-t8`, `c1-t10` (top level; always author one — defaults to `c1-t4` if omitted)
|
|
273
368
|
- `grade`: a number (top level, optional; defaults to the target's grade — 5 for all current targets)
|
|
274
369
|
- item `type`: `ebsr`, `hot-text`, `short-text`, `multiple-choice`, `multi-select` · passage `type`: `literary`, `informational`
|
|
275
|
-
(allowed per target — T4/T11: ebsr/hot-text/short-text · T9:
|
|
370
|
+
(allowed per target — T4/T11: ebsr/hot-text/short-text · T2/T9: all five · T1/T8/T10: multiple-choice/multi-select/hot-text)
|
|
276
371
|
- `dimension` (**c1-t4**): `character`, `setting`, `event`, `point-of-view`, `theme`, `topic`, `narrators-feelings`, `character-relationship`
|
|
277
372
|
- `dimension` (**c1-t11**): `relationships-interactions`, `author-use-of-information`, `point-of-view`, `purpose`, `authors-opinion`
|
|
278
|
-
- `dimension` (**c1-t9**): `central-idea`, `key-detail`, `summary` · (**c1-t8**): `supporting-evidence` · (**c1-t10**): `word-meaning`
|
|
373
|
+
- `dimension` (**c1-t2**): `theme`, `central-idea`, `key-detail`, `summary` · (**c1-t9**): `central-idea`, `key-detail`, `summary` · (**c1-t1 / c1-t8**): `supporting-evidence` · (**c1-t10**): `word-meaning`
|
|
279
374
|
- claim `status`: `supported`, `distractor` · source `status`: `directly-supports`, `supports-wrong-claim`, `irrelevant` · meaning `status` (c1-t10): `correct`, `distractor`
|
|
280
|
-
- `error-type` (**c1-t4 / c1-t11**): `misreads-detail`, `erroneous-inference`, `faulty-reasoning` · (**c1-t9**): `too-narrow`, `too-broad`, `misreads-detail`, `insignificant` · (**c1-t8**): none — wrong answers are non-supporting `source`s · (**c1-t10**): `other-meaning`, `misinterprets`, `wrong-context`
|
|
281
|
-
- `standard` (**c1-t4**)
|
|
282
|
-
- `dok`: `r-dok1`, `r-dok2`, `r-dok3` (R&E items are `r-dok3`; T9 selected-response is `r-dok2`,
|
|
375
|
+
- `error-type` (**c1-t4 / c1-t11**): `misreads-detail`, `erroneous-inference`, `faulty-reasoning` · (**c1-t2 / c1-t9**): `too-narrow`, `too-broad`, `misreads-detail`, `insignificant` · (**c1-t1 / c1-t8**): none — wrong answers are non-supporting `source`s · (**c1-t10**): `other-meaning`, `misinterprets`, `wrong-context`
|
|
376
|
+
- `standard` — primary companions (normally inferred from the dimension; author one only to override): (**c1-t4**) `rl-1` + `rl-2` (theme/topic) / `rl-3` / `rl-6` · (**c1-t11**) `ri-1` + `ri-3` / `ri-6` / `ri-7` / `ri-8` · (**c1-t2**) `rl-1` + `rl-2` (every dimension) · (**c1-t9**) `ri-1` + `ri-2` · (**c1-t1**) `rl-1` **alone** (no companion) · (**c1-t8**) `ri-1` + `ri-7` · (**c1-t10**) `ri-4` + `l-4` / `l-4a` / `l-4b` / `l-4c` / `l-5c`. The **full CCSS Grade-5 strand for the target's text type is accepted**: any `rl-1`–`rl-7` / `rl-9` on a literary target (c1-t4/c1-t2/c1-t1), any `ri-1`–`ri-9` on an informational target (c1-t11/t9/t8/t10), plus the `l-4` / `l-5` families on c1-t10. (`rl-2` is the theme standard — valid; there is no `rl-8`.)
|
|
377
|
+
- `dok`: `r-dok1`, `r-dok2`, `r-dok3` (R&E items are `r-dok3`; T2/T9 selected-response is `r-dok2`, the written response `r-dok3`; T1, T8 & T10 are `r-dok2`)
|
|
283
378
|
|
|
284
379
|
## What composition does
|
|
285
380
|
|
|
@@ -292,6 +387,10 @@ It never generates content or stems — author them.
|
|
|
292
387
|
|
|
293
388
|
## Example (Target 4, literary)
|
|
294
389
|
|
|
390
|
+
Balance the option lengths — a correct answer noticeably longer than the foils is findable without
|
|
391
|
+
reading (the compiler warns past 1.35×). For EBSR, author at least **5** non-supporting evidence
|
|
392
|
+
lines so Part B has real foils to choose from.
|
|
393
|
+
|
|
295
394
|
```
|
|
296
395
|
target c1-t4
|
|
297
396
|
passage "The Tide Pool"
|
|
@@ -299,39 +398,263 @@ type literary
|
|
|
299
398
|
/* lines are PARAGRAPHS, auto-numbered 1..N; EBSR Part B sources `quote` the exact sentence */
|
|
300
399
|
lines [
|
|
301
400
|
"Mara crouched at the edge of the tide pool, ignoring the picnic behind her. Her brother called twice, but she did not turn around. A tiny crab scuttled under a rock, and Mara smiled for the first time all day."
|
|
302
|
-
"She traced the cold water as if the pool were the only thing that mattered. Behind her, paper plates rustled and her mother laughed."
|
|
401
|
+
"She traced the cold water as if the pool were the only thing that mattered. Behind her, paper plates rustled and her mother laughed. Someone asked whether she wanted a sandwich, and she said nothing at all."
|
|
402
|
+
"Her brother stacked a small tower of stones near the blanket. The tide crept in and filled the pool to its rim. Only when her father folded the last chair did Mara stand up. She looked back at the water twice on the walk to the car."
|
|
303
403
|
]
|
|
304
404
|
claims [
|
|
305
405
|
claim id "c1" status supported dimension character subject "Mara"
|
|
306
|
-
text "Mara
|
|
307
|
-
cites ["e1" "e3"] {}
|
|
406
|
+
text "Mara cares more about the tide pool than about the picnic."
|
|
407
|
+
cites ["e1" "e3" "e4"] {}
|
|
308
408
|
/* at least 5 viable distractors targeting q1; the item draws 3 (one per error type) */
|
|
309
409
|
claim id "c2" status distractor error-type misreads-detail plausibility 0.85 targets ["q1"]
|
|
310
|
-
text "Mara is angry at her brother."
|
|
410
|
+
text "Mara is angry at her brother for calling her twice."
|
|
311
411
|
rationale "Not turning around shows absorption, not anger." cites ["e2"] {}
|
|
312
412
|
claim id "c3" status distractor error-type misreads-detail plausibility 0.6 targets ["q1"]
|
|
313
|
-
text "Mara is bored and wants to
|
|
413
|
+
text "Mara is bored by the pool and wants to go home."
|
|
314
414
|
rationale "Her stillness is focus, not boredom (the crab makes her smile)." cites ["e2"] {}
|
|
315
415
|
claim id "c4" status distractor error-type erroneous-inference plausibility 0.55 targets ["q1"]
|
|
316
|
-
text "Mara
|
|
416
|
+
text "Mara would rather be indoors than out at the beach."
|
|
317
417
|
rationale "Over-generalizes from her quiet to a dislike the text contradicts." cites ["e3"] {}
|
|
318
418
|
claim id "c5" status distractor error-type erroneous-inference plausibility 0.5 targets ["q1"]
|
|
319
|
-
text "Mara is waiting for her brother to
|
|
419
|
+
text "Mara is waiting for her brother to come look with her."
|
|
320
420
|
rationale "Invents a goal the passage never states." cites ["e2"] {}
|
|
321
421
|
claim id "c6" status distractor error-type faulty-reasoning plausibility 0.45 targets ["q1"]
|
|
322
|
-
text "
|
|
422
|
+
text "Mara is quiet, so something must have upset her."
|
|
323
423
|
rationale "Treats quiet as upset without textual support." cites ["e2"] {}
|
|
324
424
|
]
|
|
325
425
|
evidence [
|
|
326
426
|
/* `line` = the paragraph; `quote` = the exact supporting sentence shown as the Part B option */
|
|
327
427
|
source id "e1" line 1 quote "Mara crouched at the edge of the tide pool, ignoring the picnic behind her." status directly-supports supports ["c1"] {}
|
|
328
|
-
source id "e2" line 1 quote "Her brother called twice, but she did not turn around." status supports-wrong-claim supports ["c1" "c2"] {}
|
|
329
428
|
source id "e3" line 1 quote "A tiny crab scuttled under a rock, and Mara smiled for the first time all day." status directly-supports supports ["c1"] {}
|
|
429
|
+
source id "e4" line 2 quote "She traced the cold water as if the pool were the only thing that mattered." status directly-supports supports ["c1"] {}
|
|
430
|
+
source id "e8" line 3 quote "She looked back at the water twice on the walk to the car." status directly-supports supports ["c1"] {}
|
|
431
|
+
/* NO-GIVEAWAY: at least one supports-wrong-claim line lists BOTH the correct claim and a
|
|
432
|
+
distractor, so Part B does not telegraph Part A */
|
|
433
|
+
source id "e2" line 1 quote "Her brother called twice, but she did not turn around." status supports-wrong-claim supports ["c1" "c2"] {}
|
|
434
|
+
source id "e5" line 2 quote "Someone asked whether she wanted a sandwich, and she said nothing at all." status supports-wrong-claim supports ["c1" "c6"] {}
|
|
435
|
+
source id "e6" line 2 quote "Behind her, paper plates rustled and her mother laughed." status irrelevant supports [] {}
|
|
436
|
+
source id "e7" line 3 quote "Her brother stacked a small tower of stones near the blanket." status irrelevant supports [] {}
|
|
437
|
+
source id "e9" line 3 quote "The tide crept in and filled the pool to its rim." status irrelevant supports [] {}
|
|
330
438
|
]
|
|
331
439
|
outcomes [
|
|
332
|
-
outcome id "q1" type ebsr dimension character subject "Mara" standard rl-1 focus "c1"
|
|
440
|
+
outcome id "q1" type ebsr task-model tm1 dimension character subject "Mara" standard rl-1 focus "c1"
|
|
333
441
|
stem "Which of these inferences about Mara is supported by the passage?"
|
|
334
442
|
stem-b "Which sentence(s) from the passage best support your answer in Part A?" {}
|
|
335
443
|
]
|
|
336
444
|
{}..
|
|
337
445
|
```
|
|
446
|
+
|
|
447
|
+
(For **Target 11**, the same R&E shape over an *informational* passage: `target c1-t11`,
|
|
448
|
+
`type informational`, an RI dimension like `relationships-interactions`, `standard ri-1` + `ri-3`,
|
|
449
|
+
and the T11 stems from `stems.md`.)
|
|
450
|
+
|
|
451
|
+
## Example (Target 2 — Central Ideas, **literary**, theme)
|
|
452
|
+
|
|
453
|
+
Same shape as Target 9 over a story. The T2 differences: **`theme`** is the dimension of choice and
|
|
454
|
+
the correct answer reads as a *lesson*, not a plot event; every dimension answers to `rl-2`, so
|
|
455
|
+
`standards` composes to `["rl-1", "rl-2"]`. A `summary` item on T2 must be scoped to a section or
|
|
456
|
+
key event — never the whole text. Keep the four options about the same length.
|
|
457
|
+
|
|
458
|
+
```
|
|
459
|
+
target c1-t2
|
|
460
|
+
passage "The Blue Ribbon"
|
|
461
|
+
type literary
|
|
462
|
+
lines [
|
|
463
|
+
"Every spring, Tessa entered her drawing in the county fair."
|
|
464
|
+
"This year she almost did not enter at all."
|
|
465
|
+
"Tessa drew the same barn eleven times before she kept one."
|
|
466
|
+
"At the fair, the blue ribbon went to somebody else."
|
|
467
|
+
"Then a teacher asked to hang Tessa's drawing in the hall."
|
|
468
|
+
]
|
|
469
|
+
claims [
|
|
470
|
+
claim id "c1" status supported dimension theme subject "Tessa"
|
|
471
|
+
text "Keeping at something can matter more than winning."
|
|
472
|
+
cites ["e3" "e5"] {}
|
|
473
|
+
/* T2 distractors are the SIGNIFICANCE taxonomy — usually true, just not the theme.
|
|
474
|
+
Keep `insignificant` foils plausible: too trivial and no student would pick them. */
|
|
475
|
+
claim id "d1" status distractor error-type too-narrow targets ["q1"]
|
|
476
|
+
text "Tessa entered the county fair every single spring."
|
|
477
|
+
rationale "A true detail from the opening, not the story's theme." cites ["e1"] {}
|
|
478
|
+
claim id "d2" status distractor error-type too-broad targets ["q1"]
|
|
479
|
+
text "Hard work always makes a person famous someday."
|
|
480
|
+
rationale "Overgeneralizes far past what the story shows." cites ["e5"] {}
|
|
481
|
+
claim id "d3" status distractor error-type misreads-detail targets ["q1"]
|
|
482
|
+
text "Tessa gave up drawing after she lost again."
|
|
483
|
+
rationale "Misreads the ending; she keeps drawing and is lifted by it." cites ["e2"] {}
|
|
484
|
+
claim id "d4" status distractor error-type insignificant targets ["q1"]
|
|
485
|
+
text "Tessa's grandmother owned more than one pencil."
|
|
486
|
+
rationale "True but far too minor to be the theme." cites ["e1"] {}
|
|
487
|
+
claim id "d5" status distractor error-type too-narrow targets ["q1"]
|
|
488
|
+
text "Tessa drew a barn instead of drawing a house."
|
|
489
|
+
rationale "A single detail of the drawing, not what the story means." cites ["e3"] {}
|
|
490
|
+
]
|
|
491
|
+
evidence [
|
|
492
|
+
source id "e3" line 3 status directly-supports supports ["c1"] quote "Tessa drew the same barn eleven times before she kept one." {}
|
|
493
|
+
source id "e5" line 5 status directly-supports supports ["c1"] quote "Then a teacher asked to hang Tessa's drawing in the hall." {}
|
|
494
|
+
source id "e1" line 1 status supports-wrong-claim supports ["c1" "d1"] quote "Every spring, Tessa entered her drawing in the county fair." {}
|
|
495
|
+
source id "e2" line 2 status supports-wrong-claim supports ["c1" "d3"] quote "This year she almost did not enter at all." {}
|
|
496
|
+
source id "e4" line 4 status irrelevant supports [] quote "At the fair, the blue ribbon went to somebody else." {}
|
|
497
|
+
]
|
|
498
|
+
outcomes [
|
|
499
|
+
outcome id "q1" type multiple-choice task-model tm1 dimension theme subject "Tessa" focus "c1"
|
|
500
|
+
stem "Which sentence best tells the theme of the passage?" {}
|
|
501
|
+
]
|
|
502
|
+
{}..
|
|
503
|
+
```
|
|
504
|
+
|
|
505
|
+
## Example (Target 9 — Central Ideas, multiple-choice)
|
|
506
|
+
|
|
507
|
+
The OPTIONS are still `claim`s, but the skill is the **main idea** (not infer-and-justify) and the
|
|
508
|
+
distractors are the **significance** taxonomy — usually true statements that just aren't central.
|
|
509
|
+
DOK is `r-dok2`; the standards are `ri-1` + `ri-2`. (No EBSR Part B here; on T9 EBSR/Hot-Text the
|
|
510
|
+
correct claim's `directly-supports` sources are the supporting selection.)
|
|
511
|
+
Keep the four options about the same length — a longer correct answer is a giveaway.
|
|
512
|
+
|
|
513
|
+
```
|
|
514
|
+
target c1-t9
|
|
515
|
+
passage "Honeybees"
|
|
516
|
+
type informational
|
|
517
|
+
lines [
|
|
518
|
+
"Honeybees live together in large groups called colonies. Worker bees gather nectar and build the hive. The queen bee lays all the eggs. By working together, the colony survives and grows."
|
|
519
|
+
]
|
|
520
|
+
claims [
|
|
521
|
+
claim id "c1" status supported dimension central-idea subject "the colony" standard ri-2
|
|
522
|
+
text "Honeybees survive because each bee does a job for the colony."
|
|
523
|
+
cites ["e1"] {}
|
|
524
|
+
/* T9 distractors are usually TRUE statements that simply aren't the central idea */
|
|
525
|
+
claim id "d1" status distractor error-type too-narrow targets ["q1"]
|
|
526
|
+
text "The queen bee lays all of the eggs for the colony."
|
|
527
|
+
rationale "A true supporting detail, not the central idea." cites ["e1"] {}
|
|
528
|
+
claim id "d2" status distractor error-type too-broad targets ["q1"]
|
|
529
|
+
text "Insects are the most important animals on the planet."
|
|
530
|
+
rationale "An overgeneralization beyond the passage." cites ["e1"] {}
|
|
531
|
+
claim id "d3" status distractor error-type misreads-detail targets ["q1"]
|
|
532
|
+
text "Each bee in the colony does every job by itself."
|
|
533
|
+
rationale "Misreads the division of labor." cites ["e1"] {}
|
|
534
|
+
]
|
|
535
|
+
evidence [ source id "e1" line 1 status directly-supports supports ["c1"] {} ]
|
|
536
|
+
outcomes [
|
|
537
|
+
outcome id "q1" type multiple-choice task-model tm1 dimension central-idea subject "the colony" standard ri-2 focus "c1"
|
|
538
|
+
stem "Which sentence best shows the main idea of the passage?" {}
|
|
539
|
+
]
|
|
540
|
+
{}..
|
|
541
|
+
```
|
|
542
|
+
|
|
543
|
+
## Example (Target 1 — Key Details, **literary**, evidence selection)
|
|
544
|
+
|
|
545
|
+
Same model as Target 8 over a story: the inference is **GIVEN in the stem** and the OPTIONS are
|
|
546
|
+
passage `source`s. The T1 difference is the standard — **`rl-1` alone**, so omit `standard` and let
|
|
547
|
+
the dimension resolve it. DOK `r-dok2`.
|
|
548
|
+
|
|
549
|
+
```
|
|
550
|
+
target c1-t1
|
|
551
|
+
passage "The Loose Board"
|
|
552
|
+
type literary
|
|
553
|
+
lines [
|
|
554
|
+
"Nina had walked past Mr. Ruiz's crooked porch a hundred times. The third board rocked under her feet every time she crossed it. On Saturday she stopped, because someone had left a hammer on the step. She looked up and down the empty street. Then she knelt down and set the first nail without anyone asking her to. Her arm ached by the fourth nail, but she did not quit. Mr. Ruiz never learned who had fixed his porch."
|
|
555
|
+
]
|
|
556
|
+
claims [
|
|
557
|
+
claim id "c1" status supported dimension supporting-evidence subject "Nina"
|
|
558
|
+
text "Nina takes care of a problem on her own, without being told to." cites ["e1" "e2"] {}
|
|
559
|
+
]
|
|
560
|
+
evidence [
|
|
561
|
+
source id "e1" line 1 quote "Then she knelt down and set the first nail without anyone asking her to." status directly-supports supports ["c1"] {}
|
|
562
|
+
source id "e2" line 1 quote "Mr. Ruiz never learned who had fixed his porch." status directly-supports supports ["c1"] {}
|
|
563
|
+
source id "e3" line 1 quote "The third board rocked under her feet every time she crossed it." status irrelevant supports [] rationale "Describes the problem, not Nina's choice to act." {}
|
|
564
|
+
source id "e4" line 1 quote "On Saturday she stopped, because someone had left a hammer on the step." status irrelevant supports [] rationale "Invites the erroneous inference that she helped only because a tool was there." {}
|
|
565
|
+
source id "e5" line 1 quote "Nina had walked past Mr. Ruiz's crooked porch a hundred times." status irrelevant supports [] rationale "Tells how often she passed, not that she acted on her own." {}
|
|
566
|
+
source id "e6" line 1 quote "She looked up and down the empty street." status irrelevant supports [] rationale "Sets the scene; shows no action Nina took." {}
|
|
567
|
+
source id "e7" line 1 quote "Her arm ached by the fourth nail, but she did not quit." status irrelevant supports [] rationale "Shows persistence once she had started, not that she started unasked." {}
|
|
568
|
+
]
|
|
569
|
+
outcomes [
|
|
570
|
+
outcome id "q1" type multiple-choice task-model tm1 dimension supporting-evidence subject "Nina" focus "c1"
|
|
571
|
+
stem "The reader can conclude that Nina takes care of a problem on her own, without being told to. Which line from the passage best supports this conclusion?" {}
|
|
572
|
+
]
|
|
573
|
+
{}..
|
|
574
|
+
```
|
|
575
|
+
|
|
576
|
+
## Example (Target 8 — Key Details, evidence selection)
|
|
577
|
+
|
|
578
|
+
The inference is **GIVEN in the stem**; the OPTIONS are passage `source`s, not claims. Author ONE
|
|
579
|
+
supported `claim` (the given inference, named by `focus`), state it in the `stem`, and author the
|
|
580
|
+
`source`s as the choices: `directly-supports` = correct evidence (give each a `quote`),
|
|
581
|
+
`irrelevant`/`supports-wrong-claim` = foils (give each a `rationale`). **No distractor claims.**
|
|
582
|
+
Standards `ri-1` + `ri-7`, DOK `r-dok2`.
|
|
583
|
+
|
|
584
|
+
**Keep the conclusion a real inference, not a paraphrase of one sentence.** The stem states the
|
|
585
|
+
conclusion and the key is the evidence for it, so if the conclusion just restates the correct
|
|
586
|
+
source, the option that echoes the stem gives itself away (the compiler warns). Pitch the claim one
|
|
587
|
+
step above the text — here, *careful planning*, which no single sentence says outright — and author
|
|
588
|
+
at least **5** non-supporting sources so the best foils can be chosen.
|
|
589
|
+
|
|
590
|
+
```
|
|
591
|
+
target c1-t8
|
|
592
|
+
passage "Aqueducts"
|
|
593
|
+
type informational
|
|
594
|
+
lines [
|
|
595
|
+
"Rome needed more fresh water than its wells could give. Workers built long channels called aqueducts to carry water to the city. They tilted each channel down just a little, so the water moved on its own. Where the land dropped away, they raised the channel on tall stone arches. Some aqueducts started at springs sixty miles from the city. Crews walked the channels often and cleaned out leaves and mud. People in Rome filled their jugs at open fountains."
|
|
596
|
+
]
|
|
597
|
+
claims [
|
|
598
|
+
claim id "c1" status supported dimension supporting-evidence subject "the aqueducts"
|
|
599
|
+
text "Roman engineers planned the aqueducts carefully." cites ["e1" "e2"] {}
|
|
600
|
+
]
|
|
601
|
+
evidence [
|
|
602
|
+
source id "e1" line 1 quote "They tilted each channel down just a little, so the water moved on its own." status directly-supports supports ["c1"] {}
|
|
603
|
+
source id "e2" line 1 quote "Where the land dropped away, they raised the channel on tall stone arches." status directly-supports supports ["c1"] {}
|
|
604
|
+
source id "e3" line 1 quote "Rome needed more fresh water than its wells could give." status irrelevant supports [] rationale "Gives the reason for building, not evidence that the building was planned with care." {}
|
|
605
|
+
source id "e4" line 1 quote "Workers built long channels called aqueducts to carry water to the city." status irrelevant supports [] rationale "Says what was built; a student may read any construction detail as proof of planning." {}
|
|
606
|
+
source id "e5" line 1 quote "Some aqueducts started at springs sixty miles from the city." status irrelevant supports [] rationale "A fact about scale — impressive, but it shows distance rather than design choices." {}
|
|
607
|
+
source id "e6" line 1 quote "Crews walked the channels often and cleaned out leaves and mud." status irrelevant supports [] rationale "Describes upkeep after the aqueducts were finished, not the planning behind them." {}
|
|
608
|
+
source id "e7" line 1 quote "People in Rome filled their jugs at open fountains." status irrelevant supports [] rationale "Describes how people used the water; unrelated to how the system was designed." {}
|
|
609
|
+
]
|
|
610
|
+
outcomes [
|
|
611
|
+
outcome id "q1" type multiple-choice task-model tm1 dimension supporting-evidence subject "the aqueducts" standard ri-7 focus "c1"
|
|
612
|
+
stem "The reader can conclude that Roman engineers planned the aqueducts carefully. Which detail from the passage best supports this conclusion?" {}
|
|
613
|
+
]
|
|
614
|
+
{}..
|
|
615
|
+
```
|
|
616
|
+
|
|
617
|
+
## Example (Target 10 — Word Meanings)
|
|
618
|
+
|
|
619
|
+
The OPTIONS are **meanings** of a targeted `word`, authored in a top-level `words` list — not
|
|
620
|
+
claims. One `status correct` meaning + `status distractor` meanings (each a T10 `error-type` +
|
|
621
|
+
`rationale`). The outcome's `focus` names the `word`; state the word + its sentence in the `stem`.
|
|
622
|
+
Standard `ri-4` + an L-4 strategy code, DOK `r-dok2`.
|
|
623
|
+
|
|
624
|
+
```
|
|
625
|
+
target c1-t10
|
|
626
|
+
passage "Aqueducts"
|
|
627
|
+
type informational
|
|
628
|
+
lines [
|
|
629
|
+
"Roman engineers built aqueducts. The aqueduct carried water across long distances."
|
|
630
|
+
]
|
|
631
|
+
words [
|
|
632
|
+
word id "w1" text "aqueduct" line 1 quote "The aqueduct carried water across long distances."
|
|
633
|
+
meanings [
|
|
634
|
+
meaning id "m1" status correct text "a channel that carries water" {}
|
|
635
|
+
meaning id "m2" status distractor error-type other-meaning text "a boat that carries cargo"
|
|
636
|
+
rationale "Another meaning that ignores the context." {}
|
|
637
|
+
meaning id "m3" status distractor error-type misinterprets text "a tall tower made of stone"
|
|
638
|
+
rationale "Misreads the sentence." {}
|
|
639
|
+
meaning id "m4" status distractor error-type wrong-context text "a road that crosses a valley"
|
|
640
|
+
rationale "Uses the wrong context." {}
|
|
641
|
+
] {}
|
|
642
|
+
]
|
|
643
|
+
outcomes [
|
|
644
|
+
outcome id "q1" type multiple-choice task-model tm1 dimension word-meaning subject "aqueduct" standard l-4a focus "w1"
|
|
645
|
+
stem "Read the sentence: \"The aqueduct carried water across long distances.\" What does the word aqueduct most likely mean?" {}
|
|
646
|
+
]
|
|
647
|
+
{}..
|
|
648
|
+
```
|
|
649
|
+
|
|
650
|
+
For a **click-the-word** (`hot-text`) T10 item, drop the `meanings` and instead list the clickable
|
|
651
|
+
candidates as bare `word`s in the same paragraph — the correct one is the outcome's `focus`, the
|
|
652
|
+
rest are distractor candidate words; put only the instruction + definition in the `stem`:
|
|
653
|
+
|
|
654
|
+
```
|
|
655
|
+
words [ word id "w1" text "aqueduct" line 1 {} word id "w2" text "engineers" {} word id "w3" text "water" {} ]
|
|
656
|
+
outcomes [
|
|
657
|
+
outcome id "q1" type hot-text dimension word-meaning subject "aqueduct" standard l-4c focus "w1"
|
|
658
|
+
stem "Read the paragraph below. Click the word that means a channel that carries water." {}
|
|
659
|
+
]
|
|
660
|
+
```
|
package/spec/language-info.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
|
-
"revised": "2026-
|
|
2
|
+
"revised": "2026-08-28",
|
|
3
3
|
"id": "0175",
|
|
4
|
-
"description": "Composes 5th-grade English Language Arts assessment items (Smarter Balanced · Grade 5 · Claim 1) for multiple learning targets — DIFFERENT reading skills: c1-t4 (Reasoning & Evidence, literary, RL) and c1-t11 (Reasoning & Evidence, informational, RI) ask students to infer/conclude and justify with evidence; c1-t9 (Central Ideas, informational, RI-1/RI-2) asks them to determine the main idea, the key details that build it, or summarize; c1-t8 (Key Details, informational, RI-1/RI-7)
|
|
4
|
+
"description": "Composes 5th-grade English Language Arts assessment items (Smarter Balanced · Grade 5 · Claim 1) for multiple learning targets — DIFFERENT reading skills: c1-t4 (Reasoning & Evidence, literary, RL) and c1-t11 (Reasoning & Evidence, informational, RI) ask students to infer/conclude and justify with evidence; c1-t9 (Central Ideas, informational, RI-1/RI-2) asks them to determine the main idea, the key details that build it, or summarize, and c1-t2 (Central Ideas, LITERARY, RL-1/RL-2) does the same for a story — but there THEME leads (the correct answer is a lesson or message, not a plot event) and a summary must be scoped to a section or key event, never the whole text; c1-t1 (Key Details, LITERARY, RL-1 alone) and c1-t8 (Key Details, informational, RI-1/RI-7) GIVE the inference in the stem and ask them to select the supporting evidence (the options are passage sources, not statements; item types multiple-choice/multi-select/single-part-hot-text) — pick c1-t1 for a story, c1-t8 for an article; c1-t10 (Word Meanings, informational, RI-4/L-4) asks for the meaning of a targeted word/phrase in context (the options are MEANINGS, authored as a `word` with candidate `meaning`s — not claims; item types multiple-choice/multi-select, plus a click-the-word hot-text — for that, author the candidate `word`s as a top-level `words` list: the correct one is the outcome's `focus` (give it the `line` of its paragraph) and the others are distractor candidate words; ALL candidates must be words that appear in that one paragraph (they need only `text` — no `meanings`). The compiler shows the whole paragraph and makes the authored candidate words clickable, with the focus word correct (if you author only the correct word, every content word in the paragraph becomes a choice). The `stem` is only the instruction + the definition (e.g. 'Read the paragraph below. Click the word that means …') — never paste the paragraph into the stem). Every program declares a top-level `target` selecting the dimension/standard/error-type/DOK/stem vocabulary. Item-first: a program authors the questions (outcomes) first — each with a unique id, a focus correct claim (a list on multi-select), and a stem from the target's guideline catalog — then supported and distractor claims (each distractor targets the question(s) it foils) and evidence sources for one passage. Item types: ebsr (two-part), hot-text, short-text, multiple-choice (one correct), multi-select (exact correct set); the allowed set is per-target. Task-model NUMBERS are per-target and collide (tm3 = short-text in c1-t4/c1-t11, ebsr in c1-t2/c1-t9, hot-text in c1-t1/c1-t8/c1-t10), so name the item type, or resolve a number against the program's target — never assume the Reasoning & Evidence numbering carries to the other targets (see the per-target task-model table in the usage guide). T2/T9 distractors are a significance taxonomy (too-narrow/too-broad/misreads-detail/insignificant) — usually true statements that just aren't central — vs R&E's reasoning-error taxonomy. Supply the passage text already split into paragraphs (keep the paragraph breaks). The compiler takes each outcome's focus and the foils that target it and assembles the item; it selects and validates authored content, it does not generate content or stems. Author the passage and all question text at the target reading level (Grade 5; overridable with a top-level `grade <n>`); the compiler estimates the passage's reading level and warns when it runs above the target grade.",
|
|
5
5
|
"supported_item_types": ["ebsr", "hot-text", "short-text", "multiple-choice", "multi-select"],
|
|
6
6
|
"example_prompts": [
|
|
7
7
|
{
|
|
@@ -59,11 +59,26 @@
|
|
|
59
59
|
"produces": "multi-select",
|
|
60
60
|
"notes": "target c1-t9, type multi-select, dimension summary. `focus` is a LIST of the two correct claims; the compiler emits 5-6 options and the student must select exactly the correct set."
|
|
61
61
|
},
|
|
62
|
+
{
|
|
63
|
+
"prompt": "What is the theme of this story? Make it a two-part item where Part B asks for the sentence that supports it.",
|
|
64
|
+
"produces": "ebsr",
|
|
65
|
+
"notes": "Theme over a LITERARY passage: target c1-t2, type ebsr (task model 3 -- NOT short-text as in c1-t4/c1-t11), dimension theme, standards rl-1+rl-2. Phrase the correct claim as a lesson or message, not a plot event. Distractors are the significance taxonomy (too-narrow/too-broad/misreads-detail/insignificant). No-giveaway: author at least one supports-wrong-claim source listing BOTH the correct claim and a distractor, so Part B does not telegraph Part A."
|
|
66
|
+
},
|
|
67
|
+
{
|
|
68
|
+
"prompt": "Have students summarize what happens after the storm in this story, using details from the text.",
|
|
69
|
+
"produces": "short-text",
|
|
70
|
+
"notes": "target c1-t2, type short-text (task model 5), dimension summary, standards rl-1+rl-2, DOK r-dok3. T2 summaries are SCOPED -- the guideline forbids asking students to summarize the entire text, so the stem must name a section or key event. A plain 'summarize the passage' prompt belongs to c1-t9, not c1-t2."
|
|
71
|
+
},
|
|
62
72
|
{
|
|
63
73
|
"prompt": "The article concludes that aqueducts let distant cities get fresh water — make a multiple-choice item asking which detail best supports that conclusion.",
|
|
64
74
|
"produces": "multiple-choice",
|
|
65
75
|
"notes": "Given inference -> evidence selection: target c1-t8, type multiple-choice, dimension supporting-evidence, standards ri-1+ri-7. Author ONE supported claim (the conclusion) at `focus` and state it in the stem; the OPTIONS are sources -- the directly-supports source is correct, supports-wrong-claim/irrelevant sources are foils. No distractor claims."
|
|
66
76
|
},
|
|
77
|
+
{
|
|
78
|
+
"prompt": "In this story, the reader can conclude that Nell regrets what she said — make a multiple-choice item asking which line from the story best supports that conclusion.",
|
|
79
|
+
"produces": "multiple-choice",
|
|
80
|
+
"notes": "Given inference -> evidence selection over a LITERARY passage: target c1-t1, type multiple-choice, dimension supporting-evidence. Same model as c1-t8, but the standard is rl-1 ALONE (the guideline names no companion), so omit `standard` on the outcome. Author ONE supported claim (the conclusion) at `focus` and state it in the stem; the OPTIONS are sources -- the directly-supports source is correct, irrelevant/supports-wrong-claim sources are foils. No distractor claims."
|
|
81
|
+
},
|
|
67
82
|
{
|
|
68
83
|
"prompt": "What does the word 'aqueduct' most likely mean as it is used in the article? (multiple choice)",
|
|
69
84
|
"produces": "multiple-choice",
|
|
@@ -72,7 +87,7 @@
|
|
|
72
87
|
{
|
|
73
88
|
"prompt": "Make a click-the-word item: in the paragraph about the city's water supply, the target word is 'aqueduct' (it means a system of pipes/canals that carries water). Stem: 'Read the paragraph below. Click the word that means a system of pipes or canals that carries water.'",
|
|
74
89
|
"produces": "hot-text",
|
|
75
|
-
"notes": "T10 Task Model 3
|
|
90
|
+
"notes": "T10's click-the-word hot-text (its Task Model 3 — task-model numbers are per-target, so this 3 is specific to c1-t10 and is NOT the same item type as tm3 in other targets): target c1-t10, type hot-text, dimension word-meaning, standard ri-4 + l-4a. Author the focus `word` (e.g. { id \"w1\" text \"aqueduct\" line <paragraph #> }) as the outcome's `focus`, then the DISTRACTOR CANDIDATE WORDS either way: (a) as more single-word `word`s in the `words` list, OR (b) as the focus word's distractor `meanings` whose `text` IS the candidate word — a single word, with error-type + rationale (e.g. text \"causeways\", text \"canals\"). For hot-text the meaning text must be the literal word to click, NOT a definition. ALL candidates must be words that appear in the focus word's paragraph. The compiler shows the whole paragraph (from the focus word's `line`) and makes the candidate words clickable, focus correct. Do NOT put the paragraph in the stem; the stem is only the instruction + definition. (If you author only the focus word with a real multi-word definition, the compiler can't find candidates and falls back to making EVERY content word clickable — avoid that by listing the candidate words.)"
|
|
76
91
|
}
|
|
77
92
|
]
|
|
78
93
|
}
|