Archify: интерактивные схемы кода прямо из чата с кодинг-агентом — обзор и гайд

Archify: как превратить код в интерактивную схему силами кодинг-агента

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

Что это за инструмент

Archify — открытый скил для кодинг-агентов (Claude Code, Codex CLI, OpenCode, Cursor, а также интеграции для Hermes и DeepSeek Harness). Агент ставит его себе в папку со скилами и после этого умеет собирать интерактивные диаграммы. На входе — описание словами или сам репозиторий, на выходе — один самодостаточный HTML-файл. Открыли в браузере — получили кликабельные узлы, всплывающие карточки, подсветку связей.

Ключевая деталь: Archify не пытается автоматически нарисовать Mermaid из README. Он даёт агенту формат и правила, по которым тот вручную описывает структуру — что с чем связано, что главное, что вспомогательное. Отсюда и главная особенность: схема отражает то, что агент реально прочитал в коде, а не шаблонные импорты.

Три режима диаграмм

• Architecture — карта компонентов системы: сервисы, базы, внешние зависимости, границы доверия.
• Sequence — путь конкретного запроса или сценария по шагам, с указанием, кто кого вызывает.
• Workflow — рабочий процесс агента: планировщик, инструменты, ветки решений.

Отдельно есть режим explainer — не схема, а одностраничное объяснение: сначала вывод, потом панели с подробностями, таблицами и шагами, а чертежи вставлены там, где они нужны по смыслу.

Как это работает под капотом

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

Идея «последнего удачного файла» и атомарной подмены — это ответ на типичную боль генеративных инструментов: агент что-то сломал в разметке, и вы остались без рабочей картинки. Здесь битый вариант просто не попадает на выход.

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

• Один HTML-файл без внешних зависимостей — его можно отправить коллеге, и интерактив поедет вместе с файлом.
• Две темы (светлая и тёмная), четыре визуальных стиля, режим презентации.
• Фокус на узле, показ всех зависимых частей вверх и вниз по графу, проверка конкретного маршрута, сравнение двух ролей.
• Ссылки-состояния вида #focus=id&reach=downstream: открываете не просто схему, а конкретный ракурс.
• Экспорт PNG, WebP, JPG, видео-анимации и карточек маршрута 1200×630 для чатов и соцсетей, печать в PDF.
• Привязка узлов к файлам и строкам кода, зафиксированным на конкретном коммите — если явно об этом попросить.

Практические сценарии

Онбординг в незнакомый репозиторий. Открываете проект в агенте и просите высокоуровневую архитектуру с 8–12 компонентами, одной главной цепочкой запроса и внешними зависимостями. Получаете карту, с которой можно идти на ревью или к тимлиду.

Разбор инцидента. Бывает, что средняя задержка в норме, а P99 вырос в семь раз. Режим explainer собирает ответ с панелями по вопросам и источниками, а схему вставляет рядом с шагами, которые она иллюстрирует.

Презентация архитектуры. Режим презентации и карточки маршрута позволяют показать не весь граф целиком, а именно тот участок, о котором идёт речь.

Документация процесса агента. Если строите собственного агента с инструментами и ветками решений, режим workflow показывает его логику наглядно, а не списком шагов в README.

Установка и первый запуск

Ставится через самого агента — это и есть основной путь:

Install Archify for me by reading https://raw.githubusercontent.com/tt-a1i/archify/main/llms.txt

Дальше — обычная просьба:

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.

Итерации идут в чате: «добавь Redis», «перенеси авторизацию влево», «подсвети путь отката». Исходный JSON при этом остаётся доступным, поэтому агент правит не картинку, а модель схемы.

Честные ограничения

• Автоматический парсинг Mermaid, универсальный автолэйаут и WYSIWYG-редактор в текущую область не входят: это не drawing tool.
• Качество схемы зависит от того, насколько хорошо агент прочитал проект. На больших монорепах стоит заранее сузить область: папку, конкретный сервис или сценарий.
• Ссылки на исходники — только по запросу. Без явного указания схема будет без привязки к коду.
• Проверка обновлений — отдельная сетевая функция, её можно отключить переменной ARCHIFY_UPDATE_CHECK_DISABLED=1; данные проекта при этом не отправляются.
• Визуальный контроль остаётся за человеком: валидаторы ловят технические ошибки раскладки, но не оценивают, насколько схема понятна именно вашей команде.

Кому подойдёт

Тем, кто регулярно входит в незнакомые кодовые базы, готовит архитектурные обзоры или объясняет систему коллегам и заказчикам. Archify не заменяет ручное проектирование и не рисует за вас то, чего в коде нет, но он снимает разрыв между прочитанным кодом и понятной картинкой, который обычно и съедает день.

Репозиторий проекта: github.com/tt-a1i/archify.