Почему ИИ-агент забывает проект и как дать ему память
Коротко: у агента нет памяти между сессиями, есть только текст, который он видит сейчас. Помогают файл с правилами проекта, запись решений, новая сессия на каждую задачу и порция нужных файлов вместо всего проекта.
Вчера ты договорился с агентом: оплату пока не трогаем. Сегодня он переписал оплату. На вопрос «зачем» отвечает вежливо и растерянно: вчерашнего разговора для него не было.
Причина не в характере агента. Так устроена его память.
Как агент «помнит»
У агента нет памяти в человеческом смысле. Есть контекст: текст, который он видит прямо сейчас. Туда попадает твоя просьба, файлы, которые он открыл, и переписка этой сессии. Всё, чего в контексте нет, для агента не существует.
Отсюда три беды.
Новая сессия начинается с нуля. Закрыл чат, и договорённости остались в нём.
Длинная сессия тоже забывает. Контекст ограничен. Когда он заполняется, старое сжимается или выпадает. Договорённость из начала разговора к вечеру может исчезнуть.
Чем больше в контексте лишнего, тем хуже работа. Если загрузить агенту весь проект, нужные три файла потеряются среди ста ненужных.
Четыре привычки, которые возвращают память
1. Память в файле, а не в чате
Заведи в проекте файл с тем, что агент должен знать всегда: что это за продукт, как его запустить, что нельзя трогать. У Claude Code это CLAUDE.md, у других агентов AGENTS.md. Агент читает его в начале каждой сессии.
2. Решения записывай сразу
Договорились не трогать оплату? Попроси агента дописать это в файл решений сейчас, а не «потом». Одна строка: что решили и почему. Через месяц этот файл расскажет новой сессии то, чего ты сам уже не вспомнишь.
3. Одна задача, одна сессия
Не веди проект одним бесконечным чатом. Закончил задачу, начни новую сессию. Короткая сессия держит в контексте только то, что относится к делу.
4. Давай агенту порцию, а не всё
Перед задачей назови файлы, которые ему нужны, и объясни зачем. «Правь password.ts. Формат ошибки смотри в auth.yaml». Три нужных файла работают лучше, чем весь проект.
Где привычки перестают помогать
На десяти задачах всё это держится на дисциплине. На сотне начинаются пропуски: решение не записал, порцию собрал наспех, файл памяти устарел. Агент не виноват. Ты просто стал его секретарём.
Я строю HyperArc, чтобы эту работу делала программа. Память проекта лежит в файлах и обновляется сама. Под каждую задачу собирается порция: задача и нужные файлы, у каждого записана причина. Новая задача стартует без истории прошлой. В нашем тесте сводка проекта на сто задач занимает до пяти тысяч токенов, это несколько страниц.
Как ставить задачу, чтобы порция была точной, я разобрал в шаблоне ТЗ. Почему агент при этом ломает рабочее, читай в руководстве про поломки.
Я делаю HyperArc. Учитывай это, когда читаешь мои тексты о нём.