Archify: агент, который разбирает архитектуру вашего проекта и рисует по ней проверенные схемы

Не у каждого проекта есть схема архитектуры. Если она и была, её нарисовали давно, забросили, и с тех пор проект уехал далеко вперёд. А если проект вайб-кодился, схемы не было никогда: сервисы, интеграции и вебхуки появлялись по одному запросу к агенту, и через пару месяцев самому лезть и разбираться, что где лежит и кто с кем связан, тяжело и непонятно, потому что слишком много всего.

Archify для этого и нужен. Это не редактор диаграмм, а навык для агента: Claude Code, Cursor или Codex сами исследуют репозиторий, находят компоненты и связи между ними, рисуют схему и проверяют её девятью тестами, прежде чем показать вам. Если стрелка режет чужой узел или подпись наезжает на соседнюю линию, агент увидит это раньше вас и починит.

Для вайб-код-проекта это способ впервые увидеть, что вы на самом деле построили, и перепроверить архитектуру, пока она не разрослась дальше. Для проекта, который живёт с вами годами, это способ открыть глаза на то, как он выглядит целиком, а не по памяти.

Мы поставили его утром и к обеду получили схемы своего проекта, которые не стыдно показать. Ниже два примера, оба нарисованы Claude Code по описанию в одну-две фразы.

Что это на самом деле

Внутри три вещи. Инструкция для агента: как выбрать тип схемы, какие поля бывают у узлов и связей, в каком порядке проверять результат. Пять схем данных, по одной на тип диаграммы. И рендерер на Node, который берёт JSON и собирает из него один HTML-файл с SVG внутри, без сервера и без внешних зависимостей.

Типов пять, и выбор между ними агент делает сам по формулировке просьбы:

• Архитектура: компоненты, хранилища, внешние сервисы, границы вроде «это живёт в облаке».
• Воркфлоу: процессы по дорожкам и шагам, согласования, CI/CD, ранбуки.
• Последовательность: кто кому что отправил и что вернул.
• Поток данных: пайплайны, источники, трансформации, потребители.
• Жизненный цикл: состояния и переходы, ожидания, повторы, терминальные выходы.

Каждый узел типизирован: фронтенд, бэкенд, база, облако, безопасность, шина сообщений или внешний сервис. Из типа рендерер берёт цвет и иконку, а легенда внизу собирается сама.

Ставится одной командой, дальше просите словами

npx skills add tt-a1i/archify -g
# проверить, что всё на месте
node ~/.claude/skills/archify/bin/archify.mjs doctor

Установка кладёт папку с навыком рядом с остальными, для Cursor и Codex есть свои флаги. В вашем репозитории ничего не меняется, зависимостей ставить не нужно. Дальше общение идёт словами. Работает и без репозитория, по описанию:

Use Archify to draw: Browser -> API -> Redis cache -> PostgreSQL fallback.

И с репозиторием, когда схема должна отражать реальный код:

Analyze this repository, then use archify to create a high-level runtime architecture diagram. Show 8–12 core components, one primary path, external dependencies, and trust boundaries.

После первого варианта можно уточнять: «добавь очередь», «подсвети путь отката», «убери аналитику». Агент правит схему, перепроверяет и отдаёт новый файл.

Девять проверок до того, как вы увидите результат

Вот что отличает Archify от «попроси модель нарисовать». Перед выдачей каждая схема проходит валидатор: структура, раскладка, HTML и SVG, маршруты стрелок, зазор между подписями и линиями. В режиме showcase таких проверок девять, и пока хоть одна красная, инструкция запрещает агенту называть результат готовым.

Ошибки приходят не словами «что-то не так», а кодом правила и списком починок: «подпись наезжает на узел, сдвинь её или задай точку», «линия идёт вдоль границы блока, пересеки её перпендикулярно», «две стрелки делят один коридор, разведи». Ни одна из таких ошибок не мешает картинке выглядеть прилично, и именно их глаз пропускает.

У нас первый вариант архитектуры вернул шесть замечаний, починка заняла три раунда: переставить один узел, укоротить одну подпись, отдать один маршрут автоматике. Это норма, и инструкция прямо говорит агенту чинить только то, на что указал диагност, и останавливаться, если два раунда подряд не улучшают счёт. Схема после правок не превращается в клубок ручных обходов, потому что координаты задаются только у узлов, а маршруты считает компилятор.

Что получаете на выходе

Не картинку, а HTML-страницу, и в ней есть то, чего нет у статичного PNG. Сверху панель «глав»: агент описывает три-пять сюжетов вроде «запрос покупателя», «кеш и поиск», «заказы и почта», а кнопка Play story ведёт по ним по очереди, подсвечивая нужные узлы. Есть поиск по узлам, трассировка пути между двумя точками, режим презентации и переключение тёмной и светлой темы одной кнопкой.

Экспорт живёт в той же странице: PNG в буфер обмена одной кнопкой, SVG для документации, WebM, если включена анимация трассировки, и карточка 1200×630 под соцсети. Карточка не абстрактная: она снимается после того, как вы протрассировали конкретный путь, и показывает его на фоне всей схемы.

По коду, а не по памяти

Две возможности, ради которых стоит держать Archify рядом с репозиторием. Первая: у узла архитектуры может быть пометка SRC, которая открывает файл и строки на конкретном коммите. Схема перестаёт быть утверждением «мы думаем, что так» и становится ссылкой «вот код». Вторая: команда compare берёт две версии схемы и собирает страницу с дельтой: что добавилось, что исчезло, что переехало. Для ревью «мы вынесли очередь в отдельный сервис» это ровно тот артефакт, который хочется приложить к пулл-реквесту.

Сколько это стоит

Ничего. Лицензия MIT, проект вырос из генератора архитектурных диаграмм Cocoon-AI, тоже под MIT, и это честно указано в заголовке инструкции. Платных планов, хостинга и аккаунта нет: всё, что вы получаете, лежит в вашей папке и открывается двойным кликом.

На 4 сентября 2026 у репозитория 47 000 звёзд, из них 24 000 за последнюю неделю: это самый быстрорастущий проект недели на GitHub. Версия 2.17, коммиты идут ежедневно.

Кому советую, а кому нет

Советую, если у вас есть проект, устройство которого вы хотя бы раз объясняли словами: новому разработчику, заказчику, самому себе через полгода. Один вечер, и у вас схемы, которые собраны по коду, проверены валидатором и обновляются той же командой, когда код поменяется. Отдельно советую тем, кто пишет документацию и статьи: экспорт в PNG и тёмная тема закрывают вопрос иллюстраций.

Не советую в двух случаях. Если нужна доска, где схему двигают руками на созвоне, это Figma, Excalidraw или tldraw, у Archify такого режима нет намеренно. И если вы работаете без агента вовсе: писать JSON руками можно, но тогда вы получите валидатор без той части, ради которой всё придумано.