Maturity Score: La Salud de tu Arquitectura en una Sola Calificación
Tienes un drift score. Tienes reglas de conformidad. Tienes insights. Tienes métricas DORA. Cuatro señales, cuatro dashboards, cuatro números que verificar antes de poder responder la pregunta más simple: ¿Está nuestra arquitectura en buen estado?
La respuesta siempre estaba dispersa. Un equipo podía tener una precisión de documentación perfecta (drift score 95) pero prácticas de despliegue terribles (DORA por el suelo). Otro podía desplegar diez veces al día pero ignorar cada regla de conformidad del libro. Cada métrica contaba una parte de la historia. Ninguna contaba la historia completa.
El Maturity Score soluciona esto. Una calificación. Cuatro dimensiones. Una única vista de lo saludable que realmente está tu arquitectura.
De la A a la F. Eso es todo.
Abre cualquier proyecto en Archyl y verás una calificación con letra:
- A (90-100) — Tu arquitectura está bien documentada, es conforme, se monitorea activamente y se despliega de forma fiable. Este es el objetivo.
- B (80-89) — Solido. Pequeñas brechas en una o dos dimensiones pero nada que te quite el sueno.
- C (70-79) — Base decente, debilidades reales. Sabes dónde están los problemas pero no los has solucionado.
- D (60-69) — Con dificultades. Múltiples dimensiones están rindiendo por debajo de lo esperado. La deuda técnica se está acumulando.
- F (por debajo de 60) — Tu documentación de arquitectura es decorativa. Empieza por lo básico.
La calificación no es una métrica de vanidad. Se calcula a partir de cuatro dimensiones ponderadas, cada una midiendo algo diferente sobre tu práctica de arquitectura.
Cuatro Dimensiones, Una Calificación
Drift — ¿Tu documentación dice la verdad?
La dimensión de drift mide con qué precisión tu modelo C4 refleja tu código 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 producción. Uno bajo significa que describen un sistema que existía hace seis meses.
Insights — ¿Estás escuchando las señales?
Archyl analiza continuamente tu arquitectura y detecta problemas: dependencias circulares, componentes sobredimensionados, documentación faltante, contenedores sin uso. La dimensión de insights mide cuántos de estos problemas existen y qué tan severos son.
Un equipo que resuelve rápidamente los insights críticos obtiene una puntuación alta. Un equipo que deja que las advertencias se acumulen obtiene una puntuación 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 razón. Ningún contenedor de frontend debería llamar a la base de datos directamente. Cada sistema debe tener al menos un contrato de API documentado. Los servicios de autenticación no deben depender de la lógica de negocio.
La dimensión de conformidad mide qué 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 dimensión DORA rastrea las cuatro métricas estándar: frecuencia de despliegue, tiempo de entrega para cambios, tasa de fallos en cambios y tiempo medio de recuperación.
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:
| Dimensión | Peso por Defecto | Qué recompensa |
|---|---|---|
| Drift | 40% | Mantener la documentación precisa |
| Insights | 30% | Resolver problemas de arquitectura |
| Conformance | 20% | Seguir tus propias reglas |
| DORA | 10% | Desplegar de forma fiable |
Si un proyecto no usa una de las cuatro (sin reglas de conformidad, sin seguimiento de releases), esa dimensión se puede desactivar en los ajustes del proyecto, y su peso se redistribuye proporcionalmente entre las demás, para que la puntuación no quede diluida por un valor de relleno.
Los pesos son visibles en el panel de detalle — cada puntuación muestra su contribución. Puedes ver exactamente por qué tu calificación es la que es y qué dimensión la está arrastrando hacia abajo.
Vista a Nivel de Organización
Las puntuaciones individuales de proyectos son útiles. Ver todos tus proyectos lado a lado es transformador.
El dashboard de Madurez de la Organización muestra cada proyecto como una tarjeta: calificación, puntuación, tendencia y un desglose de las cuatro dimensiones. Filtra por calificación. Ordena por puntuación. Busca por nombre. En treinta segundos, sabes qué proyectos necesitan atención.
La barra de distribución de calificaciones en la parte superior te da la forma de la salud arquitectónica de tu organización. ¿Mayormente A y B? Estás en buena forma. ¿Un grupo de D y F? Sabes dónde invertir.
Las Tendencias Cuentan la Verdadera Historia
Cada cálculo de madurez se rastrea a lo largo del tiempo. Cada proyecto muestra una tendencia: mejorando, estable o en declive.
Un proyecto que pasó de C a B el mes pasado va por buen camino aunque todavía no sea una A. Un proyecto que ha estado en declive durante tres sprints necesita intervención aunque siga siendo una B. La tendencia suele ser más accionable que la puntuación absoluta.
El Motor de Recomendaciones
El panel de detalle no solo te muestra puntuaciones — te dice qué hacer. La dimensión más débil recibe una recomendación específica y accionable:
- ¿Drift es la más baja? "Ejecuta una detección de drift para actualizar la alineación de tu documentación."
- ¿Insights es la más baja? "Revisa y resuelve los insights críticos de arquitectura."
- ¿Conformance es la más baja? "Corrige las violaciones de reglas de conformidad para mejorar el cumplimiento."
- ¿DORA es la más baja? "Mejora las prácticas de despliegue para impulsar las métricas DORA."
Sin ambigüedad. Sin "considera mejorar tus procesos." Un siguiente paso concreto vinculado a lo que más moverá tu puntuación.
Por Qué Importa una Sola Calificación
Los equipos no actúan ante dashboards con doce métricas. Actúan ante un solo número que es fácil de entender, fácil de comparar y difícil de manipular.
El Maturity Score es deliberadamente dogmático:
Cubre toda la práctica. Una documentación precisa por sí sola no te da una A: la deriva supone el 40 % de la puntuación, y el 60 % restante viene de los insights, la conformidad y la entrega.
Es comparable. El Proyecto A tiene una B. El Proyecto B tiene una D. La conversación sobre dónde invertir tiempo de ingeniería se volvió más simple.
Es rastreable. Un número que puedes graficar a lo largo del tiempo es un número 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 calificación no se preocupa por intenciones ni hojas de ruta. Mide lo que es verdad ahora mismo. Tu documentación coincide con el código o no. Tus reglas se cumplen o no.
Primeros Pasos
El Maturity Score está disponible hoy para todos los proyectos de Archyl. No se requiere configuración — si tienes un proyecto con documentación de arquitectura, ya tienes una puntuación.
- Abre cualquier proyecto. La insignia de madurez aparece en el encabezado del proyecto.
- Haz clic en ella para ver el desglose completo: puntuación general, cuatro dimensiones, tendencia y recomendación.
- Visita la página de Madurez de la Organización para ver todos los proyectos a la vez.
La salud arquitectónica de tu organización no debería ser un misterio. Ahora es una calificación con letra.