Организация памяти для Hermes - AI-агент за 5 минут - neirohost.ru Skip to content

Организация памяти для Hermes

Это рабочая инструкция по организации памяти Hermes-агента. Система основана на файле-индексе AGENTS.md, который загружается в начале каждой сессии и указывает агенту, где искать информацию по каждой теме. Инструкция ниже — готовый промт, который можно скопировать и передать новому агенту.

Правила работы с Workspace

1. Структура

1.1. Создание workspace

В корне профиля агента создать папку workspace.

  • Default-агент (первый, создаётся автоматически): корень = .hermes/ → workspace = .hermes/workspace/
  • Профильный агент (второй и последующие): корень = .hermes/profiles/<имя>/ → workspace = .hermes/profiles/<имя>/workspace/

    • Правило: workspace создаётся в том же каталоге, где лежит SOUL.md агента. Не в чужом профиле, не в общем .hermes/ — каждый агент работает в своём пространстве.

    1.2. Конфигурация

    Прописать путь к workspace в конфиге как cwd — рабочая директория агента.

    1.3. Все рабочие файлы — в workspace

    Перенести все файлы, с которыми агент работает, внутрь workspace. Отныне это единственная папка, в которую агент складывает все создаваемые файлы.

    1.4. Структура workspace

    workspace/
├── AGENTS.md              ← индекс (оглавление)
├── project-alpha/         ← папка проекта
│   ├── README.md          ← описание проекта
│   └── ...связанные файлы
├── project-beta/
│   ├── README.md
│   └── ...
└── ...
  • AGENTS.md — индекс по всему workspace. Загружается в начале каждой сессии.
  • Папки проектов — каждая крупная тема/проект живёт в своей папке внутри workspace.
  • Мелкие темы — записываются прямо в AGENTS.md, без отдельных файлов.

    • 2. AGENTS.md — файл-индекс

    2.1. Назначение

    AGENTS.md — оглавление по всей памяти агента. Загружается в начале сессии. Содержит записи, по которым агент понимает, где искать информацию при обсуждении соответствующей темы.

    2.2. Правила заполнения

    Когда записывать:

    Когда в конце сессии пользователь просит «запомнить» или «сохранить» проделанную работу:

    1. Проверить существующие файлы — есть ли уже файл, подходящий под эту информацию. Например, если обсуждалась работа по сайту — возможно, уже существует site.md.

    2. Если файла нет — создать новый файл и сохранить в него подробно всю важную информацию из сессии/диалога.

    3. Добавить запись в AGENTS.md в формате:

    ## Название работы
Краткое описание (2-3 предложения о сути).
→ Файл: [имя-файла.md](имя-файла.md) или [папка/README.md](папка/README.md)

    Если тема не требует большого объёма записей — записать её прямо в AGENTS.md, без отдельного файла.

    2.3. Принцип работы

    1. Стартует сессия → AGENTS.md попадает в контекст.

    2. Пользователь поднимает тему, связанную с чем-то из индекса.

    3. Агент видит запись в AGENTS.md → читает полный файл → отвечает с полным контекстом.

    3. Папки проектов

    3.1. Когда создавать папку

    Когда тема предполагает несколько связанных файлов — создавать отдельную папку (например, project-umbrella/).

    3.2. Содержимое папки проекта

  • README.md — описание проекта (на него ссылается AGENTS.md).
  • Связанные файлы — всё, что относится к проекту: заметки, скрипты, конфиги, черновики.

    • 3.3. Ссылка из AGENTS.md

    В AGENTS.md на каждый проект — запись с названием, кратким описанием и ссылкой на README.md внутри папки.

    4. Правило переполнения MEMORY.md

    Если MEMORY.md достиг лимита:

    1. Распределить записи по файлам в workspace — каждую тему в соответствующий файл (существующий или новый).

    2. Освободить MEMORY.md, оставив в ней только краткие указатели-ссылки на файлы в workspace.

    3. Обновить AGENTS.md — добавить записи для новых файлов.

    Принцип: MEMORY.md — краткие факты и настройки. Подробная информация — всегда в файлах workspace.

    5. Сохранение правил (обязательно)

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

    Что делать:

    1. Открыть свой SOUL.md (обычно лежит в корне профиля: .hermes/SOUL.md или .hermes/profiles/<имя>/SOUL.md).

    2. Добавить в него ссылку на эти правила или краткое изложение ключевых принципов:

  • Workspace = единственная рабочая папка.
  • AGENTS.md = индекс-оглавление, загружается в начале сессии.
  • Мелкие темы → прямо в AGENTS.md. Крупные → отдельная папка.
  • При сохранении: проверить существующие файлы → создать если нет → обновить AGENTS.md.
  • Если MEMORY.md переполнен → распределить по workspace-файлам.

    • Почему это важно: без сохранения в SOUL.md агент в новой сессии не будет знать о системе workspace и AGENTS.md. SOUL.md — это то, что агент «помнит» всегда, даже без напоминания.