La idea clave
Genera diagramas HTML y SVG a partir de una estructura que puedes revisar. La clave es comprobar que cada componente y cada conexión existen.
Una aplicación funciona hasta que alguien pregunta cómo encajan sus piezas. Ahí suelen aparecer las cajas dibujadas deprisa y las flechas que nadie sabe justificar. Archify propone generar un mapa del sistema con ayuda de un agente y mantener una representación estructurada detrás del resultado.
Cómo pasa de una descripción al diagrama
El proyecto utiliza Node.js: el agente produce una estructura JSON tipada y Archify la convierte en HTML y SVG mediante renderizado y validación. Incluye diagramas de arquitectura, flujos, secuencias, datos y ciclos de vida. El código tiene licencia MIT.
También contempla comparar versiones de un diagrama. Su documentación distingue los cambios en lo representado de los efectos reales en producción. Esa separación evita interpretar una comprobación de estructura como una garantía de que el sistema funciona correctamente.
Un encargo mejor que «hazme un dibujo»
Supongamos que quieres explicar un sistema de reservas. Nuestro ejemplo de encargo sería: «Representa cómo una persona elige una fecha, cómo se comprueba la disponibilidad y dónde se guarda la reserva. Incluye el caso en que dos personas eligen la misma plaza. Marca lo que no puedas confirmar».
El caso de conflicto importa tanto como el recorrido normal. Obliga a aclarar dónde se toma una decisión y qué componente la controla. Para una primera revisión, tres relaciones confirmadas sirven más que veinte flechas inferidas.
Qué debería entregar un buen mapa
Encargo propuesto por Texploto
Representa el recorrido de una reserva: navegador, API y base de datos. Marca dónde se comprueba la disponibilidad y qué ocurre si otra persona reserva antes. Junto a cada relación, identifica el archivo o requisito que la respalda. Separa las suposiciones pendientes de confirmar.
El resultado sirve para una revisión si puedes seguir una reserva sin pedir una explicación adicional y localizar la evidencia de la comprobación de disponibilidad. Si solo muestra tres cajas conectadas, todavía falta la decisión más importante. Para gráficos centrados en explicar conceptos, consulta también Diagram Design.
Cómo empezar y revisar el resultado
El inicio guiado permite elegir el agente. Puedes partir de una descripción sin repositorio; si aportas código, delimita qué carpetas o componentes debe analizar. No hace falta entregar información que no aporte nada al mapa.
Después revisa nombres, dirección de las flechas y condiciones de cada bifurcación. Busca una relación cuyo origen conozcas y comprueba que el dibujo la explica correctamente. Si el agente inventa un servicio inexistente, corrige la estructura antes de ajustar colores o animaciones.
Dónde aporta más
Lo vemos especialmente interesante para incorporar a alguien a un proyecto o discutir una migración. El agente y su servicio pueden tener costes propios, aunque el código de Archify sea abierto. El resultado merece evaluarse por cuánto facilita una conversación técnica: si dos personas entienden igual dónde se guarda una reserva, el mapa está haciendo su trabajo.
Guía basada en la documentación consultada el 13 de septiembre de 2026; no hemos realizado una prueba funcional del proyecto. Consulta también los diez proyectos de esta edición semanal.
