Привязка к файлам и хуки Claude Code
Факт в памяти часто взят из файла: договора, заметки, конфигурации. Если файл потом исправили, а запись в памяти осталась прежней, агент будет уверенно повторять старое. Сервер MMW ваших файлов не видит, поэтому эту проверку делает локальный агент mmw-agent. Она есть во всех его версиях начиная с 0.1.4, в том числе в текущей. Как обновить агента до последней версии, описано на странице Обновление агента.
На этой странице:
- как привязать факт к файлу, ничего не вычисляя вручную;
- как поиск замечает, что файл изменился;
- как хуки Claude Code напоминают сохранить итог работы и подгружают память по проекту в начале сессии.
Привязка при remember
Заголовок раздела «Привязка при remember»Укажите путь к файлу в source_id, и всё. Агент сам вычислит SHA-256 файла и передаст его в source_hash:
Запомни в MMW: оператор — физическое лицо. Источник: site-audit/RKN-NOTIFICATION.md{ "content": "оператор — физическое лицо", "source_id": "site-audit/RKN-NOTIFICATION.md", "source_hash": "sha256:5f1c…"}- Путь считается относительно корней источников: по умолчанию это папка, в которой клиент запустил агента (для Claude Code — папка проекта). Свои корни задаёт переменная
MMW_SOURCE_ROOTS(несколько путей через:в Linux и macOS, через;в Windows). - Файлы вне корней не читаются и не хешируются. Абсолютный путь тоже подходит, если он внутри корня.
- Идентификаторы, не похожие на путь (
session:…,https://…,owner-note), не трогаются. - Если
source_hashуже указан, агент его не меняет. - Содержимое файла с компьютера не уходит, отправляется только хеш.
Проверка при search
Заголовок раздела «Проверка при search»При каждом поиске агент заново хеширует файлы-источники найденных записей и добавляет поле local_source:
local_source | Что значит | status |
|---|---|---|
unchanged | файл тот же, что при сохранении | без изменений |
changed | файл изменился после сохранения | stale |
missing | файла больше нет | stale |
Статус conflict важнее и не заменяется на stale. Записи без файла-источника остаются как есть.
Хуки для Claude Code
Заголовок раздела «Хуки для Claude Code»С версии 0.1.12 агент ставит в Claude Code два хука. Первый напоминает сохранить итог работы, второй в начале сессии подгружает из памяти то, что уже известно о проекте.
Stop-хук: не закончить работу, не сохранив итог
Заголовок раздела «Stop-хук: не закончить работу, не сохранив итог»Команда mmw-agent hook-stop срабатывает, когда Claude Code собирается закончить ход. Хук читает журнал сессии с конца и считает, сколько работы сделано после последнего вызова remember:
- правка файла через Write, Edit или NotebookEdit в любой папке: 2 балла;
- команда, которая что-то меняет: 1 балл. Команды, которые только читают (
cat,ls,grep,git status,git logи подобные без записи в файл), баллов не дают; - действие на сервере (
ssh,scp,rsync,sudo,systemctl, скрипт выкладки,curlс POST, PUT или DELETE): 3 балла; - вызов инструмента MCP, который не только читает: 1 балл.
Если набралось 4 балла и больше (порог задаёт MMW_STOP_HOOK_THRESHOLD), ход не завершается. Claude получает список последних действий и просьбу сохранить решения и факты: путь к файлу в source_id, прежний fact_key для исправлений. Секреты в списке команд замаскированы.
Как ведёт себя хук:
- Блокирует не больше одного раза подряд. Если Claude решил, что сохранять нечего, второй Stop проходит (флаг
stop_hook_active). - Считает только работу этой сессии. Файлы, которые в той же папке пишет фоновый агент или сборка, хук не считает, если сама сессия ничего не меняла.
- Замечает работу вне текущей папки: правки в других каталогах, команды на сервере, выкладки.
- Ничего не отправляет по сети: проверка идёт по журналу Claude Code и git на вашем компьютере.
- Предупреждает о коде, которого нет нигде, кроме этого компьютера, и предлагает его отправить. Отправит только с вашего разрешения.
- Отключить на время:
MMW_STOP_HOOK=off.
SessionStart-хук: память по проекту в начале сессии
Заголовок раздела «SessionStart-хук: память по проекту в начале сессии»Команда mmw-agent hook-session-start срабатывает, когда сессия Claude Code начинается, продолжается, очищается или сжимается.
- В новой сессии он первыми показывает то, что сохранила предыдущая сессия Claude Code в этой же папке: до 10 последних записей. Это работает в любой папке, в том числе в домашней, и без обращения к серверу.
- В git-репозитории хук дополнительно ищет в MMW записи по имени проекта и показывает до 8 из них: сначала факты с
fact_key, затем остальные. - После сжатия контекста он первыми ставит то, что Claude сохранил в этой сессии до сжатия: последние 15 записей, по одной на каждый
fact_key. - Вне git-репозитория поиск по серверу не делается.
- Ключ берётся из
MMW_API_KEYили из настроек MMW в~/.claude.jsonи нигде не выводится. - Хук никогда не мешает начать работу: без ключа, без сети или если сервер не ответил за 4 секунды он молча пропускает шаг.
- Отключить:
MMW_SESSION_HOOK=off.
Установка
Заголовок раздела «Установка»Оба хука ставит одна команда установки. Вручную:
-
Откройте
~/.claude/settings.json(для всех проектов) или.claude/settings.jsonв проекте. -
Добавьте хуки:
{"hooks": {"Stop": [{ "hooks": [ { "type": "command","command": "uvx --from https://app.mmwhub.ru/downloads/mmw-agent/mmw_agent-0.1.14-py3-none-any.whl mmw-agent hook-stop" } ] }],"SessionStart": [{ "hooks": [ { "type": "command", "timeout": 30,"command": "uvx --from https://app.mmwhub.ru/downloads/mmw-agent/mmw_agent-0.1.14-py3-none-any.whl mmw-agent hook-session-start" } ] }]}} -
Перезапустите Claude Code.
Чего это не делает
Заголовок раздела «Чего это не делает»- Не следит за файлами в фоне: изменение замечается при поиске или в конце хода, а не в момент сохранения файла.
- Не исправляет запись само: хук просит агента сохранить новую версию, решение остаётся за агентом и человеком.
- Не проверяет факты, сохранённые без
source_id. Указывайте источник всегда, когда факт взят из файла.