/checkpoint

name: checkpoint
description: Управляемый чекпоинт состояния в файлы посреди работы — вместо авто-сжатия («рулетки»). Перезаписывает Current State, синхронизирует статусы, ротирует завершённое в архив, прогоняет cold-start self-test. Триггеры — "/checkpoint", "чекпоинт", "зафиксируй состояние", "разгрузи контекст", "сохрани прогресс".
when_to_use: На естественной границе (конец фичи / конец волны / перед долгим субагентом / когда контекст потяжелел) ДО того как движок сам решит сжать контекст. НЕ закрывает сессию (для этого /end-session) — фиксирует состояние в файлы и позволяет продолжить работу с разгруженным контекстом.

/checkpoint

Управляемое сжатие вместо рулетки. Курс владельца (c8): авто-сжатие контекста — **крайняя мера у самого лимита**, не рабочий инструмент. Anthropic/Manus подтверждают: держи горячий контекст малым, состояние — в файлах под своим управлением, тогда порог сжатия почти не достигается.

`/checkpoint` — это «сохранить игру» на естественной границе: всё важное уезжает в файлы, после чего контекст можно смело сжимать или начинать сессию заново без потери нити.

> **Чем отличается от `/end-session`:** checkpoint НЕ закрывает сессию и НЕ включает closing-mode. Ты продолжаешь работать сразу после него. `/end-session` — это «на сегодня всё» (финальный коммит + restart-helper + выход).

Порядок (сначала руками — в файлы, потом скрипт)

Шаг 1: Перезапиши Current State в SESSION.md (c6 overwrite, НЕ append)

Блок `## Current State` — это снимок «здесь и сейчас», его перезаписывают целиком, не копят:

• **Last Updated** — дата-время этой сессии (не шаблон `YYYY-MM-DD`).
• **Active Feature** — реальная фича из feature_list.json (или «нет активной» на границе волны; шаблон `[feat-XXX …]` не оставлять).
• **What's Next** — конкретный следующий шаг (не «[Следующее действие]»).

История/завершённое сюда НЕ дублируется (это раздувает горячий контекст — L4-F1). Завершённое уходит в архив (Шаг 4).

Шаг 2: Синхронизируй feature_list.json — статусы + evidence

• Проставь фактические `state` фичам этой сессии.
• Для `passing`/`done` — впиши `evidence` (что и как проверено). Без evidence фича не архивируется (c10).
• **Бизнес-правку требования** (изменили описание/скоуп/инвариант по ходу) фиксируй ТОЛЬКО писателем истории плагина — он запишет откуда/когда/факт замены в провенанс-лог (иначе git pre-commit заблокирует коммит, L3-F4). Скрипт лежит в плагине, не в проекте; формат события — в начале скрипта:

`printf '%s' '<событие JSON>' | bash "${CLAUDE_PLUGIN_ROOT}/scripts/record-change.sh" --project "$(pwd)"`

Шаг 3: Дозапиши журнал/решения

Значимые решения сессии → `docs/decisions/` или `SESSION.md` → Decisions Made. Грабли → `error-journal.md`.

Шаг 4: Запусти скрипт (ротация + cold-start gate)

bash "${CLAUDE_PLUGIN_ROOT}/scripts/checkpoint.sh"

(берёт `pwd` как проект). Скрипт:

• чинит провенанс, если голова отстала от лога после обрыва (`record-change --recover`); стабы архива сверяет с телом в архиве и не переписывает, записи без головы истории и стабы без тела в архиве не трогает — «без головы истории N» и «стабов без тела в архиве N» в выводе не ошибка, а счёт записей, которые сверять не с чем (тело в архиве проверит сторож коммитов);
• ротирует завершённое (done/superseded/rejected с evidence) в `feature_list.archive.json` по ссылке — горячий контекст худеет;
• **COLD-START GATE (block):** если SESSION.md шаблонный/не обновлён или провенанс некогерентен → `/checkpoint` НЕ завершается, скрипт перечисляет незафиксированное. Допиши в файлы и повтори.

Шаг 5: Cold-start self-test (сверь по ФАЙЛАМ, не по памяти)

Скрипт напечатает 5 вопросов. Ответь на каждый **из файлов репозитория**, не из контекста: 1. Что за продукт? 2. Активная фича + verification? 3. Последние 3 решения? 4. Что дальше? 5. Что не делать?

**Если хоть один ответ живёт только в контексте — допиши его в файл ДО разгрузки.** Это и есть механизация правила 4 «план только через файлы»: чат между сессиями не передаётся, свежая сессия увидит ровно то, что в файлах.

Шаг 6: Коммит (опционально, но желательно)

Зафиксированное состояние стоит закоммитить — тогда чекпоинт переживёт что угодно. Если правил провенанс — коммить как обычно (git pre-commit проверит когерентность).

Финальное сообщение пользователю

Коротко: что зафиксировано, что дальше, приглашение продолжить. Пример:

Чекпоинт сделан. Состояние в файлах: SESSION.md обновлён, feat-042 → passing (evidence записан),
2 завершённые фичи ушли в архив. Cold-start self-test — все 5 вопросов восстановимы из репозитория.

Контекст можно разгружать. Продолжаю со следующего шага: <next>. Или скажи /end-session, если на сегодня всё.

Когда применять

• Конец фичи или волны (естественная граница).
• Перед запуском тяжёлого субагента (освободить главный контекст).
• Контекст потяжелел / получил нудж «сделай /checkpoint» (L4-F5) — ДО авто-порога сжатия.

Когда НЕ применять

• Закрываешь сессию совсем → `/end-session` (он включает checkpoint-логику + выход).
• Середина фичи без verify → сначала доведи до проверяемой точки.

Anti-patterns

• ❌ Дописывать завершённые фичи телом в SESSION.md/CLAUDE.md (раздувает горячий контекст — L4-F1 warn). Завершённое → архив по ссылке.
• ❌ Проходить cold-start self-test «по памяти» — вопрос в том, есть ли ответ В ФАЙЛАХ.
• ❌ Править бизнес-поле требования мимо `record-change.sh` (потеря провенанса → git pre-commit block).
• ❌ Полагаться на PreCompact-слепок как на память — он страховка (insurance-tier, L4-F3), не основной носитель.

Связано

• `scripts/checkpoint.sh` — механическая часть + cold-start gate.
• `rules/context-tiers.md` — трёхуровневая модель контекста (L4-F1).
• `skills/end-session/SKILL.md` — полное закрытие сессии (checkpoint + выход).
• `v8-provenance-and-context.md` §5 — дизайн анти-сжатия.