Перейти к содержимому
MMW · Документация

Привязка к файлам и хуки Claude Code

Факт в памяти часто взят из файла: договора, заметки, конфигурации. Если файл потом исправили, а запись в памяти осталась прежней, агент будет уверенно повторять старое. Сервер MMW ваших файлов не видит, поэтому эту проверку делает локальный агент mmw-agent. Она есть во всех его версиях начиная с 0.1.4, в том числе в текущей. Как обновить агента до последней версии, описано на странице Обновление агента.

На этой странице:

  1. как привязать факт к файлу, ничего не вычисляя вручную;
  2. как поиск замечает, что файл изменился;
  3. как хуки Claude Code напоминают сохранить итог работы и подгружают память по проекту в начале сессии.

Укажите путь к файлу в 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 уже указан, агент его не меняет.
  • Содержимое файла с компьютера не уходит, отправляется только хеш.

При каждом поиске агент заново хеширует файлы-источники найденных записей и добавляет поле local_source:

local_sourceЧто значитstatus
unchangedфайл тот же, что при сохранениибез изменений
changedфайл изменился после сохраненияstale
missingфайла больше нетstale

Статус conflict важнее и не заменяется на stale. Записи без файла-источника остаются как есть.

С версии 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.

Оба хука ставит одна команда установки. Вручную:

  1. Откройте ~/.claude/settings.json (для всех проектов) или .claude/settings.json в проекте.

  2. Добавьте хуки:

    {
    "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" } ] }
    ]
    }
    }
  3. Перезапустите Claude Code.

  • Не следит за файлами в фоне: изменение замечается при поиске или в конце хода, а не в момент сохранения файла.
  • Не исправляет запись само: хук просит агента сохранить новую версию, решение остаётся за агентом и человеком.
  • Не проверяет факты, сохранённые без source_id. Указывайте источник всегда, когда факт взят из файла.