Archgate CLI
Archgate превращает архитектурные решения в исполняемые правила и блокирует нарушения в CI, хуках и работе ИИ-агентов
- 74 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Исполняет файлы `.rules.ts` из репозитория как код во время проверки, поэтому чужие правила нужно читать перед запуском
- Плагины ставят хуки и правила в настройки редактора и агента, для них нужен вход через GitHub
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/archgateОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Исполняет файлы `.rules.ts` из репозитория как код во время проверки, поэтому чужие правила нужно читать перед запуском
- Плагины ставят хуки и правила в настройки редактора и агента, для них нужен вход через GitHub
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Archgate хранит решения команды в каталоге `.archgate/adrs/` двумя слоями. Первый слой — Markdown-файл ADR с YAML-шапкой: что решили, почему и что делать или не делать. Второй слой — парный файл `.rules.ts`, который экспортирует автоматические проверки этого решения. Команда `archgate check` прогоняет проверки по кодовой базе и показывает файл, строку и нарушенный ADR. Код выхода 1 означает нарушения, поэтому шаг легко ставится в CI и в хук `pre-commit` и блокирует слияние. Начать можно с `archgate init`: он создает структуру и шаблон ADR, затем вы описываете реальное решение и добавляете к нему проверку. ИИ-агенты читают те же правила до написания кода. Для этого у Archgate есть плагины для Claude Code, Cursor, VS Code, Copilot CLI и OpenCode. Команда `archgate init` после `archgate login` ставит плагин сама, и агент проверяет изменения по ADR и записывает новые закономерности обратно. Без плагинов CLI работает полностью, аккаунт для него не нужен.
Для кого. Техлидам и командам, у которых архитектурные договоренности лежат в вики, и агенты с людьми регулярно их нарушают.
Подходит, если
- Решение вроде «слой доменa не импортирует инфраструктуру» нужно превратить в проверку, которая падает в CI
- Агент пишет код быстрее, чем вы успеваете ревьюить, и нужен автоматический барьер перед слиянием
- Команда хочет хранить ADR рядом с кодом, не в вики, и чтобы агент читал их до начала работы
- Нужен хук `pre-commit`, который отклоняет коммиты с нарушением конкретного ADR
Не подходит, если
- В проекте нет ни ADR, ни желания их вести: сначала нужны решения, потом правила
- Нужен статический анализ типов или стиля: для этого есть линтеры и компиляторы, Archgate проверяет проектные решения
- Вы хотите готовый набор правил из коробки: правила в `.rules.ts` пишет команда сама
Пример запроса к агенту
Подключи Archgate к репозиторию, запиши решение «домен не зависит от инфраструктуры» как ADR с проверкой и прогони archgate checkОграничения
- Правила пишутся на TypeScript в файлах `.rules.ts`, значит их нужно уметь сочинять и поддерживать.
- Плагины для редакторов требуют команду `archgate login`: вход через GitHub, одноразовый для машины.
- Полный список способов установки и поддерживаемых платформ лежит в документации, README называет npm, pip, dotnet, Go, gem, Maven и proto.
- Проверка идет по правилам команды, поэтому покрытие архитектуры определяет качество вашего набора ADR.
Как отключить. Удалите каталог `.archgate/` из проекта и снимите шаг `archgate check` из CI и хука коммита. Плагин для редактора удаляется средствами самого агента, например командой `claude plugin uninstall` в Claude Code. Саму утилиту удаляйте тем же менеджером пакетов, которым ставили.
Частые вопросы
Что такое ADR в Archgate?
ADR — Markdown-файл в `.archgate/adrs/` с YAML-шапкой, где записано решение, причина и что делать. Если рядом лежит файл `.rules.ts`, решение проверяется автоматически.
Как подключить Archgate к CI?
Добавьте шаг `archgate check` в пайплайн. Код выхода 1 при нарушениях останавливает слияние, в отчете указаны файл, строка и ADR. Тот же вызов подходит для pre-commit хука.
Нужен ли аккаунт?
Для CLI аккаунт не нужен: написание ADR, проверки, CI и хуки работают бесплатно. Аккаунт нужен лишь для плагинов редакторов: команда `archgate login` входит через GitHub.
Какие агенты и редакторы поддерживаются?
Плагины есть для Claude Code, Cursor, VS Code, Copilot CLI и OpenCode. Агент читает ADR перед работой и проверяет изменения по правилам.
Чем Archgate отличается от линтера?
Линтер проверяет стиль и типичные ошибки кода. Archgate проверяет ваши собственные решения: границы слоев, соглашения команды и выводы из прошлых обсуждений, записанные как ADR.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыGit-нативный контекст проекта для агентов: спецификации, решения и правила лежат в Markdown рядом с кодом и читаются перед правкой
AI-RULES превращает архитектурные правила проекта в навык и промпты, по которым агент проверяет код и правит найденные нарушения.
CLI оценивает архитектуру проекта по AST от 0 до 100, находит антипаттерны и по запросу ведет рефакторинг с ИИ.
Плагин Claude Code ведет архитектуру проекта: ADR, ревью разными ролями, перенос выводов в план и прагматичный режим.
Слой правил для агентного кодинга: обязательные гейты на тесты, ревью, безопасность и решения, единые для Claude Code, Codex CLI и Pi
Единый каталог правил генерирует инструкции, скиллы, MCP и настройки для 52 ИИ-ассистентов кода и проверяет их в CI
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
Коротко о README
README подает Archgate как корпоративный линтинг для работы ИИ. Два слоя, ADR как документы и ADR как правила, показаны на дереве `.archgate/adrs/`. Дальше идут быстрый старт из четырех шагов, ссылка на руководство по установке и блок о плагинах для Claude Code, Cursor, VS Code, Copilot CLI и OpenCode. В конце даны ссылки на документацию, сообщество на Reddit и правила вклада, лицензия Apache-2.0.