Mneme: Предварительный хук, блокирующий правки кода Claude, нарушающие архитектурные решения

Маркус Диллав разработал Mneme — хук PreToolUse, который перехватывает правки Claude Code и сверяет их с записанным файлом архитектурных решений до того, как они будут записаны на диск. Цель: предотвратить повторное появление запрещённых библиотек, отклонённых паттернов и забытых соглашений в новых файлах.

Установка

pip install mneme
python scripts/install_claude_code.py

Эта команда добавляет запись хука в .claude/settings.json и устанавливает четыре слэш-команды:

• /mneme-check — проверить на нарушения
• /mneme-context — получить контекст для текущего файла
• /mneme-record — записать новое решение
• /mneme-review — просмотреть существующие решения

Как это работает

Когда Claude пытается выполнить правку, Mneme сравнивает операцию с решениями, проиндексированными по ключевым словам. Если обнаружено нарушение, хук блокирует операцию и возвращает ID решения в качестве обратной связи. Claude видит ограничение, понимает причину и корректирует свой вывод — ручное вмешательство не требуется.

Хук отказоустойчив: если Mneme не найден в PATH или происходит таймаут, он завершается с кодом 0, и Claude Code продолжает работу в обычном режиме. Он блокирует только тогда, когда mneme check действительно возвращает вердикт о нарушении.

Граничные случаи

Поиск основан на ключевых словах, поэтому область действия решений имеет значение. Автор активно ищет отзывы из реальных проектов о том, правильно ли срабатывает хук в production-среде.