Интерактивные схемы архитектуры в одном HTML-файле: установка и разбор скилла Archify для Claude
Скилл генерирует автономный HTML с интерактивной схемой по текстовому описанию или кодовой базе и набрал 91,9 тысячи звёзд на GitHub.
Open-source проект Archify набрал 91,9 тысячи звёзд на GitHub и вышел в тренды среди инструментов для ИИ-агентов. Главная идея проекта — превратить текстовое описание системы или существующую кодовую базу в автономный интерактивный HTML-файл. Полученный документ открывается в любом браузере без установки внешних библиотек, подключения к серверу или сборки окружения.
Что умеет скилл и зачем нужен один HTML-файл
В отличие от традиционных генераторов вроде Mermaid, создающих статичные SVG или растровые картинки, Archify выдаёт полноценное интерактивное приложение в одном файле. Его можно отправить вложением в письме, прикрепить к pull request или положить на статический веб-сервер.
- Интерактивный просмотрщик поддерживает переключение светлой и тёмной темы по клавише T.
- В документе работает поиск узлов и конечных точек маршрутов по клавише /.
- Режим Route Journey по клавише R позволяет пошагово проигрывать путь прохождения запросов между узлами.
- Встроенное меню по клавише E экспортирует диаграмму в форматах PNG, JPEG и WebP с разрешением до 4×, а также в SVG и анимацию WebM.
- Узлы архитектуры могут содержать прямые ссылки на конкретные строки файлов и коммиты в репозиториях GitHub или GitLab.
Установка скилла в Claude Code
Подключить Archify к Claude Code можно двумя способами: через чтение файла спецификации для языковых моделей или прямой установкой пакета через CLI.
Первый вариант — передать Claude Code команду прочитать официальный файл llms.txt:
Второй вариант — установить скилл глобально для Claude Code через пакетный менеджер skills:
Для подключения только в рамках текущего проекта флаг --global не указывается:
Работоспособность окружения проверяется встроенной утилитой диагностики:
10 поддерживаемых типов диаграмм
Инструмент поддерживает десять видов визуализации, для каждого из которых заложены индивидуальные правила размещения элементов и связей:
- Architecture — обзор компонентов, микросервисов, баз данных и границ доверия.
- Workflow — пайплайны развёртывания, процессы согласования и ранбуки инцидентов.
- Sequence — диаграммы последовательности взаимодействия: API-вызовы, авторизация и работа кэша.
- Data Flow — конвейеры передачи данных, границы чувствительной информации (PII) и системы-потребители.
- Lifecycle — диаграммы состояний: переходы, тайм-ауты, повторные попытки и завершение процессов.
- ERD — схемы баз данных с таблицами, колонками, типами полей, первичными и внешними ключами.
- Class — объектные структуры: интерфейсы, классы, наследование и связи зависимостей.
- Tree — древовидные иерархии репозиториев, модулей и каталогов.
- Timeline — хронологические шкалы релизов и разборов инцидентов с привязкой к часовым поясам.
- Waterfall — распределение времени выполнения запросов и спанов агента.
Как запускать генерацию: от описания или от кода
Сформировать схему можно прямым описанием архитектуры на естественном языке без предварительной подготовки проекта:
При наличии локального репозитория агент может изучить структуру проекта и составить диаграмму рантайма по реальным файлам:
Двухэтапная валидация и квитанции об ошибках
В отличие от решений, где модель сразу генерирует неструктурированный код визуализации, Archify использует промежуточное представление — типизированный JSON IR. Агент сначала составляет манифест по строгой схеме данных.
Перед записью готового файла встроенный валидатор проверяет геометрию графа, расстояния между линиями, читаемость подписей и отсутствие наложения стрелок. Если проверка выявляет дефект верстки, инструмент возвращает структурированную квитанцию с кодом ошибки и правилом её устранения. Это позволяет модели точечно исправить спорный узел без повторной генерации схемы с нуля.
Новое в версии 3.2.0: формат ответов explainer
В релизе v3.2.0 от 19 октября 2026 года появился формат explainer — генерация одностраничных ответов из черновика Markdown. Документ строится по принципу «сначала вывод»: каждая панель последовательно раскрывает одну подтему, объединяя текст, таблицы, шаги инструкций, фрагменты кода и интерактивные диаграммы.
Страница формируется в одном из четырёх стилей оформления (clean, editorial, product, Swiss), поддерживает экспорт в PDF и длинные изображения PNG или WebP, а также позволяет читателю выделить абзац и скопировать готовый уточняющий промпт для агента.
Ограничения инструмента
- Для работы CLI-сборщика требуется локальное окружение Node.js.
- Инструмент ориентирован на схемы и диаграммы — генерация произвольных растровых иллюстраций или художественной графики не предусмотрена.
- Валидатор контролирует структуру данных и геометрию графа, но не проверяет фактическую работоспособность описываемой инфраструктуры.
- Привязка узлов к исходному коду требует зафиксированных коммитов в публичном репозитории.
Всё самое интересное — в нашем Telegram-канале «Claude без воды».