ai-rulez CLI
Единый каталог правил генерирует инструкции, скиллы, MCP и настройки для 52 ИИ-ассистентов кода и проверяет их в CI
- 169 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Команда generate перезаписывает файлы ассистентов в репозитории, включая `AGENTS.md` и `CLAUDE.md`
- Удаленные включения подтягивают чужие правила и скиллы, поэтому их закрепляют в файле блокировки
Установка
- Работает в
Ручная установка
npx ai-rulez@latest init acmeСоздает `.ai-rulez/`, затем пресеты задают в `.ai-rulez/config.toml`, а файлы создает `ai-rulez generate`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Команда generate перезаписывает файлы ассистентов в репозитории, включая `AGENTS.md` и `CLAUDE.md`
- Удаленные включения подтягивают чужие правила и скиллы, поэтому их закрепляют в файле блокировки
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
ai-rulez хранит инструкции для ассистентов кода в каталоге `.ai-rulez/`: правила, контекст, скиллы, агентов, команды, хуки, права и MCP-серверы. По этому источнику команда `generate` создает родные файлы каждого инструмента: `AGENTS.md`, `CLAUDE.md`, `.cursor/rules/`, `.github/instructions/`, каталоги скиллов, файлы MCP и настроек. Встроено 52 пресета, от Claude Code, Cursor, Codex и Copilot до Gemini CLI, Goose, Kiro, OpenCode и Qwen Code. Старт занимает полминуты: `npx ai-rulez@latest init acme`, затем пресеты в `.ai-rulez/config.toml`, например `presets = ["claude", "cursor", "codex", "copilot", "gemini"]`, и правило командой `add rule`. Проверка в CI идет так: `generate --check` ловит расхождения, а `validate` проверяет содержимое, ссылки и безопасность с кодами правил `AR`, и работает даже на обычных `AGENTS.md` и `SKILL.md`. Управление похоже на зависимости. Файл блокировки фиксирует удаленные включения, установленные скиллы и созданное содержимое, а подписи Sigstore, SBOM и политика организации закрывают остальное. Из того же источника собирают плагины, маркетплейсы и манифесты Agent Plugins.
Для кого. Командам, где разные разработчики используют разных ассистентов и правила нужно вести в одном месте, без десятка файлов.
Подходит, если
- Часть команды сидит на Cursor, часть на Claude Code, и правила тестирования должны совпадать у всех
- В CI надо поймать расхождение сгенерированных файлов командой `ai-rulez generate --check`
- Папки скиллов и `SKILL.md` лежат в репозитории, и их качество и безопасность проверяет `ai-rulez validate`
- Правила организации подтягиваются как удаленное включение, закрепленное в файле блокировки
- Пакет с плагином и манифестом Agent Plugins собирается из того же источника для публикации
Не подходит, если
- Команда использует одного ассистента и один файл `CLAUDE.md`: генератор добавит лишний слой
- Нужно править файлы ассистентов вручную в каждом инструменте: следующая генерация перезапишет сгенерированное
- Нужен только перенос правил между двумя форматами один раз: хватит ручного копирования
Пример запроса к агенту
Инициализируй ai-rulez в этом репозитории с пресетами claude, cursor и codex, добавь правило «каждое исправление ошибки идет с регрессионным тестом» и сгенерируй файлыОграничения
Генерируемые файлы ассистентов нужно считать производными: ручные правки в них перезапишет следующий запуск `generate`, а редактировать нужно `.ai-rulez/`. Разные ассистенты принимают разные наборы возможностей, и таблица «Supported harnesses» в документации показывает, что получает каждый из 52 пресетов. Для npm нужен Node.js 22 или новее, для PyPI Python 3.11 или новее. Установка через Go использует путь с суффиксом `/v5`. Версия конфигурации в примере 5.0, старые проекты могут потребовать миграции.
Как отключить. Удалите каталог `.ai-rulez/` и сгенерированные файлы вроде `AGENTS.md`, `CLAUDE.md` и `.cursor/rules/`, если они больше не нужны. Сам CLI снимает `npm uninstall -g ai-rulez` или `brew uninstall ai-rulez`.
Частые вопросы
Как установить ai-rulez?
`brew install goldziher/tap/ai-rulez`, `npm install -g ai-rulez`, `pipx install ai-rulez` или `go install github.com/Goldziher/ai-rulez/v5/cmd/ai-rulez@latest`. Без установки работает `npx ai-rulez@latest <команда>` или `uvx ai-rulez <команда>`.
Какие файлы создает generate?
Для выбранных пресетов: `AGENTS.md`, `CLAUDE.md` с импортом `@AGENTS.md`, каталоги `.agents/skills/` и `.claude/skills/`, а также файлы MCP вроде `.mcp.json`, `.cursor/mcp.json`, `.vscode/mcp.json` и `.codex/config.toml`.
Как поймать расхождение в CI?
Добавьте шаг `ai-rulez generate --check`: он завершится ошибкой, если сгенерированные файлы не совпадают с источником. `ai-rulez validate` дополнительно проверит содержимое, ссылки и безопасность.
Поддерживается ли мой ассистент?
В списке 52 встроенных пресета, от Claude Code, Cursor, Codex и Copilot до Gemini CLI, Goose, Kiro, OpenCode, Qwen Code и Warp. Недостающий инструмент добавляют как собственный пресет.
Чем ai-rulez отличается от Rulesync и Ruler?
Все три раскладывают инструкции из одного источника по ассистентам. У ai-rulez есть проверка validate с кодами правил, файл блокировки с подписями Sigstore и SBOM, а также сборка плагинов и манифестов Agent Plugins.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыAI-RULES превращает архитектурные правила проекта в навык и промпты, по которым агент проверяет код и правит найденные нарушения.
CLI, который держит правила, команды, MCP, субагентов и скиллы в одном источнике и раскладывает их по конфигам разных ИИ-агентов
CLI разбирает репозиторий шестифазным конвейером моделей и пишет AGENTS.md или CLAUDE.md; ведет планы ExecPlan с вехами.
AI Code Toolkit
aicode-toolkit
Плагины и MCP-серверы для агента: проекты из шаблонов, паттерны перед правкой файла и ревью по правилам из YAML.
Скилл анализирует репозиторий и создает файлы для ИИ-агентов: AGENTS.md, указатели, рецензенты, CI и шаблоны
CLI, который хранит инструкции для агента в одном месте и раскладывает их по нужным конфигам Claude Code, Cursor, Codex, Copilot и еще двух десятков инструменто
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| ai-rulez (эта карточка) | нет | 169 | |
| Rulesync | нет | 1 600 | один источник правил, команд, MCP и скиллов, а здесь еще проверка validate с кодами правил, файл блокировки и сборка плагинов |
| Ruler | нет | 2 971 | раскладывает инструкции по конфигам ассистентов, а здесь 52 пресета, права, хуки и подписанные включения |
Коротко о README
README называет проект единым источником правил, скиллов и настроек для всех ассистентов, показывает пример за тридцать секунд и список генерируемых файлов. Затем идут четыре способа установки, таблица из 52 пресетов с названиями инструментов и ссылки на документацию.