Engram

Engram — это контролируемый человеком протокол памяти для ИИ-агентов. Он сохраняет долгосрочные знания о проекте, команде и личных предпочтениях в файлах, которые люди могут проверять, просматривать, синхронизировать и восстанавливать.

Engram не является скрытым мозгом агента. Агент может предлагать записи памяти, но единственным источником истины (source of truth) является утвержденный Markdown в директории .agents/.engram/ или в опциональной папке глобальной памяти.

Какую проблему он решает

ИИ-агенты забывают о решениях по проекту, повторяют вопросы по настройке окружения и смешивают старый контекст с новыми инструкциями. Встроенная память часто привязана к конкретному поставщику услуг, приложению или машине.

Engram предоставляет памяти стабильное соглашение:

• Утвержденные факты, правила и рабочие процессы хранятся в формате Markdown.
• Индексы и графы ускоряют маршрутизацию.
• Любая запись требует одобрения человеком.
• Хэши выявляют небезопасные правки.
• Правила исключения (ignore rules) защищают приватный контекст.
• Профили изолируют память компании, клиента и личных проектов, чтобы внешние API или корпоративные агенты не переносили контекст между проектами.
• Git обеспечивает историю изменений, переносимость и проверку командой.

Ментальная модель

Представьте Engram как центр хранения знаний:

Уровень	Задача
Markdown	Долговечный источник истины (source of truth)
JSON index	Быстрый поиск по индексу
JSON graph	Маршрутизация по темам и связям
Approval gate	Граница доверия перед записью
Hashes	Проверка целостности перед чтением
Ignore rules	Контроль приватности
Git	История аудита и синхронизация
Agent adapters	Удобство интеграции, но не источник власти

Приоритет областей видимости (Scopes)

Engram разрешает память в следующем порядке:

1. Память проекта (workspace): <project>/.agents/.engram/
2. Глобальная память: $ENGRAM_GLOBAL_DIR или engram inject --global-path <путь>

Память проекта имеет приоритет. Глобальная память используется как резервная (fallback) для переносимых личных настроек и командного контекста между разными проектами.

Текущее состояние

Engram включает в себя:

• save для одной утвержденной записи памяти.
• save-session / ss для нескольких записей памяти по итогам сессии, с опциональным --query-level <n> для обработки до n доступных недавних чатов; /engram ss -a last 50 sessions нормализуется в engram save-session --query-level 50 --accept-all.
• observe для черновых заметок, которые еще не стали активной памятью.
• take-control для импорта существующих руководств и документации агента.
• graph и quality-check для анализа структуры памяти и выявления конфликтов.
• archive для удаления неверной или устаревшей памяти из активной маршрутизации.
• repair для обнаружения поврежденных файлов памяти, пропущенных при пересборке индекса.
• benchmark для контроля регрессии поиска.
• Наборы навыков агента (skillsets), адаптеры для слэш-команд и инструменты предложений в стиле MCP.

Перед использованием команд ознакомьтесь с концептуальной страницей: Понимание Engram.

Далее: Быстрый старт для ИИ-агента.