/end-session

name: end-session
description: Закрытие сессии одной командой. Полный handoff (5-dim clean-exit + memory sync + final commit) + готовая команда для рестарта в новой сессии. Триггеры — "/end-session", "/end", "закрываем сессию", "на сегодня всё", "конец сессии".
when_to_use: В конце сессии работы. Заменяет ручной /handoff + повторный старт Claude Code. После выполнения — пользователь получает одну команду для копипаста чтобы стартовать новую сессию в той же папке.

/end-session

Однокомандное закрытие сессии. Обёртка над `/handoff` + auto-commit + restart helper.

> 🔒 **Режим закрытия (v6.2 F7).** Фраза закрытия уже включила closing-mode (хук поставил > `.harness/locks/closing-mode`): запись возможна ТОЛЬКО в state-файлы (SESSION.md, > feature_list.json, memory/, error-journal, .session-state/, docs/retrospectives|decisions), > Bash — только git/read-only/скрипты плагина. Любая «дописать фичу напоследок» — BLOCK: > новую работу фиксируй строкой в backlog. Режим снимет следующее сообщение пользователя > без слов закрытия.

Что происходит

Шаг 1: Memory sync (E6 — критичный)

Перед запуском скрипта **обязательно**:

1. Открой `~/.claude/projects/<dashed-path>/memory/project_*.md` (если есть) 2. Обнови поля:

• Pipeline stage (актуальная фаза)
• Активные фичи (PASSING / active / blocked / paused)
• Next command
• MVP path
• Архитектурные решения за сессию

3. Проверочный вопрос: «Если сейчас новая сессия сделает /resume — увидит cold-start то же что я вижу в SESSION.md?»

Если нет — обнови ДО продолжения. См. `rules/memory-stays-in-sync.md` (по правилу E6).

Шаг 2: Промоушн уроков из error-journal

Прочитай `error-journal.md` (если есть). Группируй похожие записи. Для каждой группы:

• Класс ошибки
• Lesson scope (project / user / system)
• Предложи пользователю promotion одной строкой:

3 ошибки → 2 урока на promotion:
- "concurrent_writes_to_same_file" (project) — запишу в feedback_concurrent_writes.md
- "execute_dont_ask" (user) — confirm? (д/н)

При confirm — создай feedback_*.md в `~/.claude/projects/.../memory/`.

Шаг 3: TTL cleanup в SESSION.md

Удалить из SESSION.md → Implementation Notes:

• Open Questions старше 5 рабочих дней (эскалировать как блокеры)
• Design Decisions старше 5 рабочих дней (продвинуть в `docs/decisions/` или удалить если неактуально)

Шаг 4: Запуск bash скрипта

bash "${CLAUDE_PLUGIN_ROOT}/scripts/end-session.sh"

(скрипт автоматически возьмёт `pwd` как project path)

Скрипт делает:

• 5-dim clean-exit (build / tests / progress / artifacts / startup)
• .gitignore защита .env*
• Запись `.session-state/last-session.md`
• Auto-commit (с проверкой что секреты не в staged)
• Создаёт `restart-here.sh` в папке проекта
• Печатает готовую команду для рестарта

Шаг 4б: Эстафета по направлениям (если волна разрезана)

Если в проекте есть `.harness/relay.json` — волна идёт эстафетой по направлениям (решение владельца: направление = отдельная сессия). Закрывая сессию, передай эстафету:

bash "${CLAUDE_PLUGIN_ROOT}/scripts/wave-relay.sh" done

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

Если волна ещё не разрезана, а задач в очереди много — предложи разрезать: `bash "${CLAUDE_PLUGIN_ROOT}/scripts/wave-relay.sh" plan`

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

После завершения скрипта — финализируй шаблоном B (см. `rules/message-finalization.md`):

Готово. /end-session завершён clean. Commit: <hash>. Сессия упакована.

Следующий старт — одна из команд (скрипт уже напечатал):

  cd <папка-проекта> && claude

ИЛИ через restart helper:

  cd <папка-проекта> && bash restart-here.sh

После запуска — скажи /resume <project>, я подниму cold-start (5 вопросов из репо).

Вопросов от меня нет. Закрывай эту сессию когда готов. Доброго дня!

Триггеры

• `/end-session`
• `/end`
• «закрываем сессию», «на сегодня всё», «конец сессии», «всё, заканчиваем»
• (опционально через auto-handoff-watcher) — 4 часа неактивности → автозапуск

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

• Конец рабочего дня
• Перед длительным перерывом (>4 часов)
• Смена проекта (когда хочешь переключиться на другой)

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

• Просто пауза 30 минут — не нужно, продолжишь в этой же сессии
• Если в середине активной /feature без verify — сначала /verify, потом /end-session

Возвращение

В новой сессии после рестарта: 1. Claude Code открывается в папке проекта 2. Сразу скажи: `/resume <project>` — cold-start test (5 вопросов из репо через external evaluator) 3. Если cold-start ≥4/5 — продолжай работу 4. Если <4/5 — state разъехался, читай `.session-state/last-session.md` и SESSION.md вручную

Anti-patterns

• ❌ Запускать /end-session без обновления memory project_*.md (E6 violation)
• ❌ Не делать промоушн уроков из error-journal (learning gap)
• ❌ Игнорировать warnings из 5-dim checks (накопление technical debt)
• ❌ Закрывать сессию с staged секретами в git

Особые случаи

• **Если build/tests failed**: скрипт всё равно делает commit (handoff важнее), но записывает в SESSION.md Open Issues. Следующая сессия начнёт с починки.
• **Если в проекте нет CLAUDE.md / AGENTS.md** (не Vibe Dev проект): скрипт предупредит, но продолжит.
• **Если git не настроен**: skip auto-commit.

Связано

• `skills/handoff/SKILL.md` — низкоуровневый handoff (вызывается под капотом)
• `rules/memory-stays-in-sync.md` — E6 правило
• `scripts/end-session.sh` — bash скрипт
• `rules/message-finalization.md` — формат финального сообщения