Sobre o projeto

Archify é um sistema de renderização e validação em Node.js projetado como uma habilidade para agentes de codificação com IA, como Cursor, Claude Code, Codex CLI e OpenCode. Ele permite que um agente transforme uma base de código ou uma descrição de sistema em linguagem natural em uma representação intermediária JSON tipada, que o Archify compila deterministicamente em diagramas HTML/SVG autossuficientes. Não é necessário um repositório; os usuários podem descrever um sistema diretamente no chat. Ele suporta cinco tipos de diagramas: arquitetura, fluxo de trabalho, sequência, fluxo de dados e ciclo de vida. Cada um possui múltiplos predefinições visuais, temas escuro e claro, marcas incorporadas e movimento finito. O visualizador gerado permite buscar nós, rastrear alcance a montante/jusante, investigar rotas exatas, comparar papéis semânticos e reproduzir histórias guiadas. Links profundos estáveis podem restaurar foco, visualizações, rotas, lentes e estados de alcance. O modo Architecture Delta compara dois instantâneos validados como Antes, Delta e Depois com um recibo legível por máquina, listando fatos adicionados, removidos, alterados, movidos e reroteados. Os artefatos são validados antes da entrega; falhas de validação vêm com códigos de regra estáveis, evidências medidas e correções suportadas. As exportações incluem PNG, SVG, WebM e cartões de compartilhamento 1200x630, com cartões de compartilhamento de rota e alcance para caminhos específicos criados. Links opcionais de evidência de origem abrem arquivos verificados por Git e intervalos de linhas fixados em um commit público. A instalação está disponível por meio de npx skills add tt-a1i/archify -g, com instruções para instalações globais e de projeto, uma opção ZIP manual para Raven e um plugin comunitário DeepSeek Harness. A CLI inclui comandos doctor, demo, guide, validate, preview e deliver. O comando preview executa um observador de desktop explícito apenas para loopback que mantém a última saída verificada quando um salvamento está incompleto ou inválido. validate e deliver emitem diagnósticos JSON com orientação de reparo determinística. Archify não é um editor de desenho de propósito geral nem um tema Mermaid; ele se concentra em transformar intenção técnica em um artefato de comunicação. É licenciado sob MIT e inclui um changelog, roteiro, referência de esquema e Proof Lab gerado com artefatos de exemplo.