Агентам не нужна память — им нужна документация
Agents don't need memory, they need documentation

Автор утверждает, что все плагины памяти для AI-агентов решают не ту проблему: они строят RAG-базы из фрагментов прошлых диалогов, но не дают агенту понимания проекта. Вместо этого он предлагает документо-ориентированную память — Markdown-воркспейс, который агент читает перед работой и обновляет после. Такой подход превращает цикл «запрос → сборка → забывание» в «запрос → консультация → сборка → обновление». Автор год использует этот метод и выложил плагин Operator Memory в открытый доступ.
Потому что агентам не нужна память. Им нужна документация.
- Garlef
Я думаю, им тем более нужна детерминированная обратная связь:
Недавно я попробовал подход, основанный на следующей идее, и это потрясающе — правила Lint, в сообщениях об ошибках которых содержится объяснение, как справиться с проблемой.
Я использую это, например, для внедрения IOSP (принципа разделения операций интеграции).
- spike021
Я думаю, какой бы из них ни использовался, должен быть способ принудительно соблюдать написанное.
Если я говорю «используй jq вместо написания python-скрипта для парсинга json», он никогда не должен писать adhoc python-скрипты для парсинга json. И всё же это постоянно со мной происходит.
- gregwebs
Согласен, и это кажется лучше.
Но я всегда думал, что не хочу, чтобы существовала документация, предназначенная только для агентов.
Я использую mattpocock/skills, и это генерирует ADR (Architectural Decision Records). Там используются только skills, включая setup skill, который записывает несколько указателей в AGENTS.md. У меня всегда есть CONTRIBUTING.md для документирования процесса разработки и CODING_STANDARDS.md. Вместе с README.md, документацией по архитектуре и сообщениями коммитов агенты, похоже, могут находить и использовать документацию и поддерживать её в актуальном состоянии. Мы также пишем много спецификаций и размещаем их в Github issues.
- atworkc
Я остановился на простой папке под названием `workbench` — почему-то новые модели точно понимают, что с ней делать. Игнорируется Git.
Единственный «промпт» — в AGENTS.md, где сказано, что эта штука существует и есть map.md <- это однострочная ссылка на то, что агент там хранит.
И обычно я берусь за новую фичу и в какой-то момент говорю ему записать заметки в workbench, если мне это комфортно (и если это нужно сохранить в памяти).
Это позволяет легко запускать других агентов и тому подобное с хорошей точки — я просто указываю им, что всё в workbench.
Затраты токенов выглядят приемлемо, и я всегда могу просто удалить там что-нибудь, так как его назначение эфемерно.
- b-karl
Мы используем Claude Code в нашей компании, и я тоже согласен, что воспоминания устаревают и со временем загрязняют контекст, особенно когда состояние меняется извне. Например, кто-то делает рефакторинг или вводит паттерн, а я не участвовал в его разработке, поэтому мои локальные воспоминания не синхронизировались.
Мой самый свежий пример — несколько устаревших и заархивированных репозиториев, которые продолжали добавляться в планы по исправлению проблем.
Мы используем приватный маркетплейс плагинов Claude для внутренних плагинов и skills, и я стараюсь регулярно чистить свою память, перенося релевантные вещи в надлежащее место (skills в маркетплейсе, документацию в репозитории или Notion и т.д.) и удаляя устаревшую информацию.
- isaachinman
Я написал это после многих итераций консультирования различных компаний. Документация доступна для запросов за единицы миллисекунд, лог только для добавления и т.д. Исключительно хорошо работало для моих проектов
- bushido
Недавно я начал выписывать принципы вместо воспоминаний.
По сути, паттерны, в которых агенты должны всегда мыслить. Я также внедрил систему версионирования для принципов, которые нужно цитировать в любых комментариях, присутствующих в коде. Таким образом, когда мои принципы развиваются, развивается и код.
Я упаковал это так, чтобы можно было делиться с друзьями [0]. Система всё ещё развивается, но за последние примерно два месяца использования она служила мне очень, очень хорошо, и с последними моделями стало ещё лучше.
Я получил на удивление хорошее соблюдение от агентов при использовании этой техники.
- alienbaby
Скажу так: построив нечто подобное для отслеживания «памяти» и предметов дома, можно быстро начать расходовать токены при чтении и обновлении, поддержании устаревшей информации актуальной и т.д., когда объём данных начинает расти. Мелкие задачи могут раздуваться по стоимости токенов, так как документы читаются, обновляются, сопоставляются, обновляются заново и т.д.
Однако я обнаружил, что наличие хорошей надёжной справки по моей домашней инфраструктуре, сервисам, настройке ci/cd, хостам, хранилищам, сетям и т.д. действительно творит чудеса как набор «воспоминаний» для совместного использования в проектах, которые, как я ожидаю, будут тестироваться / развёртываться / проходить приёмочное тестирование и т.д. с использованием элементов домашней инфраструктуры.