Как составлять уроки и темы

Арка урока, полнота материала, дробление темы на концепты, глубина по возрасту.

Как составлять уроки и темы

Педагогический слой между структурой контента (frontmatter, иерархия) и вопросами. Опирается на мета-навыки.

Здесь — правила про материал (что и как объяснять, на сколько концептов бить тему). Про вопросы — в разделе «Как формулировать вопросы».

1. Три железных правила

Один концепт = одна идея. От 5 до 20 минут, 3-5 learning_objectives, все служат одной теме. Не помещается, значит это трек, а не концепт.
Полный материал. Концепт сам обучает всему, что проверяет. Ученик с заявленными пререквизитами (connections.before) проходит концепт «с нуля», не зная темы заранее. Никаких «2 предложения на подтему».
Длинную тему — дробить. Если тема не влезает в одну идею / 20 минут / ~9 новых терминов — разбей на несколько концептов, свяжи connections и собери в трек. Даже если это «одна тема».

2. Анатомия концепта (арка урока)

Каждый концепт идёт по дуге, ритмом «порция материала → проверка»:

Этап	Что	Атомы
Hook	зацепка: факт, вопрос, история — зачем это	проза, `callout`, `hook`
Explain	материал порциями, термин определён при появлении	проза, `definition`, `reveal`, `callout`
Practice	проверка после каждой порции	атомы с выбором (см. QUESTION-DESIGN §2.1)
Synthesize	свести вместе, поднять высоту (analyze/evaluate)	`compare-contrast`, `sorting`, `text-select`

Правило ритма: материал → проверка → материал, а не стена текста и тест в конце. Материал по объёму доминирует над вопросами.

2.1 Богатый концепт: используй ВСЮ палитру, не только текст + quiz

Плоский index.md (абзац → quiz → абзац) — это бедно. Концепт — page bundle, и у него есть виды-компаньоны и богатая подача (полная механика — docs/CONTENT.md → «Богатый концепт»). Хороший концепт использует:

Погружение и контекст — callout (tip/insight/warning), цитаты-blockquote из источников, «представь, что…», конкретные детали и истории, а не сухая справка. Это даёт глубину, которой не хватает скелету.
content_graph в frontmatter → Mind-map темы (вид 🗺️). Заполняй его всегда — карта структурирует тему и развивает аналитическое мышление.
Вид «Практика» ({id}-practice/) — отдельный блок закрепления: flashcard (SRS) + быстрые quiz. Память отрабатывается тут, чтобы урок не превращался в тест.
Вид «Симуляция» ({id}-scenario/ + scenario.yaml) — для тем с выбором/последствиями: ветвящееся погружение (например «Совет племён»). Кульминация уровня create.
Определения (definition), раскрытие (reveal «подумай → открой»).

Правило полноты подачи: концепт должен учить и увлекать, а не только проверять. Если в нём только текст и quiz — он недоделан. Минимум для богатого концепта: насыщенный нарратив + content_graph(mind-map) + хотя бы один из видов (практика/симуляция). Тему дроби на концепты (§3), но каждый концепт делай полным.

3. Когда дробить концепт — чёткие пороги

Разбей на несколько концептов (→ трек), если выполняется хотя бы одно:

⏱️ больше 20 минут чтения + практики;
🎯 больше 5 learning_objectives;
🧠 больше ~9 новых терминов/понятий;
🧩 покрывает больше одной самостоятельной идеи (война и реформы и культура…);
📉 на отдельную цель приходится меньше абзаца материала — значит тема шире концепта.

Если ни одно не сработало — это один концепт.

4. Как дробить тему в трек (декомпозиция)

Процедура из 5 шагов:

Выпиши умения. Что ученик должен уметь после ВСЕЙ темы (обычно 5–15 пунктов).
Сгруппируй умения в кластеры по 2–4 — каждый кластер = один концепт с одной идеей.
Упорядочь концепты: хронология / простое→сложное / конкретное→абстрактное. Зависимости — через connections.before.
Заведи трек (data/tracks/{id}.yaml + content/tracks/{id}.md), перечисли концепты в concepts:.
Заложи spacing. В поздних концептах возвращай факты из ранних (проверкой или сравнением) — это desirable difficulty, усиливает запоминание (META-SKILLS [S4]).

Трек — при 3+ концептах (меньше — не нужен). mode: sequential если есть строгие пререквизиты, free если порядок свободный.

5. Полнота материала (главное правило «полный материал»)

Концепт полон, если:

✅ Каждый learning_objective имеет и объясняющий материал, и проверку.
✅ Каждый проверяемый факт/термин введён в тексте ДО проверки (QUESTION-DESIGN §5.0).
✅ Новый термин определён при первом появлении (definition или в прозе).
✅ Есть конкретные примеры, а не только определения.
✅ Ученик «с нуля» (зная лишь пререквизиты) может ответить на все вопросы из материала самого концепта.

Если умение раскрыто одним предложением — углубляй материал ИЛИ выноси в отдельный концепт. Поверхностно «по верхам всей темы» — запрещено.

Якоря объёма (иначе «материал доминирует» меряется в символах и проходит при 330 словах на 7 вопросов):

300 слов ≈ 1,5 минуты чтения; duration = чтение + ~1 минута на атом — посчитай, а не ставь «на глаз».
Меньше 700 слов материала на 15-минутный концепт, значит концепт недоделан: углубляй или честно снижай duration. 700 это пол, который проверяет гейт.
Callout, подсказывающий следующий же вопрос, — не материал. Материал учит новому.

Подробнее — Планка строгости §7.

6. Когнитивная нагрузка (чтобы не перегрузить)

≤ 5–9 новых терминов на концепт.
Определяй термин до использования.
Конкретное → абстрактное, пример → правило.
Одно представление идеи за раз (не вали схему, текст и таблицу разом).
Материал порциями с проверками, а не сплошным полотном.

7. Глубина по полосе (Ю / С / В)

Одна тема — разная глубина и арка (полосы из META-SKILLS):

Полоса	Глубина материала	Акцент
Ю 11–13	больше конкретики, историй, примеров; меньше абстракций за раз	фундамент, узнавание
С 14–17	можно причинно-следственные связи, противоречия, оценку	анализ + оценка
В учителя	сжатый предметный слой + методический: «как это дать классу»	применение к практике (андрагогика)

8. Трек: правила уровня темы

3+ концепта, каждый — одна идея, полный материал.
Порядок и пререквизиты через connections.
Spacing/interleaving: поздние концепты возвращают ранние факты.
Арка трека: от «зачем» (контекст) → «как» (механизмы) → «оценка/синтез» (критическое мышление). Мета-навыковую кульминацию — ближе к концу, на уже освоенном материале.

9. Пример: «Пётр I» — как надо

Запрос «урок по правлению Петра I» — это тема, значит трек, а не один концепт. Декомпозиция:

Трек «Эпоха Петра I» (mode: sequential):

#	Концепт	Одна идея	Высота
1	`peter-why-sea`	Зачем Петру море: отставание и предпосылки реформ	understand
2	`peter-northern-war`	Северная война: как добывали Балтику	recall/analyze
3	`peter-state-reforms`	Реформы управления и армии: Сенат, коллегии, рекруты	analyze
4	`peter-culture`	Культурный переворот: столица, календарь, быт	analyze
5	`peter-cost`	Цена реформ + факт vs оценка, спор «реформатор/тиран»	evaluate (мета-навык)
6	`peter-decide` (опц.)	Сценарий «Реши за Петра» — погружение	create

Каждый концепт — полный (по §5), 12–18 мин. Концепт 5 (критическое мышление) стоит в конце, опираясь на факты концептов 1–4 и возвращая их (spacing).

10. Чеклисты

Концепт:

Одна идея, 3-5 learning_objectives.
Каждая цель: материал + проверка.
Каждый факт изложен до вопроса о нём.
Термины определены при появлении, есть примеры.
≤ ~9 новых терминов, ≤ 20 минут.
Материала больше, чем вопросов.
Ученик «с нуля» проходит без внешних знаний.

Тема / трек:

Тема разбита на концепты по одной идее (не «по верхам»).
3+ концепта, порядок и connections заданы.
Spacing: поздние концепты возвращают ранние факты.
Арка: контекст → механизмы → оценка/синтез.
Глубина и арка подобраны под полосу (Ю/С/В).