/finish

name: finish
description: "Завершение рабочей сессии. Тесты, коммит, обновление SNAPSHOT, отчёт."
allowed-tools: Read Edit Write Glob Grep Bash
disable-model-invocation: true

Skill: Finish Session

Что делать

1. Запустить тесты

Если в проекте есть тесты:

# Определить тип проекта и запустить тесты
if [ -f "package.json" ]; then
  npm test 2>&1 || true
elif [ -f "pytest.ini" ] || [ -f "pyproject.toml" ] || [ -d "tests" ]; then
  python3 -m pytest tests/ 2>&1 || true
fi

Если тесты падают:

• Попробовать починить (до 3 попыток, автономно)
• Если не удалось — коммитить код, но записать в SNAPSHOT.md что тесты красные и что конкретно падает
• Не блокировать весь finish из-за упавшего теста

2. Проверить git status

git status --short
git diff --stat

3. Коммит изменений (по Commit Policy)

Если есть незакоммиченные изменения — следовать правилу `commit-policy.md`:

1. Для каждого файла определить категорию:

• **Запрещено** (.env, *.key, *.db, node_modules/ и т.д.) → убедиться что в `.gitignore`, если нет — добавить автоматически
• **Разрешено** (src/, tests/, CLAUDE.md, package.json и т.д.) → stage
• **Остальное** → решить по контексту, не спрашивая пользователя

2. `git add` только разрешённых файлов (поимённо, не `git add .`) 3. Сформировать описательное commit message 4. git commit

4. Обновить слои памяти

**SNAPSHOT.md** — что есть сейчас:

• **Что сделано** — добавить записи о работе этой сессии
• **В процессе** — очистить или обновить
• **Следующие шаги** — что осталось
• **Известные проблемы** — если обнаружены
• **Дата** — обновить timestamp

**BACKLOG.md** (если есть) — что планируется:

• Перенести закрытые задачи из Next в done
• Добавить новые обнаруженные задачи (Next/Soon/Later)
• Если решение «не делаем» — переместить в Won't do с одной строкой причины

**INVARIANTS.md** (если есть) — если в сессии возник новый инвариант или нашли нарушение существующего:

• Добавить новый INV-NNN с описанием правила, причины, проверки
• Это сигнал зрелости — не пропускать

**ARCHITECTURE.md** (если есть) — если в сессии изменилась карта системы (новый модуль, новые границы):

• Обновить соответствующую секцию

4b. Сохранить диалог сессии

Защита от retention cleanup Claude Code — диалог может содержать ценные методологические находки:

[ -f scripts/save-dialogs.sh ] && bash scripts/save-dialogs.sh || true

Без note (быстрый автосейв). Если в сессии было что-то особенно ценное — пользователь может вручную запустить `/save-dialog` с note до или после `/finish`.

5. Закоммитить обновлённые слои

# Проверить режим framework state
scripts/framework-state-mode.sh check-safe-mode

# Только private-solo коммитит memory layers в git-историю.
if [ "$(scripts/framework-state-mode.sh should-commit-framework-state)" = "true" ]; then
  for f in .claude/SNAPSHOT.md .claude/BACKLOG.md .claude/INVARIANTS.md .claude/ARCHITECTURE.md; do
    [ -f "$f" ] && git add "$f"
  done
  git diff --cached --quiet || git commit -m "docs: update memory layers after session"
else
  echo "Memory layers kept local due repo_access=$(scripts/framework-state-mode.sh repo-access)"
fi

В режиме `public`/`private-shared` SNAPSHOT остаётся локальным файлом и не коммитится. Если helper сообщает blocker из-за tracked framework files, сначала запусти `scripts/switch-repo-access.sh <mode>`.

6. Завершить лог сессии

Дописать в текущий файл `.claude/logs/sessions/YYYY-MM-DD_HH-MM.md`:

• Итоги тестов (passed/failed/skipped)
• Список коммитов сессии
• Ошибки (если были)
• Duration сессии

7. Отчёт пользователю

Кратко (5-7 строк):

• Что сделано за сессию
• Результаты тестов
• Хэши коммитов
• Что осталось на следующую сессию

Чего НЕ делать

• Не пушить автоматически (push — отдельное решение)
• Не коммитить файлы из списка «Запрещено всегда» (см. commit-policy.md)
• Не затягивать finish дольше 2 минут