Об этом проекте

Archify — это система рендеринга и валидации на Node.js, разработанная как навык для AI-агентов программирования, таких как Cursor, Claude Code, Codex CLI и OpenCode. Она позволяет агенту преобразовывать кодовую базу или описание системы на естественном языке в типизированное промежуточное представление JSON, которое Archify детерминированно компилирует в самодостаточные диаграммы HTML/SVG. Репозиторий не требуется; пользователи могут описывать систему непосредственно в чате. Поддерживается пять типов диаграмм: архитектура, рабочий процесс, последовательность, поток данных и жизненный цикл. Для каждого типа предусмотрено несколько визуальных пресетов, тёмная и светлая темы, встроенные фирменные знаки и ограниченная анимация. Сгенерированный просмотрщик позволяет искать узлы, отслеживать восходящую и нисходящую достижимость, проверять точные маршруты, сравнивать семантические роли и воспроизводить направляемые сценарии. Стабильные глубокие ссылки могут восстанавливать фокус, представления, маршруты, линзы и состояния достижимости. Режим Architecture Delta сравнивает два валидированных снимка как «До», «Изменения» и «После» с машиночитаемым подтверждением, перечисляя добавленные, удалённые, изменённые, перемещённые и перенаправленные факты. Артефакты валидируются перед поставкой; ошибки валидации сопровождаются стабильными кодами правил, измеренными свидетельствами и поддерживаемыми исправлениями. Экспорт включает PNG, SVG, WebM и карточки для публикации размером 1200x630, а также карточки маршрутов и достижимости для конкретных авторских путей. Необязательные ссылки на исходные свидетельства открывают проверенные в Git файлы и диапазоны строк, привязанные к публичному коммиту. Установка доступна через npx skills add tt-a1i/archify -g, с инструкциями для глобальной и проектной установки, ручным вариантом ZIP для Raven и общественным плагином DeepSeek Harness. CLI включает команды doctor, demo, guide, validate, preview и deliver. Команда preview запускает явный настольный наблюдатель только через loopback, сохраняющий последний проверенный результат, если сохранение неполное или недействительное. Команды validate и deliver выводят JSON-диагностику с детерминированными рекомендациями по ремонту. Archify не является универсальным графическим редактором или темой для Mermaid; система сосредоточена на преобразовании технического замысла в коммуникационный артефакт. Распространяется под лицензией MIT и включает журнал изменений, дорожную карту, справочник по схеме и сгенерированную Proof Lab с примерами артефактов.