AIKraft Agents

tt-a1i/archify

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

Инструменты⭐ 93 950JavaScriptпоследний релиз: v3.2.0
Открыть на GitHub ↗Сайт проекта ↗

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

Archify — это агентский навык для Node.js, который превращает текстовое описание системы или кода в интерактивные, верифицируемые диаграммы архитектуры в виде одного HTML-файла.

Зачем нужен

Инструмент решает проблему визуализации и валидации архитектурных решений: AI-агенты генерируют типизированный JSON (IR), который Archify компилирует в четкие диаграммы с анимацией. Это позволяет сравнивать изменения архитектуры (до/после), проверять связность узлов и делиться результатами без необходимости настраивать репозиторий.

Что можно реализовать

  • Генерация интерактивных карт архитектуры (architecture, workflow, sequence, data-flow, lifecycle) прямо в чате Cursor, Claude Code или Codex CLI.
  • Сравнение изменений архитектуры перед мержем: наглядный просмотр добавленных, удаленных, измененных и перемещенных узлов.
  • Трассировка путей и проверка связности: поиск узлов, просмотр upstream/downstream связей и проверка маршрутов без выдумывания топологии.
  • Создание самодостаточных отчетов: экспорт диаграмм в HTML, PNG, SVG, WebM и карточки для соцсетей (1200x630) с поддержкой темной/светлой темы.
  • Визуализация репозиториев: автоматическое построение карты системы на основе исходного кода (как в примере с mco-org/mco).

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

  • Поддержка 5 типов диаграмм и 4 предустановок с конечной анимацией и бренд-марками.
  • Детерминированная компиляция из типизированного JSON IR в HTML/SVG, обеспечивающая воспроизводимость.
  • Встроенные инструменты валидации: Proof Lab для проверки сгенерированных артефактов и сравнения снимков.
  • Работа без репозитория: описание системы достаточно ввести в чат AI-агента.
  • Интеграция с AI-инструментами через команду `npx skills add tt-a1i/archify -g`.

👤 Кому подойдёт: разработчики, архитекторы ПО, AI-инженеры, использующие Cursor, Claude Code, Codex CLI или OpenCode для проектирования и документирования систем.

Релизы

v3.2.0minor
🕐 18 дн назад · релиз на GitHub ↗

В Archify v3.2.0 добавлены одностраничные ответы с интерактивными диаграммами, исправлены ошибки экспорта и таймлайна.

  • Added: Добавлены одностраничные ответы (explainer) с интерактивными диаграммами, таблицами и цитатами.
  • Added: Страницы поддерживают четыре стиля оформления, светлую/темную темы и экспорт в PNG, WebP, JPG или PDF.
  • Fixed: Исправлен экспорт длинных изображений: теперь сохраняются стиль и тема страницы.
  • Fixed: Исправлено отображение пустых данных в диаграммах: пустые ячейки больше не заменяются нулями.
  • Fixed: Исправлен таймлайн: корректное отображение часовых поясов и переход на летнее время.
  • Fixed: Устранена утечка локальных путей в экспортируемых страницах для безопасного обмена.
v3.1.0minor
🕐 23 дн назад · релиз на GitHub ↗

Archify 3.1.0: 10 типов диаграмм с анимацией, улучшенный UX, диагностика и исправления экспорта.

  • Added: Добавлены 5 новых типов диаграмм: ERD, Class/interface, Tree, Timeline и Waterfall.
  • Added: Анимация (Live motion) включена по умолчанию для всех диаграмм, сохраняется отдельно от топологии.
  • Added: Улучшена навигация по длинным страницам, читаемость карточек и верстка диаграмм Lifecycle.
  • Added: Введена структурированная диагностика авторизации, проверка источников и разделение потоков доставки.
  • Fixed: Исправлены проблемы с экспортом, буфером обмена и переносом путей в Windows.
  • Известные ограничения: наложение элементов в Sequence, визуальные коридоры в Dataflow и перенос строк в Class.
v3.0.0majorbreaking
🕐 1 мес назад · релиз на GitHub ↗

Archify 3.0: переработанный рендеринг диаграмм, Lifecycle v2, проверка доставки артефактов и удаление устаревших функций.

  • Added: Полностью переработан интерфейс чтения диаграмм с оптимизацией под первый экран и улучшенной читаемостью.
  • Added: Введен Lifecycle v2 с поддержкой lane/column layout, состояний и улучшенным размещением меток.
  • Added: Улучшена отрисовка sequence-диаграмм: легенды больше не пересекают линии жизни, метки следуют цвету сообщений.
  • Added: Внедрен рабочий процесс проверки доставки (verified delivery) с верификацией артефактов до передачи результата.
  • Deprecated: Удалены guided/story views и обычные экспорты share-card; используйте overview, Route, Lens и canonical exports.
  • Fixed: Исправлена обработка путей Windows, нормализованы окончания строк и улучшена кроссплатформенная проверка.
v2.16.0minor
🕐 2 мес назад · релиз на GitHub ↗

Релиз v2.16.0: добавлен констрейнт-драйвен компилятор, локализация Viewer, примеры RAG и билингвальный cookbooks, множество фиксов.

  • Added: Добавлен constraint-driven compiler для управления workflow.
  • Added: Viewer UI полностью локализован на основе meta.locale.
  • Added: Появились примеры архитектуры RAG и билингвальный авторский cookbook.
  • Fixed: Исправлены коллизии Semantic Radar, навигационного дока и рендеринг SVG.
  • Fixed: Устранены проблемы с эмодзи, degenerate points и воспроизводимостью артефактов.