Типы памяти
У каждого активного воспоминания Engram есть тип. Тип определяет маршрутизацию, проверку и то, как воспоминание отображается агентам.
| Тип | Назначение |
|---|---|
| Rule | предпочтение пользователя, исправление, ограничение, указание «всегда/никогда» |
| Skill | повторяемый рабочий процесс, чек-лист, процедура, runbook |
| Knowledge | объективный факт о проекте, решение, деталь реализации |
Новые файлы используют schema_version: 3. Воспоминания типов rule и skill по умолчанию получают authority: instruction; knowledge — authority: reference. revision начинается с 1 и увеличивается при обновлениях. Идентификаторы следов относятся к evidence_refs, а идентичности сессии или источника — к derived_from.
Хорошее воспоминание
Хорошее воспоминание Engram:
- достаточно стабильно, чтобы быть важным и через неделю
- достаточно конкретно, чтобы его можно было маршрутизировать позже
- достаточно коротко, чтобы поместиться в контекст агента
- достаточно безопасно, чтобы делиться им в предполагаемой области
- записано как правило, рабочий процесс или элемент знаний
Плохое воспоминание — это временный шум чата, секреты, учётные данные, разовые домыслы или факты, которые никто не утверждал.
Варианты правил
Engram выводит формулировки правила в вариантах light, balanced и strict во время рендеринга из ## Content правила (balanced — это Content дословно), поэтому новые и переписанные файлы правил хранят только Content. Раздел ## Rule Variants сохраняется только для собственных формулировок, которые кандидат передаёт через LIGHT:/BALANCED:/STRICT:. Режим вариантов правил — это линза рендеринга для памяти, ориентированной на агента:
- Strict помогает моделям младшего уровня оставаться в рамках.
- Формулировки light или balanced обычно помогают более сильным моделям, чтобы правила не ограничивали их рассуждения.
Когда варианты выключены, Engram по умолчанию рендерит формулировку balanced. Настройка:
engram set-rule-variant strict|balanced|light|off
Компактный вывод по умолчанию
При выполнении engram load "<task>" вывод по умолчанию разбивается на уровни и сокращается для ИИ-агентов:
| Аспект | По умолчанию (engram load) | Полный (engram load --full) |
|---|---|---|
| Frontmatter | Не отображается; заголовок тела — ### <id> [<type>, <authority>] плюс requires: <ids> | Полная схема v3 и устаревшие поля, включая происхождение, ревизию, замещение и срок действия |
| Раскрытие | Первые load.expand_top совпадений — телами, остальные — однострочными карточками (- <id> [<type>] <directive-or-summary>), затем подсказка fetch: | Каждое упакованное тело |
| Тело правила | Один выбранный вариант | Content, плюс сохранённый раздел ## Rule Variants только если в файле есть собственные варианты |
| Прочие разделы | ## Context, ## Example и ## Origin не отображаются | То же содержимое, заголовок без изменений |
MCP engram_load и хуки по умолчанию используют многоуровневый вывод. Передайте full: true в инструмент MCP или используйте engram load --full "<task>", когда нужен более широкий устаревший вывод.
Необязательные поля маршрутизации
Эти поля frontmatter необязательны; воспоминание без них ведёт себя как раньше, а schema_version остаётся равной 3.
| Поле | Значение |
|---|---|
directive | Одна строка не длиннее 160 символов; показывается на карточках и учитывается с весом при ранжировании |
applies_to | Список glob-шаблонов; внедряет воспоминание, когда читается или редактируется подходящий файл, и считается сильным якорем |
tier | durable (по умолчанию) или working (привязано к задаче, исключено из Git, истекает) |
objective | До 200 символов; цель, для которой было записано рабочее воспоминание |
valid_until | Дата истечения; рабочее воспоминание получает сегодня + load.working_ttl_days |
Память, подкреплённая доказательствами
Новые файлы используют schema_version: 3. Воспоминания типов rule и skill по умолчанию получают authority: instruction; knowledge — authority: reference. revision начинается с 1 и увеличивается при обновлениях. Идентификаторы следов относятся к evidence_refs, а идентичности сессии или источника — к derived_from. Устаревшие v1 (Context + Content + Example) и v2 (Content, необязательный Origin) остаются читаемыми.
Дальнейшие шаги
Личность автора Git
Engram может хранить глобального автора и необязательное переопределение для рабочего пространства. Порядок разрешения: рабочее пространство, глобальный, затем резервный Git только для чтения. Настройки влияют только на будущие воспоминания; переопределение рабочего пространства никогда не меняет глобальную конфигурацию Git. Для синхронизации с глобальным Git или миграции устаревших воспоминаний используйте явный план и подтверждение.
engram author show
engram author set --name "Jane Doe" --email "jane@example.com"
engram author unset --scope workspace
engram author sync-git-global --plan
engram author sync-git-global --confirm
engram author migrate-memories --plan
engram author migrate-memories --confirm
Прочитайте полное руководство по настройкам автора Git.
Инвентаризация обновлений конфигурации
После обновления пакета выполните engram upgrade --latest --plan перед engram upgrade --latest. Общий инвентарь сканирует воспоминания, инструкции, skillset, конфигурации, хуки и плагины рабочего пространства и глобальной области, управляемые Engram. Байты, написанные пользователем, сохраняются; неоднозначные смешанные файлы сообщаются как конфликты. См. Обновления конфигурации.