Durante años, la documentación de arquitectura de software ha tenido un problema crónico: nace con buenas intenciones y muere en silencio. Un diagrama en una wiki, una slide en un PowerPoint o un esquema “provisional” en una carpeta compartida suelen envejecer mal. El sistema cambia, se añaden servicios, se retiran APIs, se migra a la nube o se introduce un nuevo proveedor… y el dibujo se queda congelado en el tiempo. En ese contexto, cada vez más equipos están mirando hacia un enfoque que pretende resolver el origen del problema: tratar la arquitectura como algo que se describe y se mantiene como si fuera código.
Ahí entra LikeC4, un proyecto open source que propone una idea sencilla y ambiciosa: definir la arquitectura mediante un lenguaje (DSL) y generar a partir de ese modelo diagramas que se mantengan siempre actualizados. En vez de “dibujar” la arquitectura y perseguirla después, el modelo se convierte en la fuente de verdad y los diagramas pasan a ser un resultado compilado, reproducible y versionado.
Un modelo único, muchos diagramas
LikeC4 se inspira en el enfoque C4 (muy popular en entornos de arquitectura de software) y en lenguajes como Structurizr DSL, pero añade una capa de flexibilidad: no obliga a una notación rígida. Permite definir tipos de elementos, estilos, niveles anidados y reglas propias para que cada organización adapte el “idioma visual” a su realidad.
El concepto clave es que todo el proyecto —o incluso varios proyectos— pueden describirse con archivos .c4 o .likec4 que luego se consolidan en un único modelo. A partir de ahí se crean “vistas”: diagramas que no duplican información, sino que filtran y representan partes del mismo modelo (por ejemplo, una vista de contexto, otra de contenedores, otra centrada en un dominio, otra de dependencias con terceros, etc.). Si el modelo cambia, las vistas cambian con él.
De la terminal a un entorno visual en segundos
El salto de “texto” a “diagrama” es parte del atractivo. LikeC4 incluye una CLI pensada para previsualizar el resultado y trabajar en modo iterativo, lo que lo acerca a la experiencia de desarrollo: editar, guardar, ver cambios. El proyecto también cuenta con integración en editores (como extensión) que aporta validación, autocompletado, navegación, vista previa y ayudas típicas de un entorno moderno: “ir a definición”, “buscar referencias” o renombrados seguros.
La propuesta encaja especialmente bien en equipos donde la arquitectura cambia rápido: microservicios, plataformas con crecimiento continuo, organizaciones que hacen reestructuraciones por dominios o empresas que deben mantener trazabilidad por requisitos internos o regulatorios. No se trata solo de “dibujar bonito”, sino de reducir fricción en conversaciones críticas: onboarding, revisiones de seguridad, auditorías internas, negociación de dependencias entre equipos o explicación del sistema a negocio.
Documentación “embebida” y automatizable
Otra línea que impulsa LikeC4 es la integración con documentación y producto. En lugar de exportar un PNG y pegarlo en una wiki, el enfoque actual apuesta por diagramas interactivos en documentación web. El ecosistema del proyecto incluye herramientas para incrustar vistas en sitios y aplicaciones (por ejemplo, mediante componentes web o integración con flujos de build), y también opciones orientadas a CI/CD: generar o actualizar diagramas de forma automática para que cualquier cambio en el repositorio se refleje en la documentación sin depender de tareas manuales.
Este tipo de automatización se ha convertido en argumento de peso en compañías que han sufrido “documentación fantasma”: equipos que se reorganizan, repositorios que se bifurcan, servicios que se deprecian y diagramas que sobreviven como fósiles. El objetivo, en la práctica, es que el diagrama deje de ser un artefacto artesanal y pase a ser un producto derivado del propio desarrollo.
Arquitectura lista para la era de los agentes de IA
LikeC4 también se asoma a un terreno que está ganando protagonismo: conectar modelos de arquitectura con asistentes y agentes basados en modelos de lenguaje. El proyecto ofrece un MCP Server (Model Context Protocol) para exponer el conocimiento del modelo a herramientas que puedan consultarlo en lenguaje natural. Esto abre un escenario llamativo: preguntar a un asistente “qué sistemas llaman a esta API”, “qué componentes están marcados como legacy”, “qué depende de tal servicio” o “qué relaciones entrantes tiene un backend”, y obtener respuestas basadas en el modelo real, no en suposiciones.
La idea es relevante por un motivo práctico: cuando una organización crece, el conocimiento arquitectónico se fragmenta. Si el modelo está cuidado y versionado, se convierte en una base de conocimiento útil tanto para humanos como para herramientas automatizadas que ayudan a revisar cambios, detectar dependencias o preparar documentación técnica.
Un editor de arquitectura, pero con mentalidad de ingeniería
Lo que diferencia a LikeC4 frente a enfoques más tradicionales no es solo el formato, sino el cambio de disciplina: el modelo se revisa como código, se integra en el repositorio, puede someterse a controles de calidad y, potencialmente, a tests internos. En ese sentido, LikeC4 se acerca a una mentalidad de “arquitectura verificable”: no basta con que el diagrama sea elegante; debe ser consistente, trazable y mantenible.
El proyecto se distribuye como software open source con licencia MIT y evoluciona como un conjunto de herramientas (lenguaje, CLI, extensión de editor y utilidades de integración). A finales de ২০২٥, el repositorio ronda ya cifras cercanas al millar de estrellas en GitHub, señal de que el concepto —arquitectura viva, generada desde un modelo— está encontrando público en un mercado que busca reducir deuda documental.
Preguntas frecuentes
¿Para qué sirve LikeC4 en un equipo de desarrollo que ya usa diagramas en Confluence o PowerPoint?
Para evitar que los diagramas se queden obsoletos: el modelo se mantiene junto al código y los diagramas se generan desde una fuente única y versionada.
¿Qué ventaja tiene “arquitectura como código” frente a herramientas de diagramación manual?
Permite revisar cambios en arquitectura como si fueran cambios de software (historial, control de versiones, revisiones en PR) y facilita automatizar la publicación de diagramas actualizados.
¿LikeC4 es una alternativa open source al enfoque C4/Structurizr?
Está inspirado en C4 y en lenguajes tipo Structurizr DSL, pero añade flexibilidad para personalizar notación, tipos de elementos y niveles, adaptándolo a distintos equipos y organizaciones.
¿Cómo ayuda LikeC4 a documentar sistemas complejos con microservicios y dependencias externas?
Al centralizar el modelo y generar vistas filtradas: se pueden crear diagramas por dominio, por equipo, por dependencias críticas o por contexto sin duplicar información ni mantener esquemas separados.
