Archify: tu agente convierte un repo en un diagrama interactivo

“Deja de dibujar a mano la arquitectura de tus sistemas”, decía el tuit de Marco Ramilli. Habla de Archify, una skill para agentes de código que en seis meses ha llegado a casi 79.000 estrellas en GitHub y, según su propio README, más de 130.000 instalaciones.

Qué hace

Archify no es una app de diagramas, es una skill: instrucciones que tu agente de código carga para saber cómo dibujar. Le describes algo y el agente genera un fichero HTML interactivo con el diagrama.

npx skills add tt-a1i/archify -g

Y luego, al agente:

Use Archify to diagram a web request: Browser calls the API,
the API checks Redis, and a cache miss queries PostgreSQL and fills the cache.

A partir de ahí sigues conversando: “añade autenticación”, “resalta el camino del cache miss”, “cambia al tema claro”. Funciona con Claude Code, Codex CLI, Cursor y OpenCode.

Del código al mapa

Lo más útil para un equipo es apuntarlo a un repositorio. El agente lee el código y produce un mapa de arquitectura con enlaces al fuente, en lugar de un dibujo de memoria. El proyecto enseña como ejemplo el mapa de un repo público trazado sobre un commit concreto, con el JSON tipado que lo genera.

Sobre el diagrama puedes:

• Seguir el alcance de un nodo: todo lo que depende de él aguas abajo.
• Resaltar rutas entre dos componentes, por ejemplo del frontend a la base de datos.
• Filtrar por capas, como backend y base de datos.
• Presentarlo a pantalla completa.

No se limita al software: la galería incluye flujos de agentes, diagramas de secuencia y casos de usuarios con planes de viaje o revisiones de contratos.

Dónde encaja

Es otro ejemplo de skills que convierten al agente en una herramienta de propósito concreto, como book-to-skill con los libros técnicos. Si estás aterrizando en un repo ajeno o documentando el tuyo, un mapa navegable sale más barato que una tarde con una herramienta de dibujo.

Los límites

• El diagrama es tan bueno como la lectura del agente. En repos grandes, el agente resume y puede dejarse dependencias o inventarse alguna. Los enlaces al código te permiten comprobarlo; hazlo antes de meterlo en la documentación oficial.
• Tokens. Leer un repositorio entero para mapearlo consume contexto. En monorepos, acota a un servicio o carpeta.
• Un HTML, no un modelo vivo. El diagrama no se actualiza solo cuando cambia el código. Si lo quieres al día, tienes que regenerarlo.
• Las estrellas, con cautela. El tuit hablaba de 76.933 y el repo ya pasa de 78.900 dos días después. Un crecimiento así suele venir de tendencias y patrocinios, que el README muestra en abundancia, más que de uso sostenido.