pimenov.ai

Archify превращает кодовую базу в интерактивную карту

Archify — skill для кодовых агентов: превращает репозиторий в интерактивную карту архитектуры с проверкой связей, сравнением снимков и экспортом в HTML.

ИнструментыИИ-агенты

Archify — просто великолепный инструмент. Я уже построил с его помощью диаграммы всех своих проектов и инфраструктуры, и в динамике это выглядит очень круто.

По формату это skill для кодовых агентов: Claude Code, Codex CLI, Cursor и OpenCode. Он превращает кодовую базу или текстовое описание системы в интерактивную карту, которую можно смотреть и обсуждать прямо в браузере.

Notion image

Агент анализирует репозиторий и собирает типизированное промежуточное описание (JSON IR): компоненты, связи и маршруты. Archify прогоняет описание через формальные проверки и детерминированно компилирует его в самодостаточный HTML-файл, который можно открыть локально, переслать коллегам или приложить к ревью.

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

Главное отличие от привычного «нарисуй диаграмму в Mermaid» — верификация. Узлы карты привязываются к конкретному коду, а два снимка архитектуры сравниваются в формате Before / Delta / After: инструмент точно показывает, какие компоненты и связи добавлены, удалены или перенаправлены. Такую карту можно использовать в ревью изменений, а не только в презентациях.

Устанавливается одной командой: npx skills add tt-a1i/archify -g. Лицензия MIT, на GitHub у проекта уже больше 20 тысяч звёзд.

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

Следующий шаг

Посмотрите, как устроена реальная архитектура агентного приложения — её как раз удобно разбирать по такой карте: Редакция pimenov.ai на Codex app-server: архитектура собственного агентного приложения

Связанные материалы

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

Если захотите обсудить, как это применить у себя или в команде — пишите в Telegram @pimenov