Перенос 53 чатов из Claude Code в Codex показал, что такое ИИ-агент без памяти проекта

Если вы только разбираетесь, что такое ИИ-агент: это нейросеть, которая не просто отвечает в чате, а сама работает в проекте. Она читает файлы, правит код, запускает проверки. Ниже по шагам разберём, как собрать агенту контекст, чтобы при смене сервиса не потерять месяцы работы.

Код при переезде остался на компьютере, репозитории никуда не делись. Но за несколько месяцев накопились десятки разговоров об архитектуре, ошибках и планах, и далеко не всё попало в документацию. Штатный импорт в Codex перенёс около 50 сессий, однако переписки плохо привязались к проектам. Тогда автор нашёл Hansard и стал искать по старой истории через поиск.

В комментариях на Хабре greenrus предложил хранить решения и планы в Git, системе контроля версий (журнале всех изменений в файлах проекта). mist56 напомнил про навыки агента, базу знаний и документацию, а также про количество мусора в старых диалогах. becefi поднял вопрос о переносе хода рассуждений модели и о различиях в протоколах разных моделей. RouR написал отдельную статью «Контекст должен быть в репозитории, а не в чате».

Что понадобится?

• Проект в Git или хотя бы в папке на вашем компьютере.
• Агент для работы с кодом, у автора это Codex.
• Файл инструкций AGENTS.md или CLAUDE.md, то есть памятка, которую агент читает первой.
• Для старых переписок инструмент поиска по сессиям, например Hansard или deja-vu.
• От одного до двух часов, чтобы навести порядок в небольшом проекте.

Как собрать контекст агенту по шагам?

1. Определите задачу. Сохранить историю, передать незавершённую работу и дать агенту достоверные знания: это три разных задачи, и каждая решается своим способом.
2. Дайте агенту карту, а не архив. Новый сотрудник не читает всю историю проекта, ему дают карту системы, инструкции и конкретную задачу. В небольшом проекте часто хватает AGENTS.md, актуальной документации, рабочих планов и тестов.
3. Записывайте решения отдельно. Для этого подходят ADR, записи архитектурных решений (короткие заметки «что выбрали и почему»). Код показывает, что сделано, но не объясняет причину выбора.
4. Для большого проекта постройте карту кода. Aider Repo Map собирает компактную схему структуры проекта с учётом бюджета токенов (порций текста, за которые платят и которыми ограничена память модели). В статье «Codebase Intelligence для агента» так разбирают проект на Rails размером более 3,5 млн строк.
5. Сверяйте документы с кодом. OpenSpec и GitHub Spec Kit помогают вести работу через требования и планы, а doubled-graph из подхода GRACE сравнивает заявленную архитектуру с реальной структурой кода.
6. Подключите поиск по старым сессиям. Hansard ищет по сохранённым сессиям разных агентов, достаёт нужное через функцию Recall и позволяет продолжить работу в другом окружении.

Стартовый промпт для агента в новом проекте может выглядеть так:

Прочитай AGENTS.md и папку docs. Не изучай всю историю проекта.
Кратко опиши архитектуру, ограничения и текущее состояние работы.
Если документация расходится с кодом или тестами, доверяй коду и сообщи о расхождении.

Что с этим делать прямо сейчас, по ролям

Автору Дзена. Тот же принцип работает и с текстами: держите файл с правилами канала, тоном и списком прошлых тем, а не надейтесь на память чата.

Маркетологу. Выносите решения по кампаниям в отдельный документ: при смене сервиса или подрядчика контекст переедет вместе с вами.

Предпринимателю из РФ и СНГ. Случай автора показал, что доступ к зарубежному сервису может закрыться неожиданно. Из доступных в РФ аналогов есть YandexGPT и GigaChat, и для них правило то же: инструкции и решения храните у себя.