Archify

Archify es una Agent Skill. No es una aplicación independiente, sino un «paquete de habilidades» que se instala en Agents de programación con IA como Cursor, Claude Code, Codex CLI y OpenCode.

Puedes describir lo que quieres utilizando lenguaje natural y el Agent puede generar un diagrama de arquitectura interactivo y visualmente cuidado.

Su flujo principal es:

Código o descripción textual → comprensión mediante Agent → generación de JSON IR → validación mediante reglas → renderizado HTML/SVG → interacción y exportación

A diferencia de herramientas tradicionales como Mermaid o Draw.io, Archify no se limita a «ayudarte a dibujar». Su propuesta consiste en hacer que un Agent genere el diagrama y obligarlo a pasar por un proceso de validación antes de considerarlo un entregable.

Datos clave

• Fecha de creación: 15 de abril de 2026
• Versión actual: v2.17.0-dev.1
• GitHub Stars: más de 31.400
• Licencia: MIT
• Tipos de diagramas: 5 (arquitectura, workflow, secuencia, flujo de datos y ciclo de vida)
• Agents compatibles: Cursor, Claude Code, Codex CLI, OpenCode y DeepSeek Harness
• Instalación: npx skills add tt-a1i/archify -g

2. Capacidades principales

1. Generación de diagramas de arquitectura mediante lenguaje natural

Esta es probablemente la mayor diferencia de Archify.

No necesitas aprender la sintaxis de Mermaid ni conectar manualmente cada elemento. Basta con describir la arquitectura con lenguaje natural.

Por ejemplo:

«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 descripción o analiza directamente el repositorio de código, genera una representación intermedia estructurada en JSON y, posteriormente, el motor de renderizado determinista de Archify genera el diagrama final.

La idea clave es separar la comprensión semántica del modelo de la representación gráfica determinista.

2. Entregables verificables: no solo bonitos, también fiables

Esta es probablemente la característica más importante de Archify.

Muchas herramientas de diagramación con IA permiten que el modelo genere directamente SVG o Mermaid. En esos casos, la calidad final depende en gran medida del propio modelo.

Archify adopta otro enfoque: el modelo solo genera una representación intermedia JSON fuertemente tipada. El encargado de determinar cómo se representan los elementos, cómo se conectan las líneas y si las etiquetas se superponen es un motor de renderizado determinista.

La validación ocurre antes de entregar el resultado.

Se comprueba, entre otras cosas:

• Si el Schema es correcto
• Si la disposición de los elementos es válida
• Si existen conflictos en las rutas
• Si las etiquetas se superponen
• Si las conexiones cumplen las reglas establecidas

Si algo falla, el sistema no devuelve simplemente un enorme stack trace de Node. En su lugar, proporciona códigos de reglas estables y sugerencias de corrección.

Un caso práctico ilustra muy bien esta filosofía.

Cuando el equipo de ThakiCloud ejecutó Archify por primera vez, el propio renderizador rechazó su primer intento.

Y precisamente esa negativa es, según el equipo, una de las razones fundamentales para utilizar la herramienta.

En otras palabras: Archify no considera que una visualización sea válida simplemente porque «se vea bien».

3. Trazabilidad del código: cada nodo puede vincularse con código real

Cuando se habilita la evidencia, los componentes pueden incluir referencias a archivos y líneas específicas del repositorio, asociadas además a un commit determinado.

Al seleccionar un componente, puedes consultar la evidencia de código que respalda su existencia.

Cada nodo del diagrama incluye una marca SRC que permite volver directamente al archivo y a la línea correspondientes.

Esto aborda uno de los problemas más habituales de los diagramas generados por IA:

el diagrama puede parecer convincente y profesional, pero la cadena de llamadas que representa puede no existir realmente en el código.

Archify intenta solucionar precisamente este problema mediante trazabilidad.

4. Before / Delta / After: una función especialmente potente para revisar arquitectura

Durante una revisión de PR o una refactorización arquitectónica, puedes proporcionar las dos instantáneas correspondientes al estado anterior y posterior.

Archify genera entonces tres vistas:

• Before: estado anterior
• Delta: cambios detectados
• After: nuevo estado

El sistema puede identificar con precisión:

• Componentes añadidos
• Módulos eliminados
• Conexiones modificadas
• Nodos desplazados
• Rutas modificadas o redirigidas

Todo el proceso es de solo lectura. Archify no intenta inferir el impacto de los cambios ni decide si el PR debería aprobarse.

La decisión final sigue correspondiendo al ingeniero.

5. Cinco tipos de diagramas + HTML interactivo

Actualmente Archify admite cinco categorías:

• Arquitectura (Architecture): arquitecturas de microservicios, arquitecturas cloud y topologías de red
• Workflow: pipelines CI/CD y procesos de aprobación empresarial
• Secuencia (Sequence): cadenas de llamadas API y procesos de autenticación JWT
• Flujo de datos (Data Flow): pipelines ETL y linaje de datos
• Ciclo de vida (Lifecycle): estados de pedidos y ciclos de vida de tareas

El HTML generado no es simplemente una imagen estática.

Puedes:

• Buscar nodos
• Seguir las relaciones entre componentes
• Rastrear llamadas aguas arriba y aguas abajo
• Comparar componentes según su rol semántico
• Reproducir una historia guiada para recorrer el sistema paso a paso

Todas estas interacciones reutilizan los nodos reales del diagrama y no crean sobre la marcha una topología inventada.

6. Entrega en un único archivo + múltiples formatos de exportación

El resultado final de un diagrama puede entregarse como un archivo HTML autocontenido.

También permite exportar a:

• PNG
• SVG
• WebM
• Tarjeta para compartir de 1200 × 630

No requiere dependencias externas, por lo que puedes enviar el archivo a otra persona y abrirlo directamente.

3. La diferencia fundamental entre Archify y Mermaid

Este es probablemente el punto más importante para entender el posicionamiento de Archify.

Mermaid interpreta su sintaxis y utiliza dagre para realizar el diseño automático. Si el resultado contiene una línea atravesando una caja o una etiqueta superpuesta, Mermaid puede seguir renderizándolo sin impedir la generación.

Archify adopta el enfoque contrario:

obliga al resultado a pasar por una validación antes de convertirse en un entregable.

Una visualización que incumpla las reglas no debería llegar al resultado final.

Dimensión	Mermaid	Archify
Entrada	Sintaxis Mermaid escrita manualmente	Descripción mediante lenguaje natural
Representación intermedia	Renderizado directo	JSON IR fuertemente tipado + validación Schema
Validación	No	Validación automática de layout, rutas y etiquetas antes de la entrega
Trazabilidad del código	No	Cada nodo puede vincularse con archivo y línea de código
Interactividad	Diagrama estático	Búsqueda, seguimiento de rutas y cambio de tema
Revisión de arquitectura	No	Tres vistas Before/Delta/After

Un desarrollador resumió la diferencia de forma especialmente acertada:

«Archify no es simplemente un Mermaid más bonito; integra la herramienta de diagramación dentro del flujo de trabajo de un Agent de programación».

4. Opiniones reales de usuarios: bastante polarizadas

Nota: Los siguientes comentarios se resumen a partir de discusiones públicas en DEV Community, pruebas de ThakiCloud, AI星球 y otras plataformas.

Lo que gusta 👍

• «Archify me ahorró al menos cuatro o cinco reuniones de seguimiento» — comentario de un usuario en X.

• «Cada nodo del diagrama lleva una marca SRC que permite volver al archivo y a la línea concreta. Comparado con los diagramas generados de la nada, pertenece a una categoría completamente diferente» — evaluación de AI星球.

• «Lo probé con un repositorio que no conocía. Lo que más me sorprendió fue poder seleccionar un componente y consultar la evidencia de código que hay detrás, en lugar de aceptar simplemente una caja visual que parece convincente» — evaluación publicada en DEV Community.

• «Un diagrama incorrecto ni siquiera puede generarse. Nuestro primer intento fue rechazado por el renderizador, y precisamente ese rechazo es la razón fundamental por la que esta herramienta merece la pena» — prueba de ThakiCloud.

• «La documentación de arquitectura empieza a sentirse más como un artefacto construido que como un diagrama que alguien tiene que acordarse de mantener» — evaluación de DEV Community.

• «Sin arrastrar elementos ni memorizar sintaxis: describes la arquitectura con lenguaje natural y obtienes directamente un diagrama profesional de nivel empresarial» — tutorial de CSDN.

• «El modelo se encarga de comprender; el motor se encarga de que sea correcto» — resumen de AI星球 sobre el diseño arquitectónico de Archify.

Lo que no gusta 👎

• «No admite edición mediante arrastrar y soltar» — si necesitas ajustar manualmente la posición de cada caja y cada conexión, puede resultar frustrante.

• «Si lo que necesitas es dibujar rápidamente en una pizarra durante una reunión, mover elementos libremente o colaborar online con varias personas, las restricciones de Archify resultan demasiado pesadas y una herramienta de diagramación tradicional puede ser más rápida» — evaluación de verySmallWoods.

• «Archify no sincroniza automáticamente. Cuando cambia la arquitectura, tienes que volver a ejecutar el Agent» — observación publicada en DEV Community. El mismo análisis señala que regenerar el diagrama puede resultar más barato que redibujarlo manualmente, pero no se trata de sincronización en tiempo real.

• «El modelo todavía puede sufrir alucinaciones» — la validación no hace que las alucinaciones sean imposibles; el Agent sigue generando la estructura JSON.

• «El layout automático general, el uso compartido alojado y la edición WYSIWYG están actualmente fuera del alcance del proyecto» — el proyecto mantiene deliberadamente un ámbito bastante limitado.

5. Archify frente a sus competidores

Producto	Precio	Entrada	Validación	Trazabilidad del código	Interactividad	Más adecuado para
Archify	Gratis (MIT)	Lenguaje natural	✅ Validación obligatoria	✅ Referencias a archivos de origen	Búsqueda / seguimiento / rutas	Ingenieros que necesitan diagramas de arquitectura «fiables»
Mermaid	Gratis (MIT)	Sintaxis escrita	❌	❌	Estática	Crear rápidamente diagramas sencillos
Draw.io	Gratis	Arrastrar y soltar	❌	❌	Estática	Usuarios que necesitan edición libre
Eraser	8-16 $/mes	Lenguaje natural + arrastrar y soltar	❌	❌	Limitada	Notas + diagramas con asistencia de IA

Ideas clave

• Archify y Mermaid son herramientas conceptualmente diferentes. Mermaid busca «dibujarlo rápidamente»; Archify busca «dibujarlo correctamente».
• La validación y la trazabilidad del código son las capacidades más difíciles de sustituir de Archify.
• Si necesitas edición libre mediante arrastrar y soltar o colaboración online, Archify no es la opción adecuada.
• Archify está diseñado para mantener los diagramas de arquitectura como si fueran código, no para sustituir a las herramientas generales de dibujo.

6. Ventajas y desventajas

✅ Ventajas

1. Control mediante lenguaje natural: no necesitas aprender Mermaid ni conectar elementos manualmente.
2. Validación obligatoria: los diagramas incorrectos no deberían llegar al resultado final; layout, rutas y etiquetas se validan antes de la entrega.
3. Trazabilidad del código: cada nodo puede vincularse a un archivo y una línea concretos.
4. Tres vistas Before/Delta/After: permite visualizar con precisión los cambios arquitectónicos durante las revisiones de PR.
5. Cinco tipos de diagramas: arquitectura, workflow, secuencia, flujo de datos y ciclo de vida.
6. HTML interactivo: búsqueda, seguimiento de rutas y cambio de tema.
7. Archivo único + múltiples formatos: PNG, SVG, WebM y tarjetas para compartir.
8. Completamente abierto y gratuito: licencia MIT y más de 31.400 Stars.
9. Historia del desarrollador: el proyecto demuestra cómo un desarrollador independiente puede construir una herramienta con una fuerte repercusión en la comunidad.

❌ Desventajas

1. Sin edición mediante arrastrar y soltar: no puedes ajustar manualmente cada caja o conexión.
2. Dependencia de un Agent: necesitas herramientas de programación con IA como Cursor o Claude Code.
3. Sin sincronización en tiempo real: cuando cambia la arquitectura, debes volver a ejecutar el Agent.
4. El modelo todavía puede sufrir alucinaciones: la validación no elimina por completo los errores semánticos.
5. No es ideal para pizarras rápidas o colaboración multiusuario: sus restricciones pueden resultar excesivas.
6. Layout automático general y edición WYSIWYG fuera del alcance actual.
7. Orientado principalmente a desarrolladores: los usuarios no técnicos pueden encontrar una barrera de entrada elevada.

7. ¿Quién debería utilizar Archify?

✅ Recomendado para

• Ingenieros y arquitectos que quieren mantener la documentación de arquitectura como si fuera código.
• Equipos que realizan revisiones de PR y refactorizaciones arquitectónicas con frecuencia, especialmente por la función Before/Delta/After.
• Desarrolladores preocupados por la precisión de los diagramas generados por IA, gracias a la trazabilidad hasta el código fuente.
• Usuarios que ya trabajan con Cursor, Claude Code, Codex u otras herramientas de programación con IA.
• Equipos que necesitan estandarizar el estilo de su documentación arquitectónica.
• Entusiastas del código abierto, gracias a su licencia MIT y disponibilidad gratuita.

❌ No recomendado para

• Usuarios que necesitan edición libre mediante arrastrar y soltar y colaboración online: las restricciones de Archify pueden resultar demasiado pesadas.
• Usuarios que no quieren depender de herramientas de programación con IA: Archify es una Agent Skill, no una aplicación independiente.
• Usuarios que necesitan sincronización en tiempo real: los cambios arquitectónicos requieren volver a generar el diagrama.
• Usuarios no técnicos: Archify está diseñado principalmente para desarrolladores.

8. Puntuación final

Dimensión	Puntuación	Evaluación
Generación mediante lenguaje natural	5,0/5	Describes el sistema en lenguaje natural y el Agent genera el diagrama
Verificabilidad	5,0/5	Validación obligatoria; los diagramas que incumplen las reglas no deberían generarse
Trazabilidad del código	5,0/5	Cada nodo puede vincularse a un archivo y una línea de código
Revisión de arquitectura	5,0/5	Las vistas Before/Delta/After ofrecen un enfoque diferencial
Tipos de diagramas	4,5/5	Cinco categorías cubren la mayoría de los escenarios
Facilidad de uso	3,5/5	Requiere un entorno con Agent y presenta una barrera de entrada para usuarios no técnicos
Actualización en tiempo real	2,5/5	No existe sincronización automática; hay que volver a generar el diagrama

Puntuación general: 4,3/5

(La puntuación se basa en su posicionamiento como «Agent Skill»: la generación mediante lenguaje natural, la validación de entregables y la trazabilidad hasta el código se encuentran entre sus principales fortalezas. Las vistas Before/Delta/After también ofrecen un enfoque novedoso para las revisiones de arquitectura. Por otro lado, la ausencia de edición drag-and-drop y la dependencia de un Agent son sus principales limitaciones. Para desarrolladores que ya han integrado herramientas de programación con IA en su flujo de trabajo, la valoración puede alcanzar 4,7/5. Para usuarios que necesitan dibujo libre y colaboración online, podría quedarse en torno a 3,0/5.)

9. Conclusión final: ¿Merece la pena?

La respuesta es: casi con toda seguridad sí, si ya utilizas herramientas de programación con IA como Cursor o Claude Code.

Archify representa en 2026 un paso importante desde los diagramas generados por IA como simples «esquemas creados a partir de texto» hacia los «entregables verificables».

Más de 31.400 GitHub Stars, el primer puesto de GitHub Trending y numerosas evaluaciones positivas en X con más de 100.000 «Me gusta» indican que el proyecto ha conseguido captar la atención de la comunidad y aborda un problema real:

mantener actualizados los diagramas de arquitectura cuesta mucho, mientras que los diagramas generados por IA no siempre resultan suficientemente fiables.

Pero hay que entender correctamente su posicionamiento.

Archify no pretende sustituir a las herramientas de diagramación tradicionales. Es una herramienta para mantener la arquitectura como si fuera código.

Si necesitas edición libre mediante arrastrar y soltar, colaboración online entre varias personas o sincronización en tiempo real, probablemente Archify te decepcionará.

No admite edición drag-and-drop y, cuando cambia la arquitectura, es necesario volver a ejecutar el Agent.

Su escenario ideal es otro:

ya utilizas herramientas de programación con IA y quieres convertir la documentación arquitectónica en un artefacto mantenible, verificable y trazable, siguiendo un enfoque similar al del código fuente.

Archify merece especialmente la pena si:

• Ya utilizas Cursor, Claude Code, Codex u otras herramientas de programación con IA.
• Necesitas actualizar la documentación arquitectónica con frecuencia, pero mantenerla manualmente resulta demasiado costoso.
• Te preocupa que una IA pueda inventar componentes o conexiones y quieres que cada nodo pueda comprobarse contra el código fuente.
• Realizas revisiones de PR o refactorizaciones arquitectónicas y necesitas comparar con precisión el antes y el después.
• Quieres estandarizar la documentación arquitectónica de tu equipo.

Conviene pensárselo dos veces si:

• Necesitas edición libre y colaboración online: Draw.io o Figma pueden encajar mejor.
• No quieres depender de herramientas de programación con IA.
• Necesitas sincronización en tiempo real: Archify requiere volver a generar el diagrama.
• Eres un usuario no técnico.

En una frase

Archify está diseñado para ingenieros que ya utilizan herramientas de programación con IA y quieren mantener sus diagramas de arquitectura como si fueran código.

Su combinación de lenguaje natural, validación obligatoria y trazabilidad hasta el código resulta especialmente potente en 2026. Sin embargo, la ausencia de edición mediante arrastrar y soltar y su dependencia de Agents hacen que esté mucho más orientado a un flujo de trabajo ingenierizado que a una experiencia de pizarra libre.

Si ya utilizas Cursor o Claude Code, Archify es una de las Agent Skills que más merece la pena probar en 2026.

10. Preguntas frecuentes (FAQ)

¿Archify es gratuito?

Sí, es completamente gratuito y de código abierto, bajo licencia MIT. La instalación, el uso, la modificación y el uso comercial son gratuitos.

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

Mermaid está pensado para «dibujarlo rápidamente», mientras que Archify busca «dibujarlo correctamente». Archify valida obligatoriamente el layout, las rutas y las etiquetas antes de entregar el resultado. Además, sus nodos pueden vincularse al código fuente.

¿Qué entorno necesita Archify?

Necesita Node.js 18 o una versión posterior.

La instalación se realiza mediante:

npx skills add tt-a1i/archify -g

Después puedes utilizarlo desde Cursor, Claude Code, Codex CLI u OpenCode.

¿Archify admite español?

Sí. Archify utiliza el Agent para interpretar descripciones realizadas en lenguaje natural, por lo que admite entradas en varios idiomas. Agents como Claude Code también son capaces de trabajar en español.

¿Qué tipos de diagramas puede generar Archify?

Cinco tipos: arquitectura (Architecture), workflow, secuencia (Sequence), flujo de datos (Data Flow) y ciclo de vida (Lifecycle).

¿Archify puede sincronizar automáticamente los cambios del código en tiempo real?

No. Cuando cambia la arquitectura, es necesario volver a ejecutar el Agent para generar un nuevo diagrama. Sin embargo, regenerarlo puede resultar considerablemente más barato que reconstruir manualmente el diagrama.

¿Para qué sirve mejor Archify?

Principalmente para mantener documentación de arquitectura, revisar PR, representar diseños técnicos, estandarizar diagramas dentro de un equipo y visualizar repositorios de código.

No está pensado principalmente para pizarras rápidas, edición libre mediante arrastrar y soltar o colaboración online en tiempo real.