Память проекта и память чата: чем отличаются и что куда класть

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

Разложу по местам.

Три вида памяти

Правила проекта. Кто ты, что за проект, как с тобой работать. Читаются на каждом запуске, целиком.

Память между сессиями. Факты, решения, грабли, которые нельзя терять. Подтягиваются по теме, когда всплыла.

Скиллы. Порядок действий под конкретный тип задачи. Включаются по совпадению с описанием.

Разница в том, когда это читается. Из неё и растёт правило: то, что нужно всегда, — в правила; то, что иногда, — в память; то, что под задачу, — в скилл.

Что куда класть

Что	Куда	Почему
Кто ты, ниша, аудитория	правила проекта	нужно в любой задаче
Как с тобой работать, тон, запреты	правила проекта	влияет на каждый ответ
Где что лежит в проекте	правила проекта	навигация нужна всегда
Решения и почему их приняли	память	всплывает по теме
Грабли конкретного сервиса	память	нужно, когда трогаешь этот сервис
Порядок сборки карусели	скилл	только под эту задачу
Цены, реквизиты, факты	отдельные файлы	их читают по ссылке из правил

Строка про решения — самая недооценённая. Через месяц ты не помнишь, почему настройка сделана именно так, и переделываешь обратно. Записанное «почему» стоит дороже записанного «что».

Почему не стоит валить всё в один файл

Соблазн понятный: один файл, всё под рукой. Три причины, почему это плохо кончается.

Дорого. Правила читаются на каждом запуске. Десять страниц вместо одной — это налог, который платится с каждой мелкой задачи, включая «поправь опечатку».

Шумно. Половина инструкций не относится к текущей работе, но внимание всё равно тратится. Важное тонет в неважном.

Противоречиво. Большой файл разрастается кусками, и через месяц в нём мирно живут «пиши коротко» и «раскрывай подробно». Модель выбирает случайно, ты видишь нестабильность и винишь модель.

Рабочий ориентир: правила проекта — одна страница. Всё остальное — по ссылкам и в отдельных местах.

Как устроена память между сессиями

Смысл в том, чтобы завтрашняя работа начиналась не с нуля.

Разумная схема — два уровня. Журнал: сырые итоги сессий, длинно, для истории. Дистиллят: короткая выжимка повторяющихся уроков, только она читается каждый раз.

Без разделения память превращается в архив, который слишком дорого перечитывать, и перестаёт работать.

Что попадает в дистиллят: то, что случилось больше одного раза. Разовая ошибка — это событие, повторяющаяся — правило.

Признаки, что память пора чистить

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

Последний пункт — самый вредный: два описания одного правила рано или поздно разъезжаются, и получается противоречие.

Уборка занимает полчаса раз в месяц: перечитать целиком, вычистить неактуальное, свести дубли, вынести узкое в скиллы.

Как проверить, что память работает

Задай вопрос, ответ на который зависит от твоего проекта, а не от общих знаний: чем твой подход отличается от конкурентов, кто твоя аудитория, какие решения вы уже принимали.

Ответ общий и обтекаемый — памяти нет, всё держится на том, что ты объясняешь заново каждый раз. Ответ конкретный, твоими формулировками — фундамент на месте.

Проверку полезно повторять раз в месяц: память тихо деградирует, когда файлы разрастаются.

Как это выглядит у меня

Чтобы не абстрактно. Структура, к которой я пришёл за несколько месяцев:

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

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

Память отдельными файлами — один факт, один файл. Индекс со ссылками загружается всегда, сами файлы — по надобности.

Скиллы — по одному на тип работы, со своими шагами и своим списком граблей.

Ключевое решение здесь — индекс. Одна строка на файл памяти: название и намёк, о чём он. Модель видит весь список и открывает нужное, а не тащит всё сразу.

Одна ошибка, которая стоит дороже остальных

Держать знание в голове и не записывать.

Выглядит это безобидно: ты объяснил в разговоре, получил результат, пошёл дальше. Завтра объясняешь заново, послезавтра снова. Каждый раз это кажется мелочью в две минуты.

За месяц набегают часы, а главное — система не растёт. Она остаётся ровно такой же умной, какой была в первый день, потому что весь опыт остался у тебя, а не в файлах.

Признак, по которому ловить: объяснил одно и то же второй раз — записывай. Не «мне это часто нужно», а именно повтор объяснения.

Частые вопросы

Чем память проекта отличается от памяти чата?

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

Что писать в правилах проекта?

Только то, что нужно в любой задаче: кто ты, что за проект, кто аудитория, как с тобой работать, где что лежит. Узкие инструкции под конкретные задачи выносятся в скиллы.

Какого размера должен быть файл правил?

Ориентир — одна страница. Он читается на каждом запуске, поэтому каждая лишняя страница делает дороже любую мелкую задачу и повышает риск внутренних противоречий.

Как часто чистить память?

Раз в месяц имеет смысл перечитать правила целиком: вычистить неактуальное, свести дубли и вынести узкое в отдельные места. Разрастание происходит незаметно.