Claude Memory Engine

---

ПРОБЛЕМА — Каждый новый разговор Claude начинает с нуля

• Баг, на который вы потратили 30 минут в прошлой сессии — снова та же стена
• Ваши предпочтения, правила проекта — исчезают в момент старта новой сессии
• Переключились с проекта A на проект B — Claude не понимает, где он находится
• Длинные разговоры «размываются» — важные решения пропадают после сжатия контекста
• Файлы памяти накапливаются — никто их не организует, они просто растут
• Компьютер умер — локальная память потеряна, резервных копий нет

Инструменты памяти помогают Claude «помнить». Но помнить — не то же самое, что учиться.

---

ЗАЧЕМ — Потому что он учится

Memory Engine не просто помогает Claude запоминать — он учит Claude учиться, как студент:

• Ошибки не повторяются — сохраняется и проблема, и её решение
• Смена проекта не означает начало с нуля — Claude знает, над чем вы работаете
• Со временем становится лучше — с каждым циклом понимает вас чуть глубже
• Вы видите, как он учится — всё это markdown и JS, никакого чёрного ящика

---

КАК — Через цикл студента

• Цикл студента — 8-шаговый цикл обучения, как подготовка к экзамену, только с каждым разом лучше
• Умный контекст — автоматически загружает память нужного проекта на основе рабочей директории
• Автообучение — при столкновении с проблемой сохраняет и её, и решение; одна и та же ошибка не повторяется

:brain: Цикл студента

Представьте подготовку к экзамену. Идея в том, чтобы Claude Code вёл себя как студент на сессии — делал заметки после каждого занятия, систематизировал их, искал паттерны, вёл тетрадь ошибок и проводил итоговый разбор. С каждым циклом — чуть лучше.

На занятии (автоматически, запускается каждую сессию)

У разговора в Claude Code нет настоящего «конца» — он может закрыться, уйти в простой или сжаться. Поэтому Memory Engine не полагается на один момент. Вместо этого сохранение происходит в трёх точках:

1. Каждые 20 сообщений (mid-session-checkpoint) — сохраняет чекпоинт и мини-анализ. Самая надёжная точка сохранения: счётчик сообщений ведётся самостоятельно
2. Перед сжатием контекста (pre-compact) — срабатывает прямо перед сжатием. Сохраняет снимок, обнаруживает ловушки, запускает резервное копирование. Контекст в этот момент наиболее полный, поэтому обнаружение ловушек здесь наиболее точное
3. При завершении разговора (session-end) — сохраняет итоговое резюме и резервную копию. Хорошо, если срабатывает, но не гарантировано (окно может просто закрыться)

Вам не нужно помнить о запуске команды перед закрытием — важное уже сохранено до того, как вы закроете окно.

Помимо этого, Claude также:

• Делает заметки — фиксирует, что было сделано, какие файлы изменились, какие решения приняты
• Связывает их — помечает проект, связывает с предыдущими заметками
• Ищет паттерны — сканирует сигналы ловушек (5+ повторных попыток, ошибки с последующими исправлениями, правки пользователя)

Итоговый разбор (вручную, запустите /reflect)

После нескольких дней заметок запустите /reflect, и Claude:

4. Просмотрит — прочитает заметки и записи ловушек за последние 7 дней, отметит актуальное и устаревшее
5. Уточнит — применит четыре вопроса: Оставить? → Сжать? → Уже покрыто правилом? → Удалить только в крайнем случае
6. Переосмыслит — повторно проанализирует очищенные данные, найдёт паттерны, скрытые в шуме
7. Сократит — перечислит элементы для удаления, дождётся вашего подтверждения перед удалением
8. Подведёт итог — сформирует отчёт: что усвоено, что изменилось, за чем следить в следующем цикле

Это не разовое действие. Каждый цикл делает заметки точнее, паттерны чище, ошибок меньше. Петля, которая постоянно улучшается.

:pencil2: Цикл исправлений

Некоторые ошибки не попадают в логи. Вы исправляете результат, и только тогда Claude понимает: «ах, это было неправильно». Такие ошибки не запоминаются автоматически — если только не завести тетрадь ошибок.

Запись (/analyze, вручную — запускайте сразу после исправления)

• Вы исправляете его работу, вводите /analyze
• Он сравнивает обе версии с существующими правилами
• Известные правила, которые были нарушены → записываются, счётчик растёт
• Паттерны, которых ещё нет в правилах → превращаются в новые
• Чем раньше запустите, тем свежее контекст

Повторение (автоматически: перед каждой задачей / вручную: введите /correct в любой момент)

• Перед началом работы автоматически сканирует тетрадь ошибок
• Не переобучение — просто напоминание: «я ошибся здесь в прошлый раз, не повторять»
• Хотите просмотреть самостоятельно? Введите /correct — не нужно ждать задачи или цикла

Очистка (шаг 6 /reflect, вручную)

• Периодически сканирует всю тетрадь
• Одна и та же ошибка 3+ раза → повышается до жёсткого правила
• Уже усвоено → помечается как закрытое, освобождает место

Но вы знаете, что с этого момента ваш AI вырос ещё немного.

Можно просто ввести /correct напрямую? Да. /correct работает в любой момент — не нужно ждать задачи или цикла. Просто открывает тетрадь ошибок и показывает активные записи.

Как часто запускать /reflect? Раз в несколько дней или когда накопится достаточно заметок. Нет жёсткого расписания — запускайте, когда чувствуете, что пора подвести итоги.

Что если я закрою окно, не запустив /reflect? Всё в порядке. Автоматические сохранения (mid-session-checkpoint и pre-compact) уже зафиксировали важное. /reflect — это углублённый разбор, а не обязательный шаг для сохранения данных.

Это работает с несколькими проектами? Да. Умный контекст определяет рабочую директорию и загружает память соответствующего проекта автоматически.

Где хранятся данные? Только локально, в markdown-файлах. Никаких облаков, никаких внешних сервисов.