Разработка с использованием нескольких AI-агентов (например, исследование в Cursor, исправление в Claude Code, деплой через Copilot) часто приводит к потере контекста. Каждый новый инструмент начинает с «чистого листа», не зная принятых решений, неудачных попыток или текущего состояния тестов. Проект Handoff (доступен через npm) закрывает этот разрыв, создавая переносимый формат контекста сессии.
Как это работает
Handoff генерирует файл .handoff/HANDOFF.md, который служит структурированным снимком рабочего состояния. В отличие от статичных AGENTS.md, этот файл обновляется динамически и содержит:
- Next steps: Что нужно сделать дальше.
- Decisions made: Принятые архитектурные решения (например, выбор SQLite вместо Redis).
- Failed approaches: Методы, которые уже были отвергнуты, чтобы агент не тратил токены на повторные попытки.
- Working tree & Tests: Текущая ветка git, статус изменений и результат последнего прогона тестов.
Сравнение подходов
| Критерий | AGENTS.md (Статичный) | .handoff/HANDOFF.md (Динамический) |
|---|---|---|
| Источник данных | Человек (ручное редактирование) | Handoff save (git + заметки + тесты) |
| Частота изменений | Редко (изменения в проекте) | Каждая рабочая сессия |
| Основной вопрос | «Как устроен этот проект?» | «Где мы остановились? Что делать дальше?» |
| Интеграция с агентами | Требует ручной настройки промптов | Автоматический синтаксический анализ при старте |
Ключевые возможности
Инструмент работает как CLI-утилита. Основные команды:
handoff init: Инициализация проекта, автоопределение команды тестирования изpackage.json.handoff save [-m "..."]: Создание снимка состояния. Команда фиксирует ветку git, uncommitted changes и результатnpm test.handoff sync --with claude,cursor: Автоматическое обновление файлов-инструкций для конкретных агентов (Claude.md, .cursor/rules/handoff.mdc и др.) в пределах специального блока комментариев, не затрагивая остальной контент.handoff next / decision / failed: Запись шагов, решений и провалов в процессе работы.
Почему это важно
Handoff использует всего две зависимости (commander и picocolors), не собирает телеметрию и работает локально. Файлы формата JSON и Markdown можно коммитить в Git для командной работы или добавлять в .gitignore для локального использования. Это позволяет любому агенту, способному читать Markdown, мгновенно «подхватить» нить прерванного диалога, экономя время и токены на повторное объяснение контекста.
Источник: Github ↗