- Transforma repositorios de código completos en mapas visuales interactivos mediante agentes de IA.
- Permite realizar comparaciones detalladas entre versiones de arquitectura para detectar cambios semánticos.
- Ofrece un sistema de validación riguroso que evita la generación de diagramas erróneos o visualmente rotos.
- Soporta múltiples tipos de esquemas técnicos, desde flujos de datos hasta diagramas de ciclo de vida y ERD.
A veces, intentar explicar cómo funciona un sistema complejo es mucho más pesado que programarlo. Cuando te toca tomar decisiones técnicas o presentar un proyecto a un cliente, necesitas una forma clara de contar el proceso sin que la gente se pierda entre tantas piezas y dependencias. Ya sea un pipeline de datos o una arquitectura de software, si sueltas toda la información de golpe, el interlocutor acaba desconectado, pero si vas pieza a pieza, necesitas una metodología que sea comprensible tanto para un desarrollador como para un gerente.
En este escenario aparece Archify, una herramienta de código abierto que ha causado sensación en GitHub al permitir que la IA mapee repositorios enteros en un abrir y cerrar de ojos. No se trata solo de hacer un dibujo bonito, sino de integrar la capacidad de diagramación directamente en el flujo de trabajo de agentes de programación como Claude Code o Cursor. Es, básicamente, pasar de tener miles de líneas de código a un mapa visual interactivo en HTML que cualquier persona puede explorar sin necesidad de instalar nada complejo.
¿Qué hace que Archify sea diferente al resto?
Seguramente ya conoces herramientas como Mermaid o D2, que son geniales para convertir texto en esquemas. Sin embargo, Archify juega en otra liga porque no se limita a renderizar texto, sino que está embebido en el flujo del agente. El agente de IA analiza el código, entiende la lógica y genera una representación intermedia en JSON (IR) que luego Archify valida y renderiza. Esto soluciona el problema típico de las IAs que dibujan rápido pero se equivocan en las conexiones; aquí, si el esquema no pasa los controles de calidad y ruteo, el sistema devuelve un error detallado para que el agente lo corrija antes de que tú veas el resultado final.
Una de las joyas de la corona es su capacidad de comparar dos versiones de una arquitectura. Mientras que en un pull request normal solo ves cambios de líneas de código, con Archify puedes generar un «diff» visual. Puedes ver exactamente qué componente se ha movido, cuál se ha eliminado o cómo se ha reencaminado una conexión. Esta función de Arquitectura Delta es fundamental para evitar que la documentación del wiki se quede obsoleta mientras el código sigue evolucionando.
Tipos de diagramas y capacidades técnicas
La herramienta no se queda en un solo formato, sino que cubre prácticamente todas las necesidades de un equipo técnico. Puedes generar diagramas de arquitectura para ver servicios y límites, workflows para CI/CD, diagramas de secuencia para trazas asíncronas o llamadas a APIs, y flujos de datos para entender el linaje de la información. Recientemente se han añadido capacidades para crear ERD (entidad-relación), diagramas de clases, árboles de jerarquía y hasta líneas de tiempo para revisiones de incidentes.
El resultado final es un archivo HTML autónomo que permite buscar nodos específicos, rastrear rutas entre componentes y cambiar entre temas claros y oscuros. Además, permite exportar el trabajo en formatos como PNG, SVG o WebM. Para los que vienen de Mermaid, Archify no re-renderiza el código directamente, sino que reinterpreta la topología para crear un esquema mucho más robusto y visualmente atractivo.
Instalación y flujo de trabajo
Para ponerlo en marcha, la mayoría de los usuarios utilizan comandos simples de npx para añadir la skill a sus agentes. Por ejemplo, en Claude Code u OpenCode se instala con una sola línea, mientras que para Cursor o Codex CLI existen comandos específicos. Una vez instalado, puedes usar el comando archify doctor para verificar que todo esté en orden o generar ejemplos con el modo demo.
El proceso de creación sigue una cadena lógica: el agente genera el JSON IR, se ejecutan las validaciones de esquema y layout, y finalmente se entrega el HTML. Si buscas la máxima calidad, existe el perfil «showcase», que exige que el diagrama pase nueve comprobaciones estrictas sin errores de composición. Si algo falla, el sistema no te da una imagen rota, sino un recibo de reparación con códigos de regla específicos que el agente puede procesar automáticamente.
La historia detrás del proyecto
Más allá de la técnica, Archify tiene una carga humana inspiradora. Fue creado por un desarrollador conocido como «Teacher Sunny», quien enfrentó enormes barreras laborales debido a su formación en una escuela vocacional, a pesar de haber sido el mejor de su promoción en la transferencia universitaria. Tras sufrir el rechazo de departamentos de RRHH que solo miraban el título y no la capacidad, decidió que la mejor forma de demostrar su talento era a través del código abierto.
Este proyecto se convirtió en su mejor currículum, demostrando que el valor real de un ingeniero reside en lo que es capaz de construir y en el valor que aporta a la comunidad. Archify no solo es una herramienta de productividad, sino un testimonio de que el trabajo tangible y la contribución al ecosistema open source pueden romper los techos de cristal de la educación tradicional.
Contar con una herramienta que transforme el código en mapas visuales interactivos y permita comparar versiones de arquitectura simplifica drásticamente la comunicación técnica. Al delegar la validación y el renderizado en un sistema determinista basado en JSON, se elimina la frustración de los diagramas manuales y se garantiza que la documentación evolucione al mismo ritmo que el software, convirtiendo la complejidad técnica en algo digerible para cualquier miembro del equipo.
Redactor apasionado del mundo de los bytes y la tecnología en general. Me encanta compartir mis conocimientos a través de la escritura, y eso es lo que haré en este blog, mostrarte todo lo más interesante sobre gadgets, software, hardware, tendencias tecnológicas, y más. Mi objetivo es ayudarte a navegar por el mundo digital de forma sencilla y entretenida.