Що таке engram?

Коли сесія закінчується, кодинг-агент забуває все. Наступна знову читає ті самі файли, пропонує підхід, від якого ви відмовилися місяць тому, і може повернути баг, який ви двічі виправляли. Довгі діалоги стискаються, і найпотрібніші деталі зникають першими.

engram дає агентові пам’ять. Він зберігає те, що пам’ятав би колега, і не чіпає те, що й так видно з коду:

• рішення та їхнє обґрунтування, зокрема відхилені варіанти й причини відмови;
• граблі: помилки, за які вже заплатили, і способи їх уникнути;
• принципи, тобто правила кодової бази («жодних ORM у гарячому шляху»);
• сесії: на чому зупинилася минула робота і що далі;
• факти, нотатки й обговорення, які варто зберегти.

Записи зв’язуються в граф (supersedes, rejected_because, caused_by, depends_on та інші), шукаються будь-якою мовою й віддаються агентам через Model Context Protocol.

Як цим користуватися

1. Один раз запустіть npx @vefimov/engram init у репозиторії.
2. Скажіть агентові: «використовуй engram».
3. Далі агент має:
   • починати завдання з короткого брифінгу: принципи, відповідні рішення, відомі граблі, де ви зупинилися;
   • нагадувати про минулі рішення, коли вони важливі («три тижні тому ми відмовилися від Redis через X»);
   • звіряти план зі старими граблями до написання коду;
   • записувати нові рішення й граблі в міру появи;
   • відповідати на «де ми обговорювали авторизацію?» за записом, навіть якщо це було сорок діалогів тому.

Чим це відрізняється від решти

Наявний підхід	Чого бракує	engram
Прості memory-плагіни	Плаский список нотаток	Граф з історією: заміщені й відхилені записи зберігаються
Вбудована пам’ять асистента	Прив’язана до одного інструмента й одного користувача	Локально, відкритий формат, будь-який MCP-клієнт
Пам’ять на одну сесію	Губиться під час зміни інструмента	Єдине сховище для всіх клієнтів проєкту
ADR, написані вручну	Люди забувають їх писати	Агент пише їх по ходу роботи, а вже наявні engram імпортує
Один великий CLAUDE.md	Завжди в контексті, застаріває, не зберігає історію	Дістається на запит у межах бюджету токенів

Принципи

• Пам’ять лежить у .engram/ вашого репозиторію. Немає сервера, акаунта й телеметрії.
• Джерело істини, відсортований JSONL, можна читати, порівнювати, рев’юїти й комітити.
• Використовується вбудований у Node node:sqlite з FTS5, тому компілювати нічого не треба і npx працює.
• Сервер говорить стандартним MCP. Skills і prompts пояснюють агентові, коли читати й писати.
• Якщо ви передумали, рішення заміщується. Старе лишається в історії.

Далі: швидкий старт.