Generar UML con IA

En dos cosas, y son las dos que más tiempo cuestan. La primera es la página en blanco: nombrar los ocho sustantivos de un dominio y ponerlos en un lienzo es media hora de trabajo que no produce nada sobre lo que nadie vaya a discutir, y un modelo lo hace en segundos. La segunda es consultar la notación: qué punta de flecha significa realización, en qué extremo va el rombo, qué aspecto tiene una multiplicidad 0..* junto a un 1. Ese conocimiento está en la especificación, la especificación está en los datos de entrenamiento, y recordarlo nunca fue la parte interesante del oficio.

El diagrama de la cabecera de este artículo salió de una descripción de dos frases. Las clases están bien, los atributos son plausibles, y alguien que conozca el dominio puede leerlo y empezar a discutir sobre las partes que importan, que es exactamente para lo que sirve un primer borrador.

Se repiten entre modelos y entre prompts, porque por debajo son todos el mismo fallo: el generador elige la respuesta más común, y tu sistema no es el sistema más común.

1. Composición dibujada como agregación, o como asociación simple. El rombo hueco es la opción que parece segura, así que es la que vuelve. Es también la que dice que las partes sobreviven al todo, una afirmación sobre el borrado y sobre la propiedad que nadie comprobó.
2. Multiplicidades por defecto a uno-a-muchos. Sin que se pida, casi toda asociación vuelve como 1 a 0..*. A veces está bien. Cuando no, es el tipo de error que sobrevive hasta el esquema.
3. Interfaces inventadas para una sola implementación. Los modelos han leído muchísimo Java empresarial. Si tu dominio tiene un solo proveedor de pagos, una «interface» IPaymentProvider en el borrador es decoración.
4. El tipo de diagrama completamente equivocado.Pregunta por comportamiento en el tiempo y vuelve un diagrama de clases, porque los diagramas de clases dominan los datos de entrenamiento. Si la pregunta era «qué pasa cuando falla el pago», querías un diagrama de secuencia.

Ninguno de ellos es difícil de arreglar. Todos son difíciles de notar, porque un tipo de relación equivocado parece exactamente igual de seguro que uno correcto, y el diagrama está ordenado en ambos casos.

Tres ingredientes, y el tercero es el que la gente se deja.

1. Nombra el tipo de diagrama.«Un diagrama de clases», no «un diagrama UML». Si no sabes cuál quieres, es una pregunta de modelado y los catorce tipos están aquí.
2. Dale tus sustantivos. Las palabras que tu equipo ya usa, escritas como las escribe tu código. Un modelo que se inventa BorrowRecord cuando tú dices Loan produce un diagrama que nadie puede mapear a nada.
3. Declara la pregunta que el diagrama debe responder.«...que muestre qué pasa con los préstamos cuando se retira un ejemplar.» Eso es lo que convierte una imagen plausible en una afirmación comprobable, y es la frase de mayor valor de cualquier prompt.

Hazla antes de que el diagrama salga de tu pantalla. Se corresponde uno a uno con los cuatro fallos de arriba, y es toda la diferencia entre un diagrama generado que ayuda y uno que desinforma calladamente a un equipo durante un año.

Dos minutos no es una exageración: en un diagrama de ocho cajas son cuatro vistazos. Lo que lo hace funcionar es saber qué estás buscando, y por eso la lista es corta y concreta en vez de «revisa con cuidado».

Archyno genera dentro de un modelo en vez de dentro de una imagen, y esa diferencia es la razón de que este artículo pueda terminar donde termina. A la IA se le entrega el mismo metamodelo que impone el editor, así que lo que vuelve son elementos y relaciones que la notación permite de verdad: una realización solo puede aterrizar en una interfaz, una relación de servicio de ArchiMate solo puede conectar las capas que permite la especificación. Las categorías de error de arriba se encogen hasta las que ninguna herramienta puede cazar: las que van de tu sistema.

Como es un modelo y no una imagen, la corrección es una edición y no otro prompt. Cambia el rombo, cambia la multiplicidad, renombra la clase, y el renombrado llega a todas las vistas en las que aparece el elemento. El resultado se exporta como PNG, SVG, Mermaid, XMI o un fichero .qea de Sparx, que es lo que convierte un diagrama generado en algo que puedes entregarle a un equipo que no usa la misma herramienta que tú.

La mitad ArchiMate de esto, donde las reglas de capas hacen la generación a la vez más difícil y más útil, está en generar diagramas ArchiMate con IA. Lo que la herramienta hace y lo que no, está dicho sin rodeos en por qué Archyno.