BookinglyTech News
Software

Archify convierte una descripción en el chat en un diagrama de arquitectura HTML

La skill para agentes de programación genera un único archivo HTML autocontenido con el diagrama y permite refinarlo conversando. Va por la versión v2.17.0-dev.1, todavía en desarrollo.

2 min de lecturaConsole.dev0 vistas

Archify es una skill para agentes de programación que toma una descripción en lenguaje natural de un sistema y devuelve un diagrama de arquitectura en HTML. No hay editor gráfico de por medio: se describe la infraestructura en el chat y el agente dibuja. El proyecto está en la versión v2.17.0-dev.1, es decir, en desarrollo, y se instala sobre Cursor, Claude Code, Codex y OpenCode.

La salida es un único archivo HTML sin dependencias, sin servidor y sin runtime. Se abre en cualquier navegador, se puede adjuntar a un correo o a un comentario de pull request, y el HTML lleva incorporada la navegación del diagrama: cámara semántica, recorridos por las rutas del sistema, reproducción paso a paso de una ruta concreta y anclaje a un momento concreto para compartir un enlace estable a ese nodo.

Qué produce

El catálogo cubre cinco tipos de diagrama: arquitectura (componentes, recursos cloud, bases de datos, colas y sus conexiones, con límites de seguridad y topología de microservicios), flujo de trabajo por carriles, secuencia de llamadas API, flujo de datos con linaje y partición de información personal, y máquinas de estado con reintentos, cancelación y estados terminales.

Cada tipo se renderiza con uno de los cuatro presets visuales (Classic, Signal Flow, Blueprint y Editorial), que comparten la misma geometría y vienen con variante clara y oscura coordinadas. Hay siete tipos semánticos de componente, desde frontend y API hasta bus de mensajes, base de datos, CDN, servicios gestionados y autenticación.

La exportación es lo que más se aparta de otras herramientas del estilo: PNG transparente, JPEG y WebP rasterizados de forma nativa por el navegador hasta 4× de resolución, SVG vectorial con los dos juegos de variables y una regla @media prefers-color-scheme (un solo archivo en un README que sigue el tema del lector) y WebM para animación. Además hay un botón que copia el PNG directamente al portapapeles para pegarlo en Slack, Notion, GitHub o Figma sin pasar por disco.

Cómo se instala

El comando es npx skills add tt-a1i/archify -g, con variantes por agente para una instalación no permanente. Raven no aparece entre los destinos del instalador: en ese caso hay que descomprimir archify.zip en ~/.raven/workspace/skills, lo que deja la skill en ~/.raven/workspace/skills/archify.

El flujo son tres pasos: instalar, describir el sistema o pedirle al agente que analice el repositorio, y pedirle que dibuje. A partir de ahí se refina hablando, con instrucciones del tipo añadir un Redis o mover la autenticación.

La pega es la de siempre en este tipo de proyectos: lo que hay publicado es la página del propio autor. No incluye una demo de terceros ni datos de rendimiento, y la cifra de nueve comprobaciones de validación superadas es suya, no de una auditoría externa. Lo interesante para quien administra sistemas es el formato de salida, no la promesa: un HTML sin dependencias y un SVG que se adapta al tema son fáciles de meter en documentación interna o en un repositorio sin montar nada.