module-gates — плагин
Хуки для Claude Code и pi блокируют правки, нарушающие контракты модулей MODULE.md: readonly и запрет новых экспортов.
- 56 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Хуки выполняются на каждой операции записи агента и блокируют ее, а установка вариантом без плагина правит `.claude/settings.json`.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add plugins/module-gatesОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Хуки выполняются на каждой операции записи агента и блокируют ее, а установка вариантом без плагина правит `.claude/settings.json`.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
module-gates ограничивает хаос в кодовой базе, который накапливают агенты. В каждом каталоге можно положить файл-описание `MODULE.md` и перечислить в нем защищенные файлы. Метка `readonly` запрещает править файл, а `no-new-exports` разрешает менять тело, но запрещает добавлять новые экспорты. Хук перехватывает операции записи и редактирования агента и блокирует нарушения с объяснением причины. Агент вынужден пересмотреть проект решения. Дополнительно запрещен импорт внутренних файлов модуля снаружи: импортировать можно только через `index.ts` или `mod.rs`. При старте сессии проект сканируется, а в системный запрос добавляется подсказка. Поддерживаются TypeScript и JavaScript, Rust, Java, Go, Kotlin и Scala.
Для кого. Командам, где агенты пишут много кода и нужно удержать границы модулей и публичный интерфейс от случайного роста.
Подходит, если
- Агент не должен трогать сгенерированный или утвержденный файл, и его помечают как `readonly`.
- Публичный интерфейс модуля закрепляют, а новые функции допускаются только внутри тел.
- Внешним файлам разрешают импорт лишь через `index.ts`, и обход проверяют на каждой правке.
- Дисциплину модулей хотят держать одинаково в Claude Code и pi.
Не подходит, если
- Репозиторий небольшой, и ограничения только замедлят работу.
- Основной язык проекта не входит в список поддерживаемых.
- Нужна проверка импортов по видимости: она в README помечена как еще не реализованная.
Пример запроса к агенту
Добавь в каталог billing файл MODULE.md с readonly для legacy.ts и no-new-exports для api.ts, затем попробуй добавить новую функцию в api.ts.Ограничения
Хуки срабатывают на операции записи и редактирования агента и не видят правок, сделанных вне агента. Файл-описание по умолчанию называется `MODULE.md`. Проверка импортов по области видимости пока не реализована. Для Claude Code плагин при первом вызове ставит зависимости в свой каталог, а вариант с обычными хуками требует пакета в проекте и пишет `PreToolUse` и `SessionStart` в `.claude/settings.json`. Поддержка Cursor и других агентов требует отдельного моста, а список языков конечен.
Как отключить. Выполните `npx module-gates uninstall-claude`, чтобы убрать хуки, или удалите плагин командой `/plugin uninstall module-gates@cuzfrog`.
Частые вопросы
Как поставить плагин в Claude Code?
Выполните `/plugin marketplace add cuzfrog/module-gates`, затем `/plugin install module-gates@cuzfrog`. Вход не нужен, репозиторий публичный.
Как работают метки в MODULE.md?
`readonly` запрещает любые правки файла. `no-new-exports` допускает правку тела, но блокирует новые экспорты.
Что происходит при нарушении?
Хук блокирует запись и называет причину. Агент видит отказ и вынужден изменить подход.
Можно ли обойтись без плагина?
Да: `npm install --save-dev @cuzfrog/module-gates`, затем `npx module-gates install-claude`. Команда пишет хуки в `.claude/settings.json`.
Какие агенты поддерживаются?
pi, Claude Code и Devin CLI. Для остальных, например qwen-code или Cursor, нужен новый мост.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныДесять плагинов для Claude Code: панели и полосы над промптом, защита секретов, фильтр расплывчатых запросов и уборка памяти.
Общие настройки Claude Code для команды: хуки против опасных команд, проверка перед завершением и скиллы от спецификации до ревью
Плагин для Claude Code ограничивает агента правилами и хуками, а независимую проверку кода отдает Codex CLI в цикле ревью.
Считает, какие файлы импортируют друг друга и что заденет правка, и отдает это агенту через хуки, MCP и команду codemap
Плагины для git, Python и доступности в одном месте: более 400 скиллов, субагенты и хуки против опасных команд.
CLI и маркетплейс из сотен плагинов Claude Code: хуки с линтерами и тестами, скиллы по языкам и фреймворкам, агенты по дисциплинам
Коротко о README
Контракты модулей описываются файлами в каталогах, а хук проверяет каждую запись агента. Блокировка показывает пример отказа на добавлении двух публичных функций. Поддержка других агентов добавляется мостом.