Architect Genesis CLI
CLI оценивает архитектуру проекта по AST от 0 до 100, находит антипаттерны и по запросу ведет рефакторинг с ИИ.
- 56 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Команда `architect execute` правит файлы проекта через модель, а запросы к ней уходят провайдеру.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/architect-genesisОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Команда `architect execute` правит файлы проекта через модель, а запросы к ней уходят провайдеру.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Architect Genesis разбирает код через Tree-Sitter, строит граф зависимостей и ставит архитектуре оценку от 0 до 100. Поддерживаются TypeScript, Python, Go, Java, Rust, Ruby и PHP. Слои, стек и предметную область инструмент определяет сам. Вес четырех измерений оценки подстраивается под стек. Основные команды: `architect analyze ./src` для разбора, `architect check ./src` для проверки правил из `.architect.rules.yml`, `architect forecast ./src` для прогноза распада по истории git и `architect execute ./src` для рефакторинга с помощью Claude, GPT или Gemini. Отдельный MCP-сервер открывает те же возможности клиентам Claude Code и Cursor через девять инструментов.
Для кого. Техлидам и разработчикам, которые отслеживают здоровье архитектуры и хотят подключить проверку к агентам и CI.
Подходит, если
- Перед рефакторингом нужно увидеть граф зависимостей и список антипаттернов.
- Падение оценки ниже порога из `.architect.rules.yml` должно ломать проверку в CI.
- Команда хочет знать по истории git, куда архитектура деградирует.
- Агент в Claude Code запрашивает оценку и подсказки по рефакторингу через MCP.
Не подходит, если
- Проект написан на языке вне списка из семи.
- Автоматический рефакторинг через ИИ без ручного ревью недопустим.
- Нужен анализ безопасности кода: инструмент оценивает структуру.
Пример запроса к агенту
Проанализируй `./src` через architect, покажи оценку, антипаттерны и три самых полезных шага рефакторинга.Ограничения
Для CLI нужен Node.js 18 или новее. Команда `architect execute` меняет файлы с помощью модели, поэтому нужен ключ выбранного провайдера и ревью результата. Оценка зависит от самого проекта и весов, которые инструмент подбирает под стек, и абсолютной истиной не служит. База знаний `kb` хранит историю оценок, и прогноз строится на линейной регрессии. В README есть реклама платной команды разработки того же автора, а сам инструмент открыт под лицензией MIT. Репозиторий содержит много служебных заметок и шаблонов релиза.
Как отключить. Удалите пакет командой `npm uninstall -g @girardelli/architect`, а если ставили MCP, уберите его запись из конфигурации клиента.
Частые вопросы
Как поставить Architect и запустить разбор?
Выполните `npm install -g @girardelli/architect`, затем `architect analyze ./src`. Настройка не нужна: стек и предметную область инструмент определяет сам.
Как подключить MCP-сервер?
Добавьте в конфигурацию клиента запуск `npx @girardelli/architect-mcp`. Он открывает девять инструментов, среди них `analyze_project`, `get_score` и `suggest_refactoring`.
Как задать правила для проверки?
Опишите их в `.architect.rules.yml`, например минимальную общую оценку `min_overall_score`. Команда `architect check` сверит проект с этими правилами.
Что делает `architect forecast`?
Читает историю git и по линейной регрессии предсказывает, как оценка будет падать дальше. Результаты сохраняются в базе знаний, а `architect kb history .` показывает динамику.
Какие языки поддерживаются?
TypeScript, Python, Go, Java, Rust, Ruby и PHP. Разбор идет через Tree-Sitter.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыArchgate превращает архитектурные решения в исполняемые правила и блокирует нарушения в CI, хуках и работе ИИ-агентов
Плагин Claude Code ведет архитектуру проекта: ADR, ревью разными ролями, перенос выводов в план и прагматичный режим.
Плагин Claude Code, который расспрашивает про задачу, проектирует архитектуру и пишет самодостаточный план для сборки
Git-нативный контекст проекта для агентов: спецификации, решения и правила лежат в Markdown рядом с кодом и читаются перед правкой
Скилл делает агента архитектурным тренером: вопросами ведет к ADR, схеме и плану развития, чужой репозиторий разбирает по коду
CodeGraph на Rust
codegraph-rust
Граф кода для агента на Rust: четыре MCP-инструмента показывают, что заденет правка, как устроена архитектура и где хрупкие места проекта
Коротко о README
Инструмент строит граф зависимостей, оценивает слои и вес измерений по стеку, а база знаний хранит историю оценок. Есть четыре агента: ревью, прогноз, рефакторинг и каркас модулей. Расширение для VS Code показывает оценки в CodeLens.