Работа над сайтом редко укладывается в один разговор с Claude Code. Сегодня поправили форму, завтра вернулись к мобильной версии, а через неделю нужно проверить отправку заявки. Если новая сессия не знает, что происходило раньше, часть времени уйдёт на повторные вопросы и уже пройденные проверки.
В таких задачах нам помогает handoff.md. Это обычный Markdown-файл в проекте, где зафиксировано состояние работы на конкретный момент. Специальной функции Claude Code для него не требуется: ассистент может записать файл в конце сессии и прочитать его в следующей.
Что стоит записать
Хороший handoff отвечает на несколько простых вопросов: какая была цель, какие файлы изменены, что уже работает, что именно проверено и какой следующий шаг. Отдельно полезно перечислить попытки, которые не помогли. Иначе новая сессия может снова пойти тем же путём.
Пока разговор ещё открыт, можно дать такую команду:
Запиши состояние задачи в
handoff.md: цель, изменённые файлы, что готово, что проверено, какие попытки не помогли и что осталось сделать. Укажи конкретные пути и результаты проверок.
После записи файл стоит прочитать самому. Фраза «форма готова» может означать только то, что написан код. Успешная сборка, проверка в браузере и получение заявки сервером являются разными результатами. В отчёте лучше называть каждый из них отдельно.
Например, запись «сборка проходит, страница открывается; отправка заявки на реальном сервере не проверена» намного полезнее общего «всё работает». Она не даёт следующему исполнителю принять предположение за факт.
Как начать новую сессию
В новом разговоре достаточно попросить: «Прочитай handoff.md, сверь его с текущими файлами и продолжай с указанного следующего шага». Сверка важна, если проект менялся параллельно. Файл отражает состояние на момент записи, а не гарантирует, что после этого никто ничего не изменил.
Самая ценная часть отчёта обычно находится в конце. Конкретный следующий шаг вроде «проверить ответ сервера при ошибке и поведение формы на ширине 390 px» позволяет сразу приступить к делу. Подробная стенограмма разговора для этого не нужна.
А как же сжатие контекста?
В Claude Code есть /compact для сокращения истории текущего разговора и /clear для нового разговора с пустым контекстом. Они описаны в документации Claude Code. handoff.md решает другую задачу: оставляет в самом проекте короткий отчёт, который может прочитать и исправить человек.
Для короткой правки файл передачи обычно не нужен. Он становится полезен, когда задача тянется несколько дней, затрагивает много файлов или переходит между людьми и ассистентами. Здесь важен не объём текста, а точность: что действительно сделано, чему можно доверять и что осталось проверить.
