Архитектурные диаграммы из чата — без дизайнера и лишних инструментов

Archify — это навык (skill) для AI-агентов, который генерирует красивые самодостаточные технические диаграммы пяти типов: architecture, workflow, sequence, data-flow и lifecycle — из описания на обычном языке. Инструмент позволяет LLM-агенту создавать верифицированные HTML/SVG-диаграммы по текстовым подсказкам, итерировать их прямо в чате и экспортировать в пиксель-точные форматы — без сборочного конвейера. Проект уже набрал более 5 000 звёзд на GitHub и активно развивается.

ℹ Текущая версия
Актуальная версия разработки — v2.16.0-dev.0. Проект распространяется под лицензией MIT и открыт для вклада сообщества.

Как это работает

Archify — навык для Raven, Cursor, Claude Code, Codex CLI и OpenCode: опишите систему или укажите репозиторий — и получите интерактивную, легко распространяемую техническую карту.

Процесс укладывается в четыре шага:


graph LR
    A[Описание системы / репозиторий] --> B[Агент генерирует типизированный JSON IR]
    B --> C[Валидация схемы и разметки]
    C --> D{Прошло?}
    D -- Да --> E[Рендеринг HTML + экспорт PNG/SVG/WebM]
    D -- Нет --> F[Машиночитаемый отчёт об ошибке]
    F --> B

Archify упакован как переиспользуемый «skill» для Claude, Codex CLI и opencode: агент генерирует типизированный JSON IR, валидирует его, рендерит HTML/SVG, выполняет пострендерные проверки и итерирует — без установки runtime-зависимостей.

Установка в одну команду

npx skills add tt-a1i/archify -g

После установки достаточно написать агенту:

Use archify to map this repository's runtime architecture.

Пять типов диаграмм

Разработчики могут строить диаграммы архитектуры, рабочих процессов, последовательностей, потоков данных и жизненного цикла для систем, CI/CD-пайплайнов, процессов согласования, конвейеров данных и многого другого.

Тип диаграммыДля чего использоватьЧто указать в промпте
ArchitectureКомпоненты, сервисы, хранилища, границыОбласть, ключевые компоненты, основной путь
WorkflowCI/CD, согласования, runbook’иУчастники, порядок, ветки, исключения
SequenceAPI-вызовы, fallback кеша, auth, asyncВызывающие, вызываемые, возвраты, таймиинг
Data FlowПайплайны, PII-границы, потребителиИсточники, трансформации, хранилища
LifecycleСостояния, ретраи, терминальные исходыСостояния, события, пути отмены
💡 Не знаете, какой тип выбрать?

Запустите встроенный CLI-гид без зависимостей:

node archify/bin/archify.mjs guide "Show an API request with Redis cache miss"

Инструмент подскажет подходящий тип диаграммы для вашего сценария.

Ключевые возможности

Archify позволяет: сравнивать два верифицированных снимка архитектуры в формате Before / Delta / After с точным указанием добавленных, удалённых, изменённых и перемаршрутизированных элементов; искать узлы, отслеживать upstream/downstream-связи и проигрывать направленные сценарии без изобретения топологии; а также экспортировать самодостаточный HTML вместе с PNG, SVG, WebM и share-карточками 1200×630.

Archify создаёт технические диаграммы publication-качества — без ручного размещения единого узла.

Верификация и надёжность

«Каждое взаимодействие остаётся заземлённым» — диаграммы не изобретают топологию, а строго воспроизводят авторские связи из источника.

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

⚠ Важные ограничения
Автоматический парсинг Mermaid, универсальный auto-layout, хостинг для публичного шеринга и WYSIWYG-редактирование намеренно выходят за рамки текущего скоупа. Archify не является универсальным редактором диаграмм.

Для кого подходит

Archify идеально подходит разработчикам и архитекторам, которым нужно быстро генерировать отполированные, экспортируемые технические диаграммы из описаний на естественном языке внутри AI-агентов чата. Тем, кто требует нестандартных макетов или предпочитает традиционные drag-and-drop инструменты, инструмент может не подойти.

В отличие от традиционных инструментов для диаграмм, требующих ручной разметки и стилизации, Archify генерирует валидированные, переключаемые по теме, высокоразрешённые диаграммы из описаний на естественном языке — со встроенной валидацией и циклами итерации.

📝 Пример промпта для login flow
Use archify to draw this login flow:
Browser -> Web App -> API -> JWT validation ->
Redis session lookup -> PostgreSQL fallback.
Keep the cache-miss path secondary.

Итог

Archify занимает нишу между быстрыми набросками в Mermaid и громоздкими диаграммными редакторами. Инструмент подойдёт разработчикам, техническим писателям и всем, кто хочет быстро и легко создавать архитектурные диаграммы. Открытый код (MIT), активное развитие и интеграция с ведущими AI-агентами делают Archify заметным инструментом в экосистеме agentic-разработки 2026 года.