раздел 04

Memory (memory.md, MEMORY.md)

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

Часто память устроена как индекс: короткий файл MEMORY.md со списком тем и ссылками, а подробности - в отдельных файлах рядом. Так агент видит оглавление и подгружает нужный кусок, когда он реально понадобился, не таща в контекст всё сразу.

Что такое устойчивый факт

Ключевое слово - устойчивый. В память идёт то, что будет верно и завтра, и через месяц, и пригодится в разных задачах:

  • Решения и договорённости. Выбрали такую-то библиотеку и почему. Условились оформлять вот так.
  • Стабильные факты о проекте и окружении. Прод на таком-то сервере, деплой такой-то, у клиента такое-то юрлицо.
  • Фидбэк и грабли. Агент один раз ошибся, ты поправил - запись в память, чтобы не повторилось.

Пример: память как индекс

# MEMORY.md

- [Деплой проекта](memory/deploy.md) - только через git push, hook на сервере.
- [Выбор ORM](memory/decisions.md) - взяли Prisma, не TypeORM; причина внутри.
- [Грабли с датами](memory/feedback.md) - хранить время в UTC, была путаница.
- [Реквизиты клиента X](memory/client-x.md) - юрлицо, ИНН, банк.

Каждая строка - тема и ссылка. Агент читает этот список всегда, а подробный файл открывает, только когда тема всплыла.

Хорошо и плохо

Хорошо
Устойчивые факты, принятые решения с причиной, накопленный фидбэк по ошибкам. Коротко, по одной мысли на запись. Индекс сверху, детали в отдельных файлах.
Плохо
Секреты и пароли (им место в .env, не в памяти). Одноразовый мусор из конкретного чата. Куски кода, которые устареют через неделю. Дубли того, что и так есть в AGENTS.md / CLAUDE.md.

Память против инструкции проекта

Их легко перепутать. Разница в природе:

  • AGENTS.md / CLAUDE.md - это правила, которые ты задаёшь сознательно: как работать с проектом.
  • Память - это то, что накопилось по ходу: решения, которые приняли, ошибки, на которых научились. Она растёт со временем, а инструкцию ты пишешь целенаправленно.

Куда дальше