Arquitectura como código: cómo los LLM aceleran el diseño de sistemas

La documentación arquitectónica en grandes empresas es casi siempre un dolor. Semanas de aprobaciones, ediciones interminables de diagramas en Draw.io, versionado a través de Confluence que se parece más a una excavación arqueológica que a un proceso de ingeniería. El equipo del departamento de IA del grupo BCS decidió que era hora de terminar con esto y mostró cómo el enfoque Architecture as Code combinado con asistentes LLM puede cambiar radicalmente las reglas del juego.

Alexey Pronsky, responsable de la arquitectura en la división de IA de BCS, describió un problema familiar para cualquier arquitecto corporativo. Su equipo construye sistemas de agentes, asistentes de IA, soluciones OCR, análisis de voz y modelos clásicos de ML. Detrás de cada uno de estos proyectos existe una decisión arquitectónica — un documento que debe pasar por un proceso de aprobación en múltiples etapas con el negocio, la arquitectura corporativa, el servicio de seguridad de la información y los propietarios de sistemas relacionados. En promedio, el camino desde recibir los requisitos del negocio hasta la aprobación final toma dos o tres semanas. Para una industria donde la velocidad de iteración determina la competitividad, esto es inaceptablemente lento.

La esencia del enfoque propuesto es mover la documentación arquitectónica de editores visuales y sistemas wiki al código. El equipo de BCS eligió Structurizr — una herramienta que permite describir la arquitectura de sistemas de software usando un DSL especial. En lugar de arrastrar manualmente bloques en un lienzo Draw.io, el arquitecto describe componentes, relaciones y contextos en texto. Esto proporciona todos los beneficios que los desarrolladores han obtenido desde hace mucho tiempo del enfoque Infrastructure as Code: versionado a través de Git, revisión de código, generación automática de diagramas y, críticamente, la capacidad de conectar un asistente LLM.

Aquí es donde las cosas se ponen realmente interesantes. Pronsky muestra cómo Claude Code, actuando como asistente LLM, puede asumir una porción significativa del trabajo rutinario del arquitecto. Cuando la arquitectura se describe en código en lugar de imágenes, un modelo de lenguaje puede analizar la estructura existente, sugerir cambios, generar nuevos componentes e incluso ayudar con la preparación de documentación para aprobación. Esencialmente, lo mismo que sucedió con la escritura de código en el último año está sucediendo — los asistentes LLM no reemplazan al especialista, pero aceleran dramáticamente su trabajo asumiendo tareas rutinarias.

Es importante entender el contexto en el que surgió esta práctica. Architecture as Code no es una idea nueva. Herramientas como Structurizr, PlantUML y Mermaid existen desde hace mucho tiempo.

Sin embargo, antes de la llegada de modelos de lenguaje potentes, las descripciones textuales de arquitectura seguían siendo un enfoque de nicho: el umbral de entrada era alto y la ventaja sobre editores visuales no era clara. Los LLM cambiaron esta ecuación. Un modelo que trabaja libremente con texto y código transforma Architecture as Code de una práctica elegante pero laboriosa en un flujo de trabajo genuinamente eficiente.

Un arquitecto formula requisitos, el asistente genera un borrador en DSL, la persona revisa y corrige — y el ciclo se comprime de semanas a días.

Para el entorno empresarial, este enfoque conlleva beneficios adicionales. Cuando la arquitectura vive en un repositorio Git, cada cambio es transparente y rastreable. La revisión de código de decisiones arquitectónicas se convierte en un proceso tan natural como la revisión de código de software. El servicio de seguridad puede automatizar parte de las verificaciones. Y lo más importante, se reduce la dependencia de una herramienta de visualización específica. Los diagramas se generan automáticamente a partir del código y se pueden representar en cualquier renderizador compatible.

La experiencia de BCS es indicativa también porque no se trata de una startup experimentando con nuevos enfoques, sino de un gran grupo financiero con requisitos estrictos de documentación y aprobación. Si Architecture as Code con soporte LLM funciona en un contexto tan regulado, el enfoque es lo suficientemente maduro para adopción corporativa ampla. Probablemente veremos una ola de implementaciones similares en el próximo año — especialmente en empresas que ya utilizan activamente asistentes LLM para desarrollo y quieren extender esta práctica a disciplinas de ingeniería relacionadas.