Maturity Score: La Salud de tu Arquitectura en una Sola Calificacion
Tienes un drift score. Tienes reglas de conformidad. Tienes insights. Tienes metricas DORA. Cuatro senales, cuatro dashboards, cuatro numeros que verificar antes de poder responder la pregunta mas simple: esta nuestra arquitectura en buen estado?
La respuesta siempre estaba dispersa. Un equipo podia tener una precision de documentacion perfecta (drift score 95) pero practicas de despliegue terribles (DORA por el suelo). Otro podia desplegar diez veces al dia pero ignorar cada regla de conformidad del libro. Cada metrica contaba una parte de la historia. Ninguna contaba la historia completa.
El Maturity Score soluciona esto. Una calificacion. Cuatro dimensiones. Una unica vista de lo saludable que realmente esta tu arquitectura.
De la A a la F. Eso es todo.
Abre cualquier proyecto en Archyl y veras una calificacion con letra:
- A (90-100) — Tu arquitectura esta bien documentada, es conforme, se monitorea activamente y se despliega de forma fiable. Este es el objetivo.
- B (80-89) — Solido. Pequenas brechas en una o dos dimensiones pero nada que te quite el sueno.
- C (70-79) — Base decente, debilidades reales. Sabes donde estan los problemas pero no los has solucionado.
- D (60-69) — Con dificultades. Multiples dimensiones estan rindiendo por debajo de lo esperado. La deuda tecnica se esta acumulando.
- F (por debajo de 60) — Tu documentacion de arquitectura es decorativa. Empieza por lo basico.
La calificacion no es una metrica de vanidad. Se calcula a partir de cuatro dimensiones ponderadas, cada una midiendo algo diferente sobre tu practica de arquitectura.
Cuatro Dimensiones, Una Calificacion
Drift — Tu documentacion dice la verdad?
La dimension de drift mide con que precision tu modelo C4 refleja tu codigo real. Rutas de archivos que ya no existen. Servicios que fueron renombrados. Contenedores que fueron fusionados. Cada elemento documentado se valida contra el repositorio.
Un drift score alto significa que tus diagramas de arquitectura describen el sistema que realmente se ejecuta en produccion. Uno bajo significa que describen un sistema que existia hace seis meses.
Insights — Estas escuchando las senales?
Archyl analiza continuamente tu arquitectura y detecta problemas: dependencias circulares, componentes sobredimensionados, documentacion faltante, contenedores sin uso. La dimension de insights mide cuantos de estos problemas existen y que tan severos son.
Un equipo que resuelve rapidamente los insights criticos obtiene una puntuacion alta. Un equipo que deja que las advertencias se acumulen obtiene una puntuacion baja. No se trata de tener cero problemas — se trata de tener una cultura de actuar sobre ellos.
Conformance — Sigues tus propias reglas?
Definiste reglas de arquitectura por una razon. Ningun contenedor de frontend deberia llamar a la base de datos directamente. Cada sistema debe tener al menos un contrato de API documentado. Los servicios de autenticacion no deben depender de la logica de negocio.
La dimension de conformidad mide que porcentaje de tus reglas se cumplen. Es la diferencia entre tener gobernanza y hacerla cumplir.
DORA — Realmente puedes desplegar?
La calidad de la arquitectura no significa nada si no puedes entregar. La dimension DORA rastrea las cuatro metricas estandar: frecuencia de despliegue, tiempo de entrega para cambios, tasa de fallos en cambios y tiempo medio de recuperacion.
Un equipo con una arquitectura hermosa que despliega una vez por trimestre tiene un problema de entrega. DORA lo detecta.
Ponderado, No Promediado
Las cuatro dimensiones no tienen el mismo peso. El maturity score de cada proyecto es un compuesto ponderado:
| Dimension | Peso por Defecto | Que recompensa |
|---|---|---|
| Drift | 25% | Mantener la documentacion precisa |
| Insights | 25% | Resolver problemas de arquitectura |
| Conformance | 25% | Seguir tus propias reglas |
| DORA | 25% | Desplegar de forma fiable |
Los pesos son visibles en el panel de detalle — cada puntuacion muestra su contribucion. Puedes ver exactamente por que tu calificacion es la que es y que dimension la esta arrastrando hacia abajo.
Vista a Nivel de Organizacion
Las puntuaciones individuales de proyectos son utiles. Ver todos tus proyectos lado a lado es transformador.
El dashboard de Madurez de la Organizacion muestra cada proyecto como una tarjeta: calificacion, puntuacion, tendencia y un desglose de las cuatro dimensiones. Filtra por calificacion. Ordena por puntuacion. Busca por nombre. En treinta segundos, sabes que proyectos necesitan atencion.
La barra de distribucion de calificaciones en la parte superior te da la forma de la salud arquitectonica de tu organizacion. Mayormente A y B? Estas en buena forma. Un grupo de D y F? Sabes donde invertir.
Las Tendencias Cuentan la Verdadera Historia
Cada calculo de madurez se rastrea a lo largo del tiempo. Cada proyecto muestra una tendencia: mejorando, estable o en declive.
Un proyecto que paso de C a B el mes pasado va por buen camino aunque todavia no sea una A. Un proyecto que ha estado en declive durante tres sprints necesita intervencion aunque siga siendo una B. La tendencia suele ser mas accionable que la puntuacion absoluta.
El Motor de Recomendaciones
El panel de detalle no solo te muestra puntuaciones — te dice que hacer. La dimension mas debil recibe una recomendacion especifica y accionable:
- Drift es la mas baja? "Ejecuta una deteccion de drift para actualizar la alineacion de tu documentacion."
- Insights es la mas baja? "Revisa y resuelve los insights criticos de arquitectura."
- Conformance es la mas baja? "Corrige las violaciones de reglas de conformidad para mejorar el cumplimiento."
- DORA es la mas baja? "Mejora las practicas de despliegue para impulsar las metricas DORA."
Sin ambiguedad. Sin "considera mejorar tus procesos." Un siguiente paso concreto vinculado a lo que mas movera tu puntuacion.
Por Que Importa una Sola Calificacion
Los equipos no actuan ante dashboards con doce metricas. Actuan ante un solo numero que es facil de entender, facil de comparar y dificil de manipular.
El Maturity Score es deliberadamente dogmatico:
Es holistico. No puedes obtener una A siendo excelente en documentacion pero terrible en despliegue. Las cuatro dimensiones importan.
Es comparable. El Proyecto A tiene una B. El Proyecto B tiene una D. La conversacion sobre donde invertir tiempo de ingenieria se volvio mas simple.
Es rastreable. Un numero que puedes graficar a lo largo del tiempo es un numero que puedes mejorar. Establece un objetivo: "Todos los proyectos en C o superior para fin de trimestre." Ahora tienes una meta medible.
Es honesto. La calificacion no se preocupa por intenciones ni hojas de ruta. Mide lo que es verdad ahora mismo. Tu documentacion coincide con el codigo o no. Tus reglas se cumplen o no.
Primeros Pasos
El Maturity Score esta disponible hoy para todos los proyectos de Archyl. No se requiere configuracion — si tienes un proyecto con documentacion de arquitectura, ya tienes una puntuacion.
- Abre cualquier proyecto. La insignia de madurez aparece en el encabezado del proyecto.
- Haz clic en ella para ver el desglose completo: puntuacion general, cuatro dimensiones, tendencia y recomendacion.
- Visita la pagina de Madurez de la Organizacion para ver todos los proyectos a la vez.
La salud arquitectonica de tu organizacion no deberia ser un misterio. Ahora es una calificacion con letra.