# Reflect

> Рефлексия в конце сессии или задания. Триггерься ТОЛЬКО на явный вызов /reflect. Это ручная команда — ученик сам решает, когда остановиться и подумать. Проводит короткую рефлексию (1-2 вопроса), записывает в reflection_log.json, обновляет scaffolding_level.json, competencies.json и другие progress/ файлы в конце сессии.

- Skill: `infinity-kim/reflect` (Agent Skill)
- Install (CLI): `npx skillmds@latest add infinity-kim/reflect`
- Raw SKILL.md: https://api.skillmd.com/api/skills/infinity-kim/reflect/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: infinity-kim (https://skillmd.com/u/infinity-kim)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/infinity-kim/reflect

---


# Рефлексия

Reflect — момент осознанной практики (Ericsson 1993). Ученик останавливается, смотрит на то, что сделал, и вербализует своё обучение. Это превращает практику из автоматической в осознанную — особенно ценно в областях, где главное не сам результат, а **рассуждение, которое к нему привело**.

## Когда вызывают /reflect

1. **Конец сессии** — перед закрытием. Зафиксировать понятое и обновить состояние.
2. **Конец задачи** — посреди сессии, после большой задачи-системы. Микро-рефлексия.

## Шаг 1: Выбор вопроса

Не задавай 5 вопросов. Выбери **один**, максимум два — по контексту.

**Если сессия дала новое знание:**
- «Что новое ты сегодня понял лучше, чем раньше?»
- «Какая одна идея сегодня была главной?»

**Если сессия была про практику:**
- «Что ты сегодня сделал такого, чего не смог бы неделю назад?»
- «Какое решение сегодня было самым неочевидным — и почему ты его выбрал?»

**Если сессия была тяжёлой:**
- «Что было самым сложным сегодня?»
- «На что обратить внимание в следующий раз?»

**Если сессия короткая (< 15 минут):**
- «Одна вещь, которую стоит запомнить?»

## Шаг 2: Ответ ученика

Дай сказать. Не прерывай. Его ответ — его материал.

Если ответ очень короткий («нормально») — один уточняющий:
> А если сравнить, как ты подходил к задаче в начале и в конце — что-то изменилось?

Не дави. Не хочет — окей.

## Шаг 3: Запись в reflection_log.json

Append:

```json
{
  "date": "2026-06-14",
  "question": "Что новое ты сегодня понял лучше?",
  "answer": "<ответ ученика своими словами>"
}
```

<!-- DOMAIN:examples -->
<!-- Пример ответа (System Design). Доменный слой заменяет своим. -->
> «Понял, что кеш покупает скорость ценой консистентности — и инвалидация это реальная проблема, а не деталь.»
<!-- /DOMAIN:examples -->

Это его личный лог — перечитает через месяц, увидит прогресс в своих же словах. Особенно полезно для профиля с риском синдрома самозванца (свидетельство роста).

## Шаг 4: Обновление остальных файлов

Если reflect в конце сессии — обнови файлы (как `session-flow` шаг 7):

- `profile.json` — XP, streak, last_session, ачивки, уточнение `learner_profile` если наблюдения противоречат
- `scaffolding_level.json` — правила перехода (3 без пробелов → +1, 2 слабых → −1)
- `spaced_review.json` — новые items (факты области), обновить повторённые
- `competencies.json` — observations и p_known (делегировано `diagnostics`)
- `mistakes_log.json` — новые ошибки
- `attention_metrics.json` — запись сессии
- `completed_lessons.json` — если прошли урок

Атомарно, полный файл.

## Шаг 5: Завершение

Короткая реплика.

**Продуктивная сессия:**
> Записал. В следующий раз, если хочешь, наметил следующий шаг: [следующий виток / задача]. До встречи.

**Тяжёлая:**
> Записал. Сегодня было сложно, но ты не бросил — это само по себе важно. До следующего раза.

**Короткая:**
> Записал. Увидимся.

## Правила

- **Один вопрос, не экзамен.**
- **Не предлагай свои ответы за ученика.**
- **Не оценивай ответ** («правильно/неправильно» — нет).
- **Не тяни** — максимум 3-5 минут.
- **Не пропускай обновление state.**

## Когда /reflect посреди задачи

Значит «хочу остановиться и подумать». Уважай: микро-рефлексия (1 вопрос), потом верни в работу или спроси, продолжать ли. Не делай полный update state — сессия не закончилась, запиши только ответ рефлексии.

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

- **`session-flow`** — reflect выполняет шаги 6-7
- **`feedback`** — правила реакции на ответы
- **`scaffolding`** — обновление уровней
- **`diagnostics`** — наблюдения за сессией → p_known