Archify: convertir un repositorio o una descripción en un diagrama de arquitectura

Archify es una skill para Claude Code, Codex CLI, Cursor y OpenCode que convierte la descripción de un sistema —o directamente un repositorio— en un mapa técnico interactivo que puedes compartir. Se instala con npx skills add tt-a1i/archify -g, es MIT, y lo que devuelve no es una imagen: es un archivo HTML autocontenido con el que se puede interactuar.

Si alguna vez has perdido una tarde en Figma colocando cajitas para explicar una arquitectura que ya tenías clara en la cabeza, esto va de eso.

Qué genera

Cinco tipos de diagrama técnico —arquitectura, flujo de trabajo, secuencia, flujo de datos y ciclo de vida—, con cuatro estilos visuales, tema claro y oscuro, y movimiento opcional.

Lo importante no es que sea bonito, es de qué está hecho: un JSON tipado con comprobaciones deterministas detrás, y de ahí salen un HTML autocontenido, más PNG, SVG, WebM y una tarjeta de 1200×630 para compartir. O sea que el mismo diagrama te sirve para la documentación, para una presentación y para un tuit, sin rehacerlo tres veces.

Las dos funciones que le veo más valor real:

Comparar dos versiones antes de fusionar. Coges dos instantáneas validadas y te las enseña como Antes / Diferencia / Después, con el detalle exacto de qué se añadió, qué se quitó, qué cambió, qué se movió y qué cambió de ruta. Revisar un cambio de arquitectura mirando un diagrama comparado es otro deporte frente a leerse el diff.

Que no se lo invente. Puedes buscar nodos, abrir el código fuente verificado contra su revisión, y trazar qué depende de qué aguas arriba y aguas abajo con las rutas exactas. El proyecto insiste en que la interacción está anclada al código real y no a topologías inventadas, que es justo el fallo clásico cuando le pides un diagrama a un modelo: te dibuja algo verosímil que no se corresponde con tu sistema.

Cómo instalarlo

npx skills add tt-a1i/archify -g

La -g lo instala de forma global, disponible en todos tus proyectos. Después basta con pedírselo al agente en lenguaje normal:

Usa archify para mapear la arquitectura en ejecución de este repositorio.

Funciona igual en Claude Code y en Codex CLI, porque es el mismo formato abierto de skill. Si usas Cursor, tienen una guía de inicio específica con los comandos exactos, globales y por proyecto.

Cómo sacarle partido

Un consejo por experiencia con este tipo de herramientas: cuanto más concreto el encargo, más útil el diagrama. Comparar:

Hazme un diagrama de este proyecto.

Usa archify para hacer un diagrama de secuencia de qué pasa exactamente
desde que alguien envía el formulario de alta hasta que recibe el correo
de confirmación. Quiero ver los puntos donde puede fallar.

El primero te devuelve un mapa general que ya tenías en la cabeza. El segundo te devuelve algo que puedes usar para encontrar un problema.

Y una aplicación que se sale de lo técnico: estos diagramas valen igual para explicar un proceso de negocio. Un flujo de facturación, el recorrido de un paciente por una clínica, los pasos de un alta de cliente. La skill no sabe que estás hablando de software; sabe convertir una descripción estructurada en un mapa.

Aplicaciones prácticas

• Documentar lo que ya existe sin dedicarle una semana, y que además se pueda verificar contra el código.
• Revisar cambios de arquitectura con la comparación Antes / Diferencia / Después en vez de con un diff de 400 líneas.
• Explicar un sistema a alguien que no lo conoce: a un cliente, a alguien que entra nuevo, o a otro agente.
• Dibujar procesos de negocio para presentaciones, que es donde más partido le va a sacar quien no programa.

Cuándo no te compensa

• Si necesitas un diagrama muy concreto a tu manera, con tu iconografía y tu maquetación exacta, la herramienta decide el estilo por ti.
• Si tu sistema es pequeño, un rato en una pizarra es más rápido.
• Si esperabas un editor visual, no lo hay: se genera desde el chat y se ajusta pidiéndoselo otra vez.
• El proyecto va rápido de versiones (por la 2.14 a agosto de 2026). Eso es buena señal de mantenimiento, pero conviene reinstalar de vez en cuando.

Un apunte de transparencia: el repositorio tiene patrocinadores con enlaces de afiliación en su README. No afecta a la licencia ni al funcionamiento, pero conviene saberlo cuando leas sus recomendaciones de proveedores.

Preguntas frecuentes

¿Archify funciona con Codex además de con Claude Code?

Sí. Está declarado para Raven, Cursor, Claude Code, Codex CLI y OpenCode. Es una skill en formato abierto, así que los distintos agentes leen el mismo archivo.

¿Los diagramas son fiables o se los inventa?

Ese es el punto en el que más insiste el proyecto: la interacción está anclada al código real, puedes abrir la fuente verificada contra su revisión y trazar las rutas exactas. Aun así, revísalo: un diagrama convincente y equivocado es peor que no tener ninguno.

¿En qué formatos puedo exportar?

HTML autocontenido, que es el formato principal e interactivo, más PNG, SVG, WebM y una tarjeta de 1200×630 para compartir en redes.

¿Sirve para diagramas que no sean de software?

Sí. Trabaja sobre descripciones estructuradas, así que un proceso de facturación o el recorrido de un cliente funcionan igual de bien que una arquitectura técnica.

¿Hace falta pagar algo?

No, la skill es MIT y gratuita. Lo que consumas es el uso normal de tu agente, igual que cualquier otra petición que le hagas.