Агентам не нужна память — им нужна документация

Agents don't need memory, they need documentation

Агентам не нужна память — им нужна документация

Автор утверждает, что все плагины памяти для AI-агентов решают не ту проблему: они строят RAG-базы из фрагментов прошлых диалогов, но не дают агенту понимания проекта. Вместо этого он предлагает документо-ориентированную память — Markdown-воркспейс, который агент читает перед работой и обновляет после. Такой подход превращает цикл «запрос → сборка → забывание» в «запрос → консультация → сборка → обновление». Автор год использует этот метод и выложил плагин Operator Memory в открытый доступ.

Потому что агентам не нужна память. Им нужна документация.
  1. Garlef

    Я думаю, им тем более нужна детерминированная обратная связь:

    Недавно я попробовал подход, основанный на следующей идее, и это потрясающе — правила Lint, в сообщениях об ошибках которых содержится объяснение, как справиться с проблемой.

    https://habit-hooks.com/

    Я использую это, например, для внедрения IOSP (принципа разделения операций интеграции).

  2. spike021

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

    Если я говорю «используй jq вместо написания python-скрипта для парсинга json», он никогда не должен писать adhoc python-скрипты для парсинга json. И всё же это постоянно со мной происходит.

  3. gregwebs

    Согласен, и это кажется лучше.

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

    Я использую mattpocock/skills, и это генерирует ADR (Architectural Decision Records). Там используются только skills, включая setup skill, который записывает несколько указателей в AGENTS.md. У меня всегда есть CONTRIBUTING.md для документирования процесса разработки и CODING_STANDARDS.md. Вместе с README.md, документацией по архитектуре и сообщениями коммитов агенты, похоже, могут находить и использовать документацию и поддерживать её в актуальном состоянии. Мы также пишем много спецификаций и размещаем их в Github issues.

  4. atworkc

    Я остановился на простой папке под названием `workbench` — почему-то новые модели точно понимают, что с ней делать. Игнорируется Git.

    Единственный «промпт» — в AGENTS.md, где сказано, что эта штука существует и есть map.md <- это однострочная ссылка на то, что агент там хранит.

    И обычно я берусь за новую фичу и в какой-то момент говорю ему записать заметки в workbench, если мне это комфортно (и если это нужно сохранить в памяти).

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

    Затраты токенов выглядят приемлемо, и я всегда могу просто удалить там что-нибудь, так как его назначение эфемерно.

  5. b-karl

    Мы используем Claude Code в нашей компании, и я тоже согласен, что воспоминания устаревают и со временем загрязняют контекст, особенно когда состояние меняется извне. Например, кто-то делает рефакторинг или вводит паттерн, а я не участвовал в его разработке, поэтому мои локальные воспоминания не синхронизировались.

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

    Мы используем приватный маркетплейс плагинов Claude для внутренних плагинов и skills, и я стараюсь регулярно чистить свою память, перенося релевантные вещи в надлежащее место (skills в маркетплейсе, документацию в репозитории или Notion и т.д.) и удаляя устаревшую информацию.

  6. isaachinman

    Я написал это после многих итераций консультирования различных компаний. Документация доступна для запросов за единицы миллисекунд, лог только для добавления и т.д. Исключительно хорошо работало для моих проектов

    https://github.com/isaachinman/encephalon

  7. bushido

    Недавно я начал выписывать принципы вместо воспоминаний.

    По сути, паттерны, в которых агенты должны всегда мыслить. Я также внедрил систему версионирования для принципов, которые нужно цитировать в любых комментариях, присутствующих в коде. Таким образом, когда мои принципы развиваются, развивается и код.

    Я упаковал это так, чтобы можно было делиться с друзьями [0]. Система всё ещё развивается, но за последние примерно два месяца использования она служила мне очень, очень хорошо, и с последними моделями стало ещё лучше.

    Я получил на удивление хорошее соблюдение от агентов при использовании этой техники.

    [0] https://principledriven.dev/

  8. alienbaby

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

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

Ещё за этот день

2026-10-03