Archify: интерактивные архитектурные диаграммы из чата

20 сентября 2026 г.

#architecture#cursor#developer-tools#diagrams#nodejs#visualization
Предварительный просмотр продукта Archify

Превратите кодовую базу или описание системы в аккуратную интерактивную карту — прямо в чате.

Archify — это система рендеринга и валидации на Node.js для Cursor, Claude Code, Codex CLI и OpenCode. Агенты формируют типизированное JSON IR; Archify детерминированно компилирует его в HTML/SVG.

  • Открыть и показать — пять типов диаграмм, четыре пресета, тёмная/светлая темы, встроенные фирменные знаки и конечная анимация.

  • Проверить архитектурные изменения перед слиянием — сравнить два проверенных снапшота в формате «До / Дельта / После» с точным указанием добавленных, удалённых, изменённых, перемещённых и перенаправленных фактов.

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

  • Один файл, готовый к доверию и распространению — типизированное JSON IR и детерминированные проверки дают самодостаточный HTML плюс PNG, SVG, WebM и карточки для публикации размером 1200×630.

Текущая версия для разработки: v2.17.0-dev.1. См. Changelog.

Страница проекта · Руководство по сценариям · Proof Lab

npx skills add tt-a1i/archify -g

Используете Cursor? Откройте быстрый старт с поддержкой агента — там есть точные команды для глобальной и проектной установки.

Репозиторий не нужен: опишите систему в любом чате агента.

❤️ Спонсоры

image::/media/e3/e38bbbf0a415ce08f49826927e8f2317c50785d503a9e1611cb3881ae37bd462.png[Supercode,1040,238] supercode.sh

Supercode спонсирует Archify и расширяет возможности Codex и Cursor: оптимизация токенов, подборка скиллов и разработка на основе спецификаций. Archify включён в Supercode Editor’s Choice как рекомендованный скилл.

image::/media/68/6863c92df2c0cdd4d533ed71c15d8d86745d4b2c3e0608fc99b3c3bad82cc2ef.png[Archify × Raven,1920,576] EverMind · Raven

EverMind спонсирует Archify и создаёт инфраструктуру памяти для агентов. Его обвязка Raven поддерживает Archify как скилл для проверенных интерактивных карт систем.

Хотите спонсировать Archify? Напишите нам на email.

Archify в действии

Это реальные артефакты Archify, а не маркетинговые макеты. Нажмите на кадр, чтобы открыть его в живом, доступном для публикации состоянии.

Три проверенных артефакта Archify с пресетами Signal Flow, Blueprint и Classic

Три реальных сгенерированных артефакта. Signal Flow · Blueprint · Classic · открыть интерактивный Proof Lab ↗

Направленный сценарий Анализ маршрута Семантическая линза

image::/media/0c/0c8762e7e2f1493ba9d73fc3473a2f56f4876c52585e9c87a4815df25c3d2b0c.png["Рабочий процесс агента, воспроизводящий одну авторскую главу",1280,720]

image::/media/c4/c4b16924d9e5200bd08a8fa27fe7ed95060cc34a704a34e26a681852b6422af7.png[Последовательность промаха кэша с маршрутом от Web App до Postgres,1280,720]

image::/media/55/559f56819526b12d8ff198a26a012f3b1415ee229e43fc4f858d869c7571a540.png[Архитектура продакшена со сравнением ролей бэкенда и базы данных,1280,720]

Воспроизвести одну конечную именованную главу.

Исследовать кратчайший авторский направленный путь.

Сравнить реальный трафик между семантическими ролями.

Proof Lab содержит все 11 зафиксированных сценариев, их JSON-источники, именованные представления и квитанции валидации.

Реальный репозиторий, отображённый из исходников

image::/media/c0/c04cb0eec7c2cca1deab4898ad45ea077458e084a682c7e8884cf70e2e2e03d8.png["Runtime-архитектура MCO, сгенерированная из публичного репозитория mco-org/mco",1200,630]

Archify проследил mco-org/mco на коммите 9f1a1cf и создал эту проверенную карту. Открыть ↗ · trace reach ↗ · типизированный источник

Предпросмотр

Одна диаграмма, две темы, один клик для переключения:

Тёмная тема Светлая тема

image::/media/c4/c4c95522629e9c00bd5b01c9329ab0f54de3dcae75754b56776ba19be8d98c97.png[Тёмная тема,1400,1100]

image::/media/43/43810203f58a42b199d7c3ef5223695c39a7bbdba50b9410213816ea1c1d4d27.png[Светлая тема,1400,1100]

Меню экспорта копирует PNG в буфер обмена и скачивает статические или анимированные форматы:

Меню экспорта

Используйте Copy Share Card, когда нужно каноническое изображение 1200×630 для README, релиза или публикации в соцсетях.

После трассировки маршрута Export → Route Share Card скачивает этот авторский путь в виде PNG 1200×630, сохраняя полную диаграмму в качестве контекста.

Карточка маршрута Route Share Card с точным путём от пользователей до API-сервера на фоне полной архитектуры

После трассировки авторского охвата Upstream или Downstream команда Export → Reach Share Card фиксирует это точное прочтение, не претендуя на отражение реального runtime-влияния.

Карточка охвата MCO Downstream Reach Share Card с авторскими связями от Command Router

Откройте examples/web-app.html локально, чтобы попробовать полный просмотрщик.

Быстрый старт

1. Установка

npx skills add tt-a1i/archify -g

Для явной, неинтерактивной установки в Cursor:

npx -y skills add tt-a1i/archify --skill archify --agent cursor --global --copy --yes

Чтобы попробовать без установки:

npx skills use tt-a1i/archify@archify --agent codex

Подключение сообщества DSH: dsh plugin --profile web add @tt-a1i/archify-dsh@0.1.0

Переключатель агентов охватывает cursor, codex, claude-code и opencode. Для ручной установки через ZIP в Raven распакуйте archify.zip в ~/.raven/workspace/skills; в результате появится ~/.raven/workspace/skills/archify. Raven не является целью переключателя.

Archify может обращаться по GET к фиксированному стабильному манифесту исключительно для показа необязательного напоминания — никакие обновления не скачиваются и не устанавливаются автоматически. Успешные проверки повторяются примерно через 72 часа (±20%); при активном использовании ошибки повторяются через 6, а затем через 24 часа. Сервер видит стандартные HTTP-метаданные (IP и время), но не получает версию, данные агента, проекта, промпты, идентификаторы аккаунта/устройства или ETag. Вы сами решаете, обновляться и когда. Установите ARCHIFY_UPDATE_CHECK_DISABLED=1, чтобы отключить сеть и запись состояния напоминаний.

2. Начать с описания — репозиторий не нужен

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.
Put supporting detail in cards instead of adding more edges.

3. Уточнение в чате

Продолжайте с конкретными запросами: add Redis, move auth to the left или highlight the rollback path. Archify сохраняет типизированный источник доступным для точечных итераций.

Выбор подходящего типа диаграммы

Тип Лучше всего подходит для Укажите в промпте

Architecture (архитектура)

Компоненты, сервисы, хранилища, границы

Область охвата, ключевые компоненты, основной путь

Workflow (рабочий процесс)

CI/CD, согласования, вызовы инструментов, runbook-и

Участники, порядок, ветвления, исключения

Sequence (последовательность)

API-вызовы, промах кэша, аутентификация, асинхронные трассировки

Вызывающие, вызываемые, возвраты, тайминг

Data Flow (поток данных)

Пайплайны, линейка данных, PII, потребители

Источники, преобразования, хранилища, границы

Lifecycle (жизненный цикл)

Состояния, повторные попытки, ожидания, финальные исходы

Состояния, события, пути повторов и отмены

Опциональный профиль deployment-ownership для Architecture закрывается с ошибкой, если отсутствуют авторские владельцы, размещение по регионам, область видимости приватных баз данных или именованные пересечения — они никогда не подразумеваются и не берутся из реальной инфраструктуры. См. проверенное доказательство развёртывания.

Для проектирования или ревью PR Architecture Delta сравнивает проверенные снапшоты «До / Дельта / После» с машиночитаемой квитанцией. Выберите авторское изменение или воспроизведите один конечный, только для просмотра Review; инструмент не выводит заключений о влиянии, рисках или безопасности слияния.

node archify/bin/archify.mjs compare architecture base.json head.json architecture-delta.html --json

image::/media/69/69dcc304835029d4790228b3a3dfaca6e515eed7caaa30f03914d4aaa6da4e58.jpg["Architecture Delta с добавленными, удалёнными, изменёнными и перемещёнными авторскими фактами",1265,712]

Не уверены, что подходит? Воспользуйтесь интерактивным руководством по сценариям или спросите CLI без зависимостей:

node archify/bin/archify.mjs guide "Show an API request with Redis cache miss"
node archify/bin/archify.mjs guide "Map Kafka topics, consumer groups, replay, and DLQ" --json

Workflow сохраняет основной путь наглядным между дорожками (lanes):

Пример диаграммы Workflow

Sequence объясняет одно взаимодействие во времени:

Пример диаграммы Sequence

Data Flow явно показывает движение данных и границы чувствительности:

Пример диаграммы Data Flow

Lifecycle разделяет прогресс, ожидания, повторные попытки и финальные исходы:

Пример диаграммы Lifecycle

Примеры архитектур: web-app · Archify pipeline · grid placement · desktop agent

Почему Archify

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

  • Типизированное JSON IR — каждый режим, поддерживаемый рендерером, имеет схему и воспроизводимый источник.

  • Атомарная валидация перед выдачей — проверки схемы, компоновки, HTML/SVG, маршрутов и зазоров между метками и маршрутами должны пройти, прежде чем итоговый артефакт заменит последний исправный.

  • Ошибки сопровождаются квитанцией ремонта — validate --json и deliver --json возвращают стабильные коды правил, точный субъект, измеренные доказательства и только поддерживаемые способы исправления — вместо трассировки Node или неструктурированного предположения о повторной попытке.

  • Живой предпросмотр с последним исправным состоянием — необязательный настольный цикл следит за одним JSON-файлом, обновляется только после того, как последний кандидат прошёл все проверки, и показывает предыдущую проверенную диаграмму, пока сохранение неполное или невалидное.

  • Честное взаимодействие — фокус, охват вверх/вниз по авторским связям, точные маршруты, сравнение ролей и сценарии используют авторские узлы и связи, не изобретая топологию и не претендуя на отражение runtime-поведения.

  • Доказательства из источников — только по запросу — узлы Architecture с поддержкой доказательств помечают себя SRC n и открывают проверенные Git-файлы с диапазонами строк, привязанными к одному публичному коммиту; обычные артефакты остаются без привязки к исходникам.

  • Портативность по умолчанию — результат — один HTML-файл; экспорты сохраняют полную диаграмму и не содержат временного состояния просмотрщика.

Archify — не редактор для произвольных рисунков и не тема для Mermaid. Он превращает техническое намерение в артефакт для коммуникации.

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

Шаг Что происходит

Generate (генерация)

Агент создаёт типизированное JSON IR из вашего описания.

Validate (валидация)

Встроенные валидаторы и правила компоновки проверяют источник; ошибки указывают на точное локальное исправление в машиночитаемом JSON.

Preview (предпросмотр, необязательно)

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

Deliver (выдача)

Кандидат в той же директории рендерится и проверяется; только прошедший артефакт атомарно заменяет целевой, затем необязательный --open открывает именно этот файл.

Iterate (итерация)

Агент обновляет источник, пока несвязанная структура остаётся стабильной.

Полезные команды для работы с репозиторием:

cd archify
node bin/archify.mjs doctor
node bin/archify.mjs demo /tmp/archify-demo
node bin/archify.mjs guide "Show CI/CD checks, approval, deploy, and rollback"
node bin/archify.mjs validate workflow examples/agent-tool-call.workflow.json --quality showcase --json
node bin/archify.mjs preview workflow examples/agent-tool-call.workflow.json /tmp/workflow.html --quality showcase
node bin/archify.mjs deliver workflow examples/agent-tool-call.workflow.json /tmp/workflow.html --quality showcase --open --json

preview — явный настольный режим только на loopback: следит за одним JSON-файлом на случайном порту 127.0.0.1, сохраняет последний проверенный вывод при ошибках, останавливается по Ctrl-C и не добавляет никакого runtime в генерируемый HTML. Используйте --no-open для тестов или ручного открытия URL.

deliver --open — разовая опциональная передача после коммита. Ошибка открытия не отменяет успех; JSON остаётся на stdout, а абсолютный резервный путь выводится в stderr.

При ошибке validate --json и deliver --json выдают один JSON-объект. Применяйте только supportedFixes для каждого субъекта из diagnostics[], в пределах двух раундов коррекции скилла; визуальная ревизия остаётся отдельной.

Настройки:

{
  "meta": {
    "locale": "en",
    "animation": "trace",
    "visual_preset": "signal-flow"
  }
}

meta.locale=en|zh-CN локализует заголовок страницы, легенду, состояния/ошибки, доступность (a11y), атрибут lang HTML/SVG — но не авторский контент. Если не нужно — опустите; сохраняйте текст на запрошенном языке; раскрывайте английский fallback. Статический режим не использует animation; по умолчанию — classic.

Работа с выводом и публикация

Действие Управление

Открыть фактический Diagram Guide

kbd:[?]

Найти и выделить семантический узел

kbd:[/]

Трассировать авторский охват вверх/вниз

Фокус на узле → Upstream / Downstream

Исследовать направленный маршрут

kbd:[R] или PATH

Сравнить одну или две семантические роли

kbd:[L] или LENS

Открыть обзорный радар

kbd:[M] или MAP

Воспроизвести сценарий / сменить главу

kbd:[P] / kbd:[\[] kbd:[\]]

Войти в режим Presentation Stage

kbd:[F]

Переключить стиль (S циклически) / тему / экспорт

kbd:[S] / kbd:[T] / kbd:[E]

Масштабирование или сброс

kbd:[+] / kbd:[-] / kbd:[0]

Стабильные ссылки могут восстанавливать состояние через #focus=<id>, #focus=<id>&reach=upstream|downstream, #relation=<id>, #route=<source>~<target>, #lens=<kind>~<kind> и #view=<view-id>. Анимация, управляемая читателем, конечна, уважает prefers-reduced-motion и никогда не попадает в канонические экспорты.

Полный контракт генерации и просмотрщика описан в archify/SKILL.md.

Варианты установки

Среда Место установки или метод Возможности

Raven

Ручной ZIP в ~/.raven/workspace/skills → ~/.raven/workspace/skills/archify

Полный рендерер + рабочий процесс валидации

Claude Code

~/.claude/skills/ или .claude/skills/

Полный рендерер + рабочий процесс валидации

Codex CLI

~/.agents/skills/ или .agents/skills/

Полный рендерер + рабочий процесс валидации

opencode

~/.config/opencode/skills/, .opencode/skills/ или .agents/skills/

Полный рендерер + рабочий процесс валидации

Claude.ai

Загрузить archify.zip в Настройки → Capabilities → Skills

Зависит от доступа к Node.js в песочнице

Project Knowledge

Загрузить archify.zip в проект

Архитектурный fallback на основе промптов

DeepSeek Harness

Подключение: dsh plugin --profile web add @tt-a1i/archify-dsh@0.1.0. Вызов: Use the archify skill to map this repository’s runtime architecture. Удаление: dsh plugin --profile web remove @tt-a1i/archify-dsh.

Интеграция сообщества для developer-preview @deepseek-ai/dsh@0.1.0-rc.6; Node ^22.19.0 || >=24.0.0; не официальный продукт DeepSeek. Без телеметрии. Shell-файлы требуют точных путей рабочего пространства, а не Web Produced Files. Подробности.

Справочник и область применения

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

Лицензия

MIT — можно свободно использовать, изменять и распространять.

Участие в разработке

Приветствуются issue, pull request-ы и реальные диаграммы. Начните с руководства по участию, используйте воспроизводимую форму ошибки при сбоях или отправьте проверенную диаграмму через форму community showcase. · LINUX DO

История звёзд

Похожее

© 2026 meganuke