O que é Archify?
O Archify é uma skill de agente para Claude Code, Codex CLI, Cursor e OpenCode que faz o agente escrever uma descrição tipada em JSON de um diagrama, a valida e renderiza um arquivo HTML interativo e autocontido. Ele cobre dez tipos de diagrama (arquitetura, fluxo de trabalho, sequência, fluxo de dados, ciclo de vida, ERD, classes, árvore, linha do tempo e cascata), além de páginas explicativas de uma página que trazem a resposta primeiro e citam fontes numeradas.
O visualizador permite ao leitor focar um nó, rastrear relações a montante ou a jusante, destacar uma rota, trocar de tema e exportar PNG, WebP, JPG ou cartões para compartilhamento. Quando solicitado a ler um repositório, os nós de arquitetura podem apontar para arquivos e intervalos de linhas fixados em um commit público. Ele se instala apontando o agente para um arquivo llms.txt ou via npx skills.
O repositório, criado em abril de 2026, tem cerca de 92,100 estrelas no GitHub e agora é Apache-2.0; as versões anteriores mantêm a concessão MIT original. A versão mais recente é a v3.2.0 (19 de outubro de 2026).
Archify vale a pena?
A contribuição real do Archify é a validação, não a beleza. A maioria das ferramentas de diagrama para agentes pede ao modelo Mermaid ou SVG e torce; o Archify faz o agente escrever uma fonte JSON tipada, roda verificações de schema, layout, rotas e espaço livre dos rótulos, e só substitui a saída anterior quando todas as barreiras passam. Quando uma verificação falha, validate --json devolve um código de regra e as correções específicas permitidas, então o agente corrige uma coisa em vez de regenerar a imagem inteira. Em princípio, isso mantém as revisões posteriores mais estáveis do que regenerar uma saída livre a cada vez.
A saída é um único arquivo HTML, sem runtime para instalar. Um leitor pode rastrear tudo o que fica a jusante de um serviço, sondar o caminho do app web até o banco de dados ou comparar os papéis de backend e banco de dados, e as interações só reutilizam relações que o autor declarou, em vez de inferir impacto em tempo de execução. O modo de repositório é a virada útil para engenheiros: nós apoiados em evidências abrem os arquivos e intervalos de linhas exatos em um commit fixado, para que um revisor possa conferir o mapa com o código.
O peso está nas bordas. O projeto passou de MIT para Apache-2.0, lança rápido (cinco versões entre o fim de setembro e meados de outubro de 2026) e roda uma verificação opcional de atualizações que contata o próprio servidor cerca de uma vez por dia, a menos que você defina ARCHIFY_UPDATE_CHECK_DISABLED=1; o README diz que ela não envia dados do projeto. A seção de patrocinadores promove vários serviços de terceiros de repasse de API que oferecem acesso a Claude, OpenAI e Gemini por uma pequena porcentagem dos preços oficiais, o que não diz nada sobre o código do Archify, mas é um vizinho estranho para uma ferramenta de desenvolvimento, e é melhor não clicar.
Em comparação com um arquivo Mermaid escrito à mão, o Archify exige mais do agente e produz algo muito mais rico; em comparação com o diagram-design ou o fireworks-tech-graph, é a opção mais bem engenheirada, com um validador e um contrato de visualizador em vez de um guia de estilo. Parsing de Mermaid, layout automático, compartilhamento hospedado e edição por arrastar e soltar estão fora do escopo por design, então ele complementa um quadro branco em vez de substituí-lo.
Onde ele se destaca
Uma staff engineer integrando três recém-contratados a um backend de 40 serviços
Produzir um mapa da arquitetura de execução do repositório apoiado no código-fonte
Pedir ao agente que analise o repositório e desenhe de 8 a 12 componentes centrais com o Archify; nós apoiados em evidências apontam para os arquivos em um commit fixado, e o HTML vai para o documento de integração. Gratuito; o custo são alguns turnos de tokens do agente.
Um SRE escrevendo a análise de um incidente
Mostrar o que aconteceu e para onde foi o tempo
Gerar uma linha do tempo a partir dos timestamps dos logs e uma cascata a partir dos spans de traces, e depois compartilhar o arquivo HTML único. O projeto avisa que os tempos só são reais quando vêm dos seus logs ou traces.
Uma gerente de produto revisando uma mudança de arquitetura
Ver o que um design proposto acrescenta, remove e move
O comando compare renderiza um Architecture Delta entre dois snapshots JSON; os revisores percorrem as mudanças declaradas, embora ele não infira risco nem segurança do merge.
Antes de decidir
- Configuração
- Peça ao agente que instale o Archify a partir do llms.txt dele, ou rode npx -y skills@latest add https://archify.si --skill archify --agent cursor --global --copy --yes. O Node.js roda o renderizador e o validador incluídos; o primeiro diagrama leva um prompt.
- Integrações
- Claude Code, Codex CLI, OpenCode e Cursor com o renderizador completo; upload de skills no Claude.ai; integrações da comunidade para Hermes Agent e DeepSeek Harness. Exporta PNG, WebP, JPG, cartões para compartilhamento e impressão em PDF.
- Dados e privacidade
- Roda localmente; o HTML gerado é autocontido. Uma verificação opcional de atualizações faz um GET de um manifesto no servidor do projeto a cada 24 horas, aproximadamente, apenas com metadados HTTP normais; ARCHIFY_UPDATE_CHECK_DISABLED=1 a desliga. Apache-2.0; nenhum alerta de segurança publicado.
- Custo em escala
- Não há edição paga. O custo são os tokens do agente por diagrama e por revisão, mais o plano de modelo que o seu agente de código usar.
- Limites
- Cerca de 270 issues abertas; sem parsing de Mermaid, layout automático geral, compartilhamento hospedado ou edição WYSIWYG; o agente tem duas rodadas de correção por diagrama antes da revisão visual.
O que é bom
- Fonte JSON tipada com validação de schema, layout e rotas antes da entrega
- Dez tipos de diagrama, mais páginas explicativas com fontes citadas
- HTML interativo em arquivo único; nada a instalar para visualizar
- Nós de repositório apontam para arquivos e linhas em um commit fixado
O que não é
- A verificação diária de atualizações fica ligada a menos que você a desative
- Relicenciado de MIT para Apache-2.0; ritmo de lançamentos acelerado
- Os patrocinadores do README incluem serviços de repasse de API a preços muito baixos
- Sem edição WYSIWYG nem importação de Mermaid
Ideal para
Engenheiros e tech leads que querem que o agente de código produza diagramas de arquitetura e de fluxo verificados, interativos e compartilháveis em um único arquivo.
Alternativas ao Archify
Archify: perguntas frequentes
- Archify vale a pena?
- Diagramas que se verificam antes de chegar a você, exatamente o que faltava às imagens de arquitetura desenhadas por agentes. Damos nota 4.0 de 5.
- Quanto custa Archify?
- Gratuito e de código aberto (Apache-2.0; versões anteriores MIT).
- Quais são as desvantagens de Archify?
- A verificação diária de atualizações fica ligada a menos que você a desative; relicenciado de MIT para Apache-2.0; ritmo de lançamentos acelerado; os patrocinadores do README incluem serviços de repasse de API a preços muito baixos; sem edição WYSIWYG nem importação de Mermaid.
- Para quem Archify é indicado?
- Engenheiros e tech leads que querem que o agente de código produza diagramas de arquitetura e de fluxo verificados, interativos e compartilháveis em um único arquivo.
- Quanto custa Archify para uma equipe ou em produção?
- Não há edição paga. O custo são os tokens do agente por diagrama e por revisão, mais o plano de modelo que o seu agente de código usar.
- Archify é seguro para dados da empresa?
- Roda localmente; o HTML gerado é autocontido. Uma verificação opcional de atualizações faz um GET de um manifesto no servidor do projeto a cada 24 horas, aproximadamente, apenas com metadados HTTP normais; ARCHIFY_UPDATE_CHECK_DISABLED=1 a desliga. Apache-2.0; nenhum alerta de segurança publicado.
- Quais são as melhores alternativas ao Archify?
- As alternativas mais próximas que analisamos são Diagram Design, fireworks-tech-graph e Anatomy.
Respostas verificadas em 31 de out. de 2026.