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

Archify — agent skill, который превращает описание системы или код репозитория в интерактивную и разделяемую техническую карту. Проект tt-a1i/archify под лицензией MIT работает прямо в агенте: вы описываете систему или даёте репозиторий — и получаете готовую карту из одного HTML-файла, которую можно открыть, отредактировать в чате и передать команде.

Скилл поддерживает Raven, Cursor, Claude Code, Codex CLI и OpenCode. Актуальная стабильная версия — v2.14.0.

Что умеет

• Пять типов диаграмм — Architecture (компоненты, сервисы, границы доверия), Workflow (CI/CD, одобрения, runbook), Sequence (API-вызовы, кэш-фолбэк, авторизация), Data Flow (пайплайны, lineage, чувствительные данные) и Lifecycle (состояния, ретраи, терминальные исходы).
• Четыре визуальных пресета — Signal Flow, Blueprint, Classic и Editorial, плюс тёмная и светлая темы и опциональная конечная анимация.
• Сравнение Before / Delta / After — для ревью архитектурных изменений перед мёрджем: по двум валидированным снимкам строится точный дельта-отчёт с добавленными, удалёнными, изменёнными, перемещёнными и перенаправленными фактами.
• Честное взаимодействие — поиск по узлам, опциональное открытие исходников с проверкой ревизии, обход upstream/downstream по заявленным связям, точные маршруты, сравнение ролей и guided-стори, которые не выдумывают топологию.
• Один файл на выходе — типизованный JSON IR и детерминированные проверки дают автономный HTML плюс экспорт в PNG, SVG, WebM и share-карточки 1200×630.

Как работает

Процесс состоит из пяти шагов:

Проверки перед доставкой включают схемы, раскладку, HTML/SVG, маршруты и clearance метки к маршрутам — сбой не поставляет битый артефакт. Диагностика validate --json и deliver --json возвращает стабильные коды правил, точный субъект и только поддерживаемые способы исправления вместо Node-stack-трейса или неструктурированной догадки с ретраем.

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

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

Для Raven доступна ручная установка ZIP: распакуйте archify.zip в ~/.raven/workspace/skills, получится ~/.raven/workspace/skills/archify.

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

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

Выбор типа диаграммы

Для ревью продакшн-деплоя Architecture может включить инженерный профиль deployment-ownership: он работает по принципу fail-closed, когда не хватает владельцев, размещения в одном регионе, приватной БД или имён пересекающих границу данных. Включается только явно и проверяет заявленные факты, а не живую инфраструктуру.

Сравнение до и после для дизайн/PR-ревью: node archify/bin/archify.mjs compare architecture base.json head.json architecture-delta.html --json.

Не знаете, какой тип подойдёт? Есть интерактивный сценарий-гид и zero-dependency 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

Полезные команды

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 — явный режим локальной правки, а не фоновый сервис: биндится на 127.0.0.1 с случайным портом, следит за одним JSON-файлом и сохраняет последний подтверждённый вывод при ошибках. deliver --open запускает одноразовый интерактивный показ — по умолчанию выключен и не превращает успешную доставку в ошибку, если OS-открыватель недоступен.

Опционально включается анимация и пресет через JSON-метаданные: "animation": "trace" и "visual_preset": "signal-flow". Если убрать animation, диаграмма будет полностью статичной.

Взаимодействие с картой

Управление удобное и чисто клавиатурное: <kbd>?</kbd> — фактологический гид по диаграмме, / — поиск и фокус узла, R — трассировка маршрута, L — сравнение ролей, M — обзорный радар, P — guided-стори, F — режим презентации, S — смена визуального стиля, T — тема, E — экспорт.

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

Почему Archify, а не альтернативы

• Суждение о раскладке вместо авто-layout — агент сам выбирает иерархию, отступы, маршруты и акценты; общие автоматические эндпоинты распределяются детерминированно, а не наваливаются стрелками в одну точку.
• Типизованный JSON IR — у каждого режима есть схема и воспроизводимый исходник.
• Атомарная валидация перед доставкой — артефакт заменяет последнее подтверждённое состояние только после прохождения всех проверок.
• Правдивое взаимодействие — фокус, reach, маршруты и стори используют заявленные узлы и связи, не выдумывают топологию и не заявляют runtime-эффект.
• Источники по запросу — Evidence-backed узлы помечаются SRC n и открывают проверенные файлы с диапазонами строк, закреплённые за одним публичным коммитом.
• Портативность по умолчанию — результат это один HTML-файл, экспорты сохраняют полную диаграмму без временного состояния вьюера.

Пример из реального репозитория

Archify отследил публичный репозиторий mco-org/mco на коммите 9f1a1cf и собрал проверенную карту его runtime-архитектуры — это живой пример того, как выглядит результат на реальном коде.

Установка в разных средах

Лицензия — MIT. Из вкладов приветствуются issues, pull requests и реальные диаграммы.