Archify: el diagrama de tu sistema, sin abrir un editor

Qué es y qué hace

Archify es una «skill»: un paquete de instrucciones y herramientas que le instalas a tu asistente de programación para que sepa hacer algo concreto. En este caso, dibujar. Le describes un sistema por chat y te devuelve un diagrama en un archivo HTML que se abre solo, sin depender de ninguna web. ¹

Dibuja cinco tipos de esquema, según su repositorio: arquitectura (componentes, servicios, almacenamiento y sus fronteras), flujo de trabajo (aprobaciones, despliegues, llamadas a herramientas), secuencia (quién llama a quién y en qué orden), flujo de datos (por dónde pasa la información y dónde hay datos sensibles) y ciclo de vida (estados, reintentos, finales posibles). ¹

El diagrama que sale no es una imagen muerta. Permite buscar un nodo, resaltar un camino concreto entre dos puntos y comparar piezas por su papel en el sistema. De ahí se exporta a PNG, SVG, vídeo WebM y una tarjeta de 1200×630 píxeles para compartir. ¹

Lo mejor, para mí, es que no necesita el código. Puedes describirle un sistema que todavía no existe, o uno que existe pero no es tuyo, y seguir afinando a base de frases sueltas: «añade Redis», «mueve la autenticación a la izquierda». ¹

Cómo se instala y qué necesitas

Se instala como skill global con una línea: `npx skills add tt-a1i/archify -g`. También hay forma de usarlo sin dejarlo instalado, con `npx skills use tt-a1i/archify@archify`. Necesitas Node.js; el repositorio pide una versión reciente. ¹

Funciona con Cursor, Claude Code, Codex CLI, opencode y algún entorno más que ellos listan. Es decir: si ya trabajas con un agente en el terminal o en el editor, esto se le engancha encima. ¹

Un detalle que agradezco: avisan de que la herramienta consulta si hay actualizaciones contra un servidor y dicen cómo apagarlo, con la variable `ARCHIFY_UPDATE_CHECK_DISABLED=1`. En una empresa con red cerrada, ese dato ahorra una conversación con sistemas. ¹

Licencia MIT, así que se puede usar, modificar y distribuir sin permiso previo. Según GitHub, el repositorio acumula más de 65.000 estrellas y unos 4.400 forks. Es una señal de atención, no de calidad: mucha gente lo ha marcado, no necesariamente lo usa cada día. ²

Lo que dicen ellos mismos que no hace

Esto es lo que más respeto del repositorio, y por eso lo traigo. Declaran fuera de alcance, con estas palabras, cuatro cosas: leer diagramas Mermaid automáticamente, colocar cajas de forma automática en cualquier caso general, alojar los diagramas para compartirlos y editarlos arrastrando con el ratón. ¹

Traducido: si esperabas un Visio con IA, no es esto. Si vienes de tener los diagramas en Mermaid, no los va a importar solos. Y si en tu equipo la gente edita arrastrando cajas, aquí se edita hablando.

También validan lo que producen: si falta información —por ejemplo, quién es el responsable de un despliegue o en qué región vive— el diagrama falla en vez de inventárselo. Me parece la decisión correcta, aunque al principio moleste.

Para qué lo usaría fuera del mundo del software

Aquí pone «arquitectura» porque nació entre programadores, pero lo que hace es dibujar sistemas. Y un sistema es cualquier cosa con pasos, responsables y datos moviéndose.

El diagrama de flujo de datos, por ejemplo, sirve igual para explicar por dónde viaja la información de un cliente en tu empresa: entra por un formulario, pasa por un correo, acaba en una carpeta compartida y en un programa de facturación. Ese dibujo, hecho una vez, contesta media auditoría y casi todas las preguntas de un empleado nuevo.

El de ciclo de vida sirve para un pedido, una reclamación o un expediente: estados por los que pasa, qué ocurre cuando se atasca, dónde termina. Cuando lo tienes delante en una pantalla, las excepciones que nadie había contado saltan solas.