Крэг: Инструмент с открытым исходным кодом создает единые правила для ИИ-агентов на основе конфигураций проектов.

Что делает Crag

Crag — это инструмент с открытым исходным кодом, который решает проблему расхождения конфигураций в нескольких файлах правил для ИИ-агентов программирования. Он анализирует существующие конфигурации вашего проекта и генерирует единый файл управления, а затем компилирует его во все необходимые файлы правил для различных ИИ-агентов.

Проблема, которую он решает

Разработчики, использующие несколько ИИ-агентов программирования, сталкиваются с проблемами управления конфигурациями. Согласно источнику, один разработчик поддерживал 12 файлов правил в 4 проектах (всего 48 файлов), включая:

• CLAUDE.md для Claude Code
• AGENTS.md для Codex
• .cursor/rules/ для Cursor
• copilot-instructions.md для Copilot
• CI-процессы для применения правил

Со временем эти файлы расходились, что приводило к проблемам, когда агенты писали код, который CI отклонял из-за несоответствия правил линтинга. Проблема оставалась незамеченной, потому что «никто не читает все 12 файлов».

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

Инструмент имеет две основные команды:

• crag analyze читает конфигурации вашего проекта, включая CI-процессы, package.json, tsconfig и конфигурации тестов
• crag compile --target all генерирует все файлы правил из единого файла управления

Анализ генерирует файл governance.md (~80 строк), который включает:

• Контрольные точки
• Архитектурные рекомендации
• Профиль тестирования
• Правила стиля кода
• Антипаттерны, которых следует избегать
• Соглашения по фреймворкам

Результат описывается как «автоматически сгенерированный, читается так, будто его написал старший инженер».

Технические детали

Crag имеет несколько примечательных технических характеристик:

• Не требует LLM
• Не имеет сетевых зависимостей
• Нулевые зависимости
• Детерминированный вывод
• Проверка SHA на разных платформах

Чтобы попробовать: npx @whitehatd/crag demo (убрать пробел между @ и whitehatd)

Источник и доступность

Инструмент имеет открытый исходный код и доступен на GitHub по адресу https://github.com/WhitehatD/crag.