/handoff

name: handoff
description: Закрытие сессии по 5-dimensions clean-exit (build / tests / progress / artifacts / startup) + группировка ошибок + предложение promotion в память. Триггеры — "/handoff", "закрываем", "на сегодня всё", "пора заканчивать".
when_to_use: В конце сессии, перед закрытием Claude Code или сменой проекта. Также auto-trigger на tmux detach. Без этого — следующая сессия начнётся с хаоса.

/handoff

5-dimensions clean-exit. Закрывает боль «забываю что делал».

5 dimensions check

1. Build

# Проект собирается без ошибок
npm run build
# или эквивалент

2. Tests

# Все тесты зелёные (existing + новые)
npm test

3. Progress

• SESSION.md обновлён (Today / What's Done / What's In Progress / What's Next)
• feature_list.json обновлён (state changes, evidence)
• error-journal.md обновлён если были ошибки

4. Artifacts

# Нет stale temp файлов
find . -name "*.tmp" -mtime -1
find . -name ".DS_Store" -delete

# Секреты не в git
git status | grep -i "\.env\|secret\|key" || echo "✓ no secrets staged"

5. Startup

# Следующая сессия сможет запустить ./init.sh с нуля
# Симуляция:
git stash
./init.sh
git stash pop
# Если упало — что-то не в репо

Если что-то не закрыто

Запиши в SESSION.md секцию `# Open Issues`:

## Open Issues (handoff не чистый)
- [ ] Tests падают: <которые> — нужен fix в feat-XXX
- [ ] Build падает: <причина>
- [ ] Нет evidence для feat-YYY

Следующая `/resume` сразу увидит и предложит починить ДО продолжения.

Группировка ошибок этой сессии

Прочитай error-journal.md записи **этой сессии** (по timestamp):

• Сгруппируй по `Класс ошибки`
• Для каждой группы: можно ли извлечь урок?

Promotion в память

Для каждого извлекаемого урока:

**Lesson scope: project**

• → `~/.claude/projects/<dashed-path>/memory/feedback_<slug>.md`
• → Добавить строку в MEMORY.md этого проекта

**Lesson scope: user**

• → `~/.claude/memory/MEMORY.md` (глобальная)
• Например: «пользователь предпочитает state-machine over tool_use»

**Lesson scope: system**

• → Предложение пользователю: «Заметил системный паттерн X. Добавить в ~/CLAUDE.md? Это будет применяться во всех проектах»
• НЕ записывать без явного confirm

**Финальная фраза**: одной строкой пользователю:

Сессия закрыта. 3 ошибки → 2 урока для памяти:
- "concurrent_writes_to_same_file" (project) — записал в feedback_concurrent_writes.md
- "execute_dont_ask" (user) — confirm? (д/н)

TTL cleanup в SESSION.md

Удалить из секции `Implementation Notes`:

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

Auto-commit

git add -A
git commit -m "handoff: session $(date +%Y-%m-%d)

- Active feature: <id>
- Sessions today: $(grep -c 'Today' SESSION.md)
- Errors logged: <count>
- Lessons promoted: <count>

Co-Authored-By: Vibe Dev"

Cold-start prep

Заполнить в SESSION.md секцию `# Cold-Start Test (next session)` — обновить 5 ответов на вопросы из `.harness/cold-start.yaml`. Чтобы при `/resume` evaluator-agent имел свежий референс.

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

✓ /handoff завершён

📊 Сессия: <duration>
✓ Build / Tests / Progress / Artifacts / Startup — all green
📝 Errors → lessons: <X promoted>
💰 Cost this session: $X.XX
⏰ Open Issues для следующей: <count>

Cold-start готов. Можно отдыхать.

Anti-patterns

• ❌ Закрывать без всех 5-dim
• ❌ Не записывать Open Issues при не-чистом выходе
• ❌ Промотировать урок в `~/CLAUDE.md` без confirm пользователя
• ❌ Скипать TTL cleanup (накапливается)
• ❌ Auto-commit когда есть .env в staged

Auto-trigger

Скрипт `scripts/auto-handoff-watcher.sh` слушает:

• tmux detach session-end signal
• 4 часа неактивности без явного pause

→ Автоматически запускает /handoff (с user notify).