Папка проекта и файл-память CLAUDE.md

Агент запускается «с чистого листа»: он не помнит вчерашнюю переписку. Если каждый раз объяснять заново, что у вас за магазин и где лежат выгрузки, половина времени уйдёт на пересказ. Решается это двумя вещами: рабочей папкой и файлом-памятью внутри неё.

1Рабочая папка магазина

Агент работает не «в интернете вообще», а в конкретной папке на вашем компьютере. Всё, что в ней лежит, он видит; всё, что снаружи, — нет. Поэтому имеет смысл один раз собрать хозяйство в одном месте:

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

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

2Файл CLAUDE.md

В корне папки создаётся текстовый файл `CLAUDE.md`. Агент читает его при каждом запуске — это и есть постоянная память проекта. Формат простой: обычный текст с заголовками и списками, пишете на русском, как объясняли бы новому сотруднику.

Что туда полезно положить:

• Контекст магазина. Ниша, площадки, бренды, порядок числа артикулов, кто ваш покупатель.
• Карта файлов. Какая выгрузка как называется, что в ней за колонки, за какой период, как часто обновляется.
• Ваши определения. Что вы считаете ДРР и от какой выручки, входит ли эквайринг в себестоимость, считаете ли по заказам или по выкупам. Это чаще всего расходится с «общепринятым» — и именно тут агент ошибается молча.
• Правила работы. Отвечать по-русски, суммы в рублях, итоги складывать в папку отчётов, исходные выгрузки не перезаписывать, перед долгим расчётом показать план.

Хорошее правило: если вы поправили агента дважды по одному и тому же поводу — эта поправка должна переехать в CLAUDE.md. Файл растёт из ваших замечаний, а не из фантазии о том, что «может пригодиться».

3Чего в этом файле быть не должно

• Ключей и паролей. Токены доступа к API, пароли, данные карт. Файл легко переслать или случайно опубликовать. Секреты хранят отдельно.
• Разовых поручений. «Посчитай ДРР за июль» — это сообщение в чат, а не строчка в памяти. В файл идёт только то, что верно всегда.
• Простыней данных. Не вставляйте таблицу на тысячу строк — положите её файлом и напишите, где она лежит.
• Устаревшего. Закрыли направление, переименовали бренд — почистите. Неверная инструкция хуже, чем её отсутствие: агент будет уверенно опираться на неё.

Держите объём в пределах пары страниц. Это памятка, а не регламент.

Результат заметен со второй сессии. Вместо «у меня магазин на WB, вот файл выгрузки, колонки такие-то, ДРР считаем от выручки по выкупам» вы пишете: «посчитай ДРР по бренду за июль». Остальное агент уже знает.