Archify review 2026: qué es, diagramas, cómo instalar y alternativas

Archify es una Agent Skill open source para generar diagramas de arquitectura de software a partir de lenguaje natural. No funciona como una aplicación independiente, sino como una habilidad que se instala en Agents de programación con IA como Cursor, Claude Code, Codex CLI y OpenCode.

La idea es bastante sencilla: describes una arquitectura, un flujo o un repositorio y el Agent se encarga de construir el diagrama. Archify introduce además una capa de representación estructurada y validación antes de generar el resultado visual.

Su flujo puede resumirse así:

Código o descripción → Agent → JSON IR → validación → HTML/SVG → interacción y exportación

Esto lo diferencia de herramientas como Mermaid o Draw.io. Archify no intenta ser simplemente otro editor de diagramas, sino una herramienta integrada en el flujo de trabajo de un Agent de programación.

Datos clave de Archify

• Fecha de creación: 15 de abril de 2026

• Versión indicada: v2.17.0-dev.1

• GitHub Stars: más de 31.400

• Licencia: MIT

• Tipos de diagramas: 5

• Agents compatibles: Cursor, Claude Code, Codex CLI, OpenCode y DeepSeek Harness

• Instalación: npx skills add tt-a1i/archify -g

¿Qué es un Agent Skill?

Una Agent Skill es un conjunto de instrucciones, herramientas y reglas que añade una capacidad específica a un Agent de programación.

Herramientas como Cursor, Claude Code, Codex CLI u OpenCode pueden leer código, interpretar instrucciones y ejecutar tareas. Una Skill especializada permite añadir un flujo de trabajo concreto sin convertirlo necesariamente en una aplicación independiente.

En Archify, esa capacidad está orientada a los diagramas de arquitectura.

El Agent interpreta la descripción o el código del proyecto, genera una representación estructurada en JSON IR y Archify utiliza esa información para producir el diagrama.

La separación es importante: el modelo interpreta el sistema y el motor de Archify se ocupa de convertir esa representación en una visualización siguiendo unas reglas definidas.

¿Qué puede hacer Archify?

Crear diagramas de arquitectura mediante lenguaje natural

No necesitas escribir manualmente la sintaxis de Mermaid ni colocar cada elemento en un editor visual.

Puedes darle al Agent una descripción como:

«Navegador → API Gateway → servicio de autenticación → API de aplicación → caché Redis → PostgreSQL como fallback. Dibuja un límite de confianza alrededor de los servicios privados y la base de datos».

El Agent interpreta la petición y genera la representación intermedia que Archify necesita para construir el diagrama.

También puede trabajar a partir del código de un repositorio, lo que resulta especialmente interesante cuando quieres documentar una arquitectura existente en lugar de diseñar una nueva desde cero.

Validación antes del renderizado

Una de las características que más distingue a Archify es su sistema de validación.

En lugar de pedir al modelo que genere directamente SVG o código de diagramación, el sistema utiliza una representación intermedia JSON fuertemente tipada.

Después se aplican reglas sobre el resultado antes de renderizarlo.

Entre otros aspectos, se pueden comprobar:

• La validez del Schema.

• La disposición de los elementos.

• Las rutas y conexiones.

• Los posibles conflictos entre elementos.

• La superposición de etiquetas.

• El cumplimiento de determinadas reglas del diagrama.

Cuando existe un problema, Archify puede devolver códigos de reglas y sugerencias para corregirlo en lugar de limitarse a mostrar un error técnico del proceso de generación.

Este enfoque cambia ligeramente la filosofía de la herramienta: el objetivo no es únicamente conseguir un diagrama visualmente atractivo, sino reducir los problemas que pueden aparecer durante su generación.

El equipo de ThakiCloud, por ejemplo, documentó un caso en el que su primer intento fue rechazado por el renderizador. En el contexto de Archify, ese rechazo forma parte del sistema de validación y no necesariamente representa un fallo de la herramienta.

Trazabilidad entre el diagrama y el código

Otra función interesante es la posibilidad de asociar elementos del diagrama con evidencias procedentes del repositorio.

Cuando se habilita esta información, los componentes pueden incluir referencias a archivos y líneas concretas, asociadas además a un commit.

Los nodos pueden mostrar una marca SRC que permite volver a la ubicación correspondiente del código.

Esto resulta útil porque uno de los problemas de los diagramas generados mediante IA es la posibilidad de representar componentes o relaciones que parecen razonables, pero que no coinciden exactamente con la implementación.

La trazabilidad no elimina por completo ese riesgo, pero facilita comprobar de dónde procede cada elemento.

Before / Delta / After

Archify también incluye un flujo pensado para comparar cambios arquitectónicos.

A partir de dos estados diferentes puede generar tres vistas:

• Before: estado anterior.

• Delta: cambios detectados.

• After: estado posterior.

Según la información disponible, el sistema puede representar:

• Componentes añadidos.

• Componentes eliminados.

• Conexiones modificadas.

• Nodos desplazados.

• Rutas modificadas o redirigidas.

La función está pensada como una herramienta de visualización. No intenta decidir si un cambio arquitectónico es correcto ni sustituye la revisión técnica de un ingeniero.

Esto puede resultar especialmente útil durante una revisión de PR, una migración o una refactorización importante.

Cinco tipos de diagramas

Actualmente Archify trabaja con cinco categorías principales:

El resultado no tiene por qué quedarse en una imagen estática.

El HTML generado permite interactuar con los elementos del diagrama. Dependiendo del tipo de visualización, puedes buscar nodos, seguir relaciones y explorar las conexiones entre componentes.

También existe la posibilidad de utilizar una vista guiada para recorrer diferentes partes del sistema.

HTML interactivo y exportación

Una de las ventajas prácticas de Archify es que el resultado puede entregarse como un archivo HTML autocontenido.

También permite exportar el diagrama a diferentes formatos, entre ellos:

• PNG

• SVG

• WebM

• Tarjeta para compartir de 1200 × 630

El archivo HTML no depende de un servidor externo para abrirse, por lo que puede resultar cómodo para compartir una arquitectura con otros miembros del equipo.

Cómo instalar Archify

El requisito principal es tener Node.js 18 o posterior y un Agent compatible.

La instalación se realiza con:

npx skills add tt-a1i/archify -g

Una vez instalada la Skill, no tienes que abrir una aplicación adicional. Puedes trabajar directamente desde el Agent.

Por ejemplo:

«Dibuja la arquitectura de este repositorio: frontend React, API en Node, PostgreSQL y Redis, con el límite de confianza alrededor de los servicios privados».

El Agent analizará la petición y utilizará Archify para generar el diagrama.

Si quieres ver el proceso completo desde la instalación hasta los primeros ejemplos, puedes consultar nuestra guía de inicio de Archify.

Archify vs Mermaid

Si estás buscando una alternativa a Mermaid, conviene entender primero que las dos herramientas parten de enfoques diferentes.

Mermaid utiliza una sintaxis específica para describir diagramas y después se encarga de representarlos visualmente. Es muy útil cuando quieres mantener un diagrama como texto dentro de un repositorio.

Archify introduce una capa adicional: el Agent interpreta la petición, genera una representación intermedia y esa representación pasa por un proceso de validación antes del renderizado.

Por tanto, no se trata simplemente de comparar cuál de las dos herramientas «dibuja mejor».

Mermaid está orientado a describir diagramas mediante texto; Archify está orientado a integrar la generación y validación de diagramas dentro de un flujo de trabajo con Agents.

Archify vs Draw.io y otras alternativas

También tiene sentido compararlo con herramientas visuales como Draw.io o con productos como Eraser.

La diferencia práctica es bastante clara.

Si quieres colocar cajas libremente, mover flechas y editar visualmente cada elemento, una herramienta tradicional puede resultar más cómoda.

Si quieres que un Agent analice un repositorio y genere una representación de su arquitectura con referencias al código, Archify está pensado específicamente para ese escenario.

Lo que más me gusta de Archify

Lenguaje natural

No necesitas aprender una sintaxis de diagramación específica. La interacción se realiza principalmente mediante el Agent.

Validación estructurada

El uso de JSON IR y de reglas de validación añade una capa que normalmente no existe cuando un modelo genera directamente un diagrama.

Trazabilidad

La posibilidad de relacionar un nodo con un archivo y una línea del código es especialmente interesante para documentación técnica generada a partir de repositorios existentes.

Before / Delta / After

Esta función tiene bastante sentido para PR y cambios arquitectónicos, donde muchas veces no basta con mostrar el estado actual del sistema.

Interactividad

El resultado no se limita necesariamente a una captura de pantalla. El HTML permite explorar los componentes y sus relaciones.

Código abierto

La licencia MIT permite utilizar y modificar el proyecto libremente, además de facilitar su integración en flujos de trabajo propios.

Lo que puede mejorarse

No hay edición libre mediante drag-and-drop

Esta es probablemente la principal diferencia frente a Draw.io y otros editores visuales.

Si quieres coger una caja y moverla manualmente unos píxeles, Archify no está pensado para ese tipo de trabajo.

Depende de un Agent

Archify no es una aplicación independiente. Necesitas utilizarlo dentro de un entorno compatible con Agents de programación.

No hay sincronización automática en tiempo real

Cuando cambia la arquitectura del proyecto, el diagrama no se actualiza automáticamente como consecuencia de ese cambio. Hay que volver a ejecutar el flujo del Agent.

La validación no elimina las alucinaciones

Este punto es importante.

Archify puede validar que la representación generada cumple determinadas reglas, pero eso no significa que el modelo haya entendido correctamente todos los detalles del repositorio.

La validación estructural y la exactitud semántica son problemas diferentes.

Por eso la trazabilidad hacia el código resulta especialmente útil.

No pretende ser una pizarra colaborativa

Si tu objetivo principal es hacer brainstorming, mover objetos libremente durante una reunión o colaborar con varias personas en tiempo real, existen herramientas más orientadas a ese escenario.

¿Para quién tiene sentido Archify?

Archify encaja especialmente bien con:

• Ingenieros y arquitectos de software que mantienen documentación técnica.

• Equipos que utilizan Cursor, Claude Code, Codex CLI u otros Agents de programación.

• Proyectos con arquitecturas complejas que necesitan documentación visual.

• Equipos que revisan PR y refactorizaciones arquitectónicas.

• Desarrolladores que quieren relacionar la documentación con el código real.

• Equipos que prefieren mantener parte de la documentación mediante un flujo automatizado.

• Usuarios interesados en herramientas open source para desarrollo asistido por IA.

Puede tener menos sentido para:

• Usuarios que necesitan edición drag-and-drop.

• Equipos que buscan colaboración visual en tiempo real.

• Personas que no utilizan Agents de programación con IA.

• Usuarios que quieren una herramienta de diagramación generalista.

• Situaciones en las que la edición manual es más importante que la generación automática.

Opiniones y experiencias de usuarios

Las opiniones públicas sobre Archify destacan principalmente dos aspectos: la relación entre el diagrama y el código y el enfoque de validación.

Entre los comentarios positivos aparecen experiencias relacionadas con el ahorro de tiempo en revisiones, la posibilidad de consultar la evidencia detrás de un nodo y la utilidad de generar documentación a partir de repositorios existentes.

También hay críticas razonables.

La ausencia de edición mediante drag-and-drop aparece como una limitación para quienes están acostumbrados a Draw.io o a otros editores visuales. También se ha señalado que la arquitectura no se sincroniza automáticamente con los cambios del código y que el modelo puede seguir cometiendo errores semánticos.

Estos puntos son importantes porque ayudan a entender qué problema intenta resolver Archify.

No pretende sustituir a todos los editores de diagramas. Su propuesta está más relacionada con automatizar la creación y mantenimiento de documentación arquitectónica dentro del flujo de desarrollo con IA.

¿Merece la pena Archify?

La respuesta depende bastante del flujo de trabajo que ya tengas.

Si utilizas Cursor, Claude Code, Codex CLI u otro Agent de programación y necesitas generar documentación de arquitectura a partir de código, las funciones de Archify resultan especialmente interesantes.

Su propuesta no consiste simplemente en generar una imagen a partir de un prompt.

El flujo combina:

lenguaje natural → comprensión del Agent → representación estructurada → validación → renderizado → trazabilidad

La parte más diferencial es probablemente la combinación de validación y referencias al código fuente.

Eso no significa que el resultado sea automáticamente correcto. El modelo sigue siendo responsable de interpretar el código y puede equivocarse. La ventaja es que Archify introduce mecanismos para detectar determinados problemas y facilitar la comprobación de los elementos representados.

Por otro lado, si buscas una herramienta para dibujar libremente, colaborar online o modificar manualmente cada elemento del diagrama, Draw.io, Figma u otras herramientas visuales pueden ajustarse mejor a ese tipo de trabajo.

Archify: puntos fuertes y limitaciones

En lugar de asignarle una única puntuación global, resulta más útil mirar estas dimensiones por separado. Archify tiene fortalezas muy concretas, pero también limitaciones igualmente claras.

Conclusión

Archify plantea una idea interesante para 2026: tratar los diagramas de arquitectura como parte del flujo de ingeniería de software, en lugar de como documentos gráficos completamente independientes del código.

Su combinación de lenguaje natural, JSON IR, validación, trazabilidad y generación interactiva lo diferencia de herramientas tradicionales como Mermaid y Draw.io.

La función Before/Delta/After también tiene un uso bastante concreto para revisiones arquitectónicas y cambios importantes en un repositorio.

Pero hay que tener claro qué tipo de herramienta es.

Archify no es un sustituto directo de un editor visual de diagramas. Es una Agent Skill diseñada para trabajar junto a herramientas de programación con IA.

Si ya utilizas Cursor o Claude Code y quieres generar documentación arquitectónica a partir de tus repositorios, merece la pena probarlo.

Si, en cambio, necesitas mover cajas manualmente, hacer brainstorming visual o colaborar en una pizarra online, sus limitaciones pueden resultar más importantes que sus ventajas.

En una frase:

Archify está pensado para desarrolladores que quieren convertir la arquitectura de software en un artefacto generado, validado y relacionado con el código, no simplemente en una imagen bonita.

Preguntas frecuentes sobre Archify

¿Archify es gratuito?

Sí. El proyecto es open source y utiliza una licencia MIT.

¿Cuál es la diferencia entre Archify y Mermaid?

Mermaid utiliza una sintaxis de texto para describir diagramas. Archify utiliza un Agent para interpretar lenguaje natural y generar una representación intermedia que posteriormente pasa por un proceso de validación y renderizado.

¿Qué necesita Archify para funcionar?

Necesitas Node.js 18 o posterior y un Agent compatible, como Cursor, Claude Code, Codex CLI u OpenCode.

La instalación se realiza con:

npx skills add tt-a1i/archify -g

¿Archify admite español?

Sí. La interacción se realiza mediante el Agent, por lo que puedes describir la arquitectura utilizando lenguaje natural. El soporte concreto dependerá también del Agent que estés utilizando.

¿Qué tipos de diagramas genera Archify?

Actualmente trabaja con cinco categorías principales:

Architecture, Workflow, Sequence, Data Flow y Lifecycle.

¿Archify sincroniza automáticamente el código y el diagrama?

No. Cuando la arquitectura cambia, es necesario volver a ejecutar el Agent para generar o actualizar el diagrama.

¿Archify puede cometer errores?

Sí. La validación comprueba aspectos estructurales del resultado, pero no garantiza que el modelo haya interpretado correctamente cada detalle del código.

Por eso la trazabilidad hacia archivos y líneas del repositorio es una parte importante del sistema.

¿Archify sirve para UML?

Puede generar diagramas de secuencia, pero no intenta cubrir todo el estándar UML.

Si necesitas diagramas UML más completos, especialmente diagramas de clases y otros formatos específicos, herramientas como PlantUML siguen teniendo un alcance más amplio.

¿Archify sustituye a Draw.io?

No necesariamente.

Draw.io está pensado para editar diagramas visualmente mediante arrastrar y soltar. Archify está pensado para generar y validar diagramas dentro de un flujo de trabajo con Agents.

La elección depende principalmente de si priorizas edición visual manual o generación integrada con el desarrollo asistido por IA.

¿Necesito Cursor o Claude Code?

Necesitas un Agent compatible con Archify. Entre los entornos indicados para su uso están Cursor, Claude Code, Codex CLI y OpenCode, además del bridge comunitario para DeepSeek Harness.

¿Dónde puedo aprender a utilizar Archify?

Puedes empezar instalando la Skill con:

npx skills add tt-a1i/archify -g

También puedes consultar nuestra guía de inicio de Archify para seguir el proceso paso a paso.