Артефакты разбора занятия

Разбор проведённого занятия даёт не один документ, а несколько — с разными адресатами и разной судьбой. Узел разводит их и называет место каждого.

Причина разводить: конспект студенту и анализ для преподавателя пишутся из одного транскрипта, и при слиянии в один файл побеждает всегда анализ — студент получает разбор чужой работы вместо изложения темы.

1. Что производит разбор

Конспект для ведущего (тезисы по таймкодам, решения, открытые вопросы) — отдельный артефакт, и он не студенческий. Смешение этих двух — самая частая ошибка: студенту уезжает текст, написанный для того, кто вёл занятие.

2. Где артефакты живут

Раскладка области, которую разворачивает init-edu-area, разводит мастер-копию курса и конкретный поток. Разбор занятия принадлежит потоку, а не мастер-копии:

<область>/
  concepts/                     # дельты моделей приходят сюда
  courses/<код-курса>/
    master/                     # программа, аудитория, материалы, не зависящие от потока
    <поток>/
      lessons/L<N>/             # транскрипт, анализ, дайджест чата
      student/                  # конспекты и пакеты студентам
      delivery-log.md           # журнал проведения

Правило границы: в мастер-копию попадает то, что верно для любого прогона курса; в поток — то, что верно для этого. Конспект занятия относится к потоку, а вот правка программы, которую занятие вызвало, — к мастер-копии.

Артефакт, у которого нет очевидного места, — сигнал, что он смешивает два уровня, а не что раскладке не хватает папки.

3. Конспект студентам — обязателен, остальное по решению

Конспект для студентов производится всегда и уезжает в курс на платформе: студент ищет материал там, а не в папке преподавателя. Анализ, дайджест и дельты могут остаться внутри области — но в журнале проведения на них ставится ссылка, иначе через прогон их никто не найдёт.

4. Решения автора принимаются до исполнения, а не после

Разбор предлагает правки: обновить канон концепта, поправить программу, дописать конспект. Порядок здесь жёсткий и нарушается чаще всего:

1. Сначала — таблица предложенных пунктов, по каждому запрашивается выбор: выполнить / пропустить / скорректировать (и как именно).
2. Исполнение не начинается до явного ответа. Это касается и сценария «выполни план разбора целиком»: агент останавливается на таблице.
3. После ответа — исполняются только выбранные пункты, а в файле разбора остаётся блок «решения по пунктам»: пункт, действие, статус.

Почему порядок несущий: правка канона концепта необратима по последствиям — она расходится по всем курсам, которые этот концепт используют. Пункт, исполненный «по умолчанию», обнаруживается через прогон и уже не отделяется от осознанных правок.

5. Журнал проведения

Один файл на поток. Создаётся при первом разборе, дополняется при каждом следующем.

Что в нём:

• расписание занятий: даты, темы, статус;
• покрытие: план против факта по каждому занятию;
• накопленный долг — темы, не покрытые на занятии, и решение по каждой (перенести / снять / отдать на самостоятельное изучение / добавить в программу);
• что дано сверх плана.

Чем он питается: анализом проведения (секция покрытия). На что влияет: ориентир следующего занятия и программа курса в мастер-копии.

Журнал — единственное место, где видно расхождение программы с фактом. Без него следующий прогон курса стартует от программы, а не от того, как курс прошёл на самом деле.

6. Именование

Имя несёт курс, занятие и вид артефакта — в таком порядке: <код-курса>-L<номер>-<вид>.md, например E101-L01-конспект.md. Часть занятия, если оно разбито, добавляется после номера: L01-p2.

Во фронтматтере артефакта — курс, номер занятия и source: чем именно подтверждается содержание (транскрипт, запись, заметки). Без source конспект через месяц неотличим от пересказа по памяти.

7. Концепция описывается развёрнуто, а не строкой таблицы

Когда разбор находит концепт, занятие обязано оставить о нём четыре вещи: наблюдение (что именно происходило), что паттерн решает, в какой повторяющейся ситуации он применим и — если концепт новый — черновик формулировки.

Сжатие до одной строки таблицы уничтожает ровно то, ради чего концепт записывали: строка запоминает название, а применимость теряет. Критерии канона концепта — в базе знаний преподавателя, здесь только требование не сокращать.

8. Что эта политика не покрывает

Конспекты встреч, не привязанных к занятию курса (интервью, партнёрские разговоры, сессии), живут по общим правилам заметок и в материалы курса не попадают. Политика касается занятий курса, и только их.

Связанные узлы

• lecture-lifecycle-overview — фаза 4 цикла, где всё это производится
• summary-prose-canon — каким текстом пишется конспект студентам
• course-student-ai-pack-guide — что уезжает студенту вместе с конспектом