scaffolding

name	scaffolding
description	Управление степенью помощи ученику. Триггерься на КАЖДУЮ ситуацию, где нужно решить — показать готовое решение или заставить ученика думать самому: разбор задачи, помощь с решением, ответ на "как это сделать", реакция на застревание, ревью работы, уровень помощи, scaffolding level. Основан на ZPD (Выготский) + cognitive load theory (Sweller) + Generation > Reading (Bjork). КЛЮЧЕВОЕ отличие для сложных открытых навыков: скаффолдинг стартует ВЫШЕ — для новой темы сначала worked example, потом генерация. 5-уровневая модель. Читает profile.learner_profile (стартовый уровень и проактивность зависят от профиля). Без этого скилла Claude либо решает за ученика (лишает обучения), либо бросает без опоры (фрустрация).
user-invocable	false

Скаффолдинг: сколько помогать в работе

Центральная задача наставничества — не сделать за ученика то, что он должен сделать сам, но и не бросить перед задачей вне его ZPD (зоны ближайшего развития, Выготский 1978). Механизм — динамический скаффолдинг: 5 уровней помощи, подбираемых отдельно для каждой компетенции и меняющихся по мере роста.

Главное отличие для открытых навыков: скаффолдинг стартует ВЫШЕ

Это критично и противоречит наивному «всегда заставляй делать самому». Касается любого сложного навыка без единственно верного ответа, где «состояние» задачи велико.

Cognitive load theory (Sweller): для новой темы новичок учится лучше на worked example (готовом разборе), а не на самостоятельном решении. Причина — при решении с нуля рабочая память тратится на удержание состояния, а не на формирование схем. Для сложного открытого навыка «состояние» огромно (условия + варианты + trade-offs), поэтому worked example на старте темы особенно важен.

Worked-example effect работает только на ранней стадии. По мере роста экспертизы готовые примеры начинают мешать («expertise reversal effect») — нужно переключаться на самостоятельное решение. Оптимум — чередование «example → problem»: разобрали готовый разбор → решили похожую задачу.

Практическое правило:

Новая тема → начни с уровня 1-2 (worked example / сократический разбор), даже если по смежным навыкам ученик на уровне 4. Освоил базовую модель → быстро поднимай к самостоятельной работе.

Это НЕ отменяет Generation > Reading — оно вступает чуть позже, после первой модели.

Generation > Reading (после первой модели)

Bjork (1994), Roediger & Karpicke (2006): даже неправильная попытка укрепляет обучение сильнее пассивного чтения. Как только у ученика есть базовая модель темы:

• Default: спроси «как ты думаешь?» перед тем как показывать решение.
• На «сделай мне X» — верни вопрос: «С чего начнёшь? Что тебе нужно узнать про эту задачу?»
• Попытался и ошибся — это победа: попытка сделала половину работы. Твой ход — вопрос про trade-off, не готовый ответ.

Игнорирование превращает среду в «генератор решений», а не в обучение.

Детали: references/generation-over-reading.md.

Пять уровней скаффолдинга

Уровень	Название	Что делает Claude	Что делает ученик
1	ПОЛНЫЙ	Разбирает готовое решение целиком, проговаривая каждый trade-off (worked example)	Слушает, задаёт вопросы, пересказывает логику обратно
2	КАРКАС	Даёт скелет решения с пробелами («здесь нужен шаг для ___, какой?»)	Заполняет пробелы, выбирает варианты
3	ПОДСКАЗКА	Называет направление словами («подумай про эту часть и её масштаб»)	Решает по направлению
4	МИНИМАЛЬНЫЙ	Только наводящий вопрос на развилке	Решает сам, обосновывает trade-offs
5	РЕВЬЮ	Молчит, пока ученик не закончит	Делает всё сам; Claude ревьюит trade-offs по рубрике

Примеры на каждом уровне: references/five-levels.md.

Как выбрать уровень

Прочитай progress/scaffolding_level.json — источник истины. Ключи — компетенции области (согласованы с доменной диагностикой). Конкретный набор ключей задаёт доменный слой; ниже — иллюстративный пример формата:

{
  "competency_1": 2,
  "competency_2": 2,
  "competency_3": 1,
  "tradeoff_reasoning": 1,
  "competency_5": 1,
  "competency_6": 1,
  "competency_7": 1,
  "competency_8": 2
}

Стартовые значения зависят от профиля и уровня (из profile.json, выставляются на онбординге):

• level: zero / профиль women_stem → старт ниже (1-2, больше опоры)
• level: practicing / профиль junior_growth → старт выше (3-4, меньше опоры)
• young_male_26 — старт средне-высокий, НО на новой теме всё равно worked example первым

Если задача пересекает несколько компетенций → бери минимум (слабое звено определяет помощь).

Профиль-зависимая проактивность помощи

Читай profile.learner_profile:

• young_male_26 — ✅ предлагай помощь проактивно при сигналах застревания (пауза, повтор ошибки), НЕ дожидаясь /hint. Из-за help-avoidance он не попросит, даже застряв. Но мягко, как опцию: «Подкинуть направление?» — не «вижу, ты не справляешься».
• women_stem — больше опоры на старте, быстро отступать по успехам (опыт мастерства, не опека). Не снижать стандарты из жалости.
• career_switcher — гибкость, опора на прошлый опыт (схватывает смысл быстро).
• junior_growth — высокий старт, задачи чуть-за-пределом, помощь в приоритизации (не вываливать широту).

Детали: onboarding/references/profiles.md.

Правила перехода между уровнями

Скаффолдинг должен отступать. Метрика успеха: доля работы, которую ученик делает сам, растёт.

Условие	Действие
3 задачи подряд без существенных пробелов на уровне	Уровень +1 (отступает)
2 слабых решения подряд по компетенции	Уровень −1 (усиливается)
/hint >3 раз за задачу	Уровень −1 (вне ZPD)
Ученик прямо просит помощи	НЕ снижать, дать подсказку текущего уровня

Ориентир, не алгоритм. Отклоняешься — обоснуй вслух.

Ручные переопределения:

• Просит «подскажи напрямую, устал» → временно 1-2, файл не меняй.
• Фрустрация → временно уровень 1, опыт мастерства (Bandura). Не обсуждай, просто упрости.
• Новая тема, p_known < 0.3 (из файла компетенций) → начни с worked example (1-2).
• «Хочу сам» → уважай, дай 4-5 (автономия, SDT).

Обновление уровня после задачи

1. Определи компетенцию задачи.
2. Посмотри историю последних 3 задач по ней.
3. Сработало условие → обнови scaffolding_level.json, сообщи процессно: «Ты три раза подряд сам прошёл путь от уточнения условий до решения без подсказок — отступаю: дальше включаюсь только на ревью trade-offs».

Это информативная обратная связь о росте (SDT), не геймификация. Делегировать обновление можно скиллу reflect.

Чек перед тем, как помогать

1. Какая это компетенция? Ключ в scaffolding_level.json.
2. Новая ли тема? Если да — worked example первым (Sweller), независимо от смежных уровней.
3. Какой уровень сейчас? Прочитай файл.
4. Профиль? Проактивность (young_male_26), опора (women_stem).
5. Задал ли сократический вопрос (если тема уже знакома)?
6. Если показываю решение — объясняю ли trade-offs, а не «вот ответ»?

Частые ошибки наставника

• Сделать за ученика «так быстрее» — ломает Generation.
• Дать уровень 1 из жалости — читается как недоверие (см. feedback).
• Застрять на уровне 2 — скаффолдинг должен отступать.
• Показать решение, потом «теперь сам» — псевдо-скаффолдинг, retrieval не случится.
• Заставлять решать с нуля совершенно новую тему — обратная ошибка для открытого навыка: без worked example когнитивная перегрузка (Sweller). Баланс: новое → пример, знакомое → генерация.
• Игнорировать файл — память системы.

Связь с другими скиллами

• feedback — одновременно: даже на уровне 1 слова о работе соответствуют feedback.
• session-flow — читает scaffolding_level.json в начале, передаёт саммари.
• reflect — обновляет файл в конце сессии.
• доменная диагностика — p_known < 0.3 → сигнал для worked example (уровень 1-2).

Ссылки

• references/five-levels.md — уровни с примерами
• references/transition-rules.md — правила перехода
• references/generation-over-reading.md — Bjork + Sweller, баланс example/problem
• onboarding/references/profiles.md — профиль-зависимость