Reglas de Análisis Personalizadas: Tu Arquitectura, Tus Estándares

Los análisis de arquitectura han sido una de las características más populares de Archyl desde el lanzamiento. Apunta el analizador a tu arquitectura y él identifica problemas potenciales: puntos únicos de fallo, dependencias circulares, elementos huérfanos, documentación faltante. Los equipos nos dicen que es como tener un arquitecto senior revisando su diseño de sistema continuamente.

Pero seguíamos escuchando el mismo feedback: "Esa advertencia no aplica para nosotros."

Tal vez tus microservicios comparten intencionalmente una base de datos durante una migración gradual. Quizás un componente tiene muchas dependencias entrantes porque es una biblioteca de utilidades compartida—no un problema de acoplamiento, solo buena reutilización de código. O tu equipo decidió que ocho conexiones a un servicio está bien, aunque nuestro umbral por defecto lo marca.

Las reglas genéricas no pueden tomar en cuenta tu contexto. Así que te estamos dando el control.

Siete Reglas, Tus Umbrales

Archyl ahora te permite personalizar las reglas de análisis que examinan tu arquitectura. Hemos identificado siete patrones que importan para la salud arquitectónica, y ahora puedes ajustar cada uno para coincidir con los estándares de tu equipo.

El detector de Punto Único de Fallo encuentra elementos de los que demasiados otros componentes dependen. Por defecto, marcamos cualquier cosa con tres o más dependencias entrantes, pero si tu arquitectura centraliza intencionalmente ciertas preocupaciones, puedes subir ese umbral a cinco, diez, o lo que tenga sentido. La infraestructura crítica como bases de datos siempre recibe escrutinio extra—hemos aprendido que una base de datos convirtiéndose en SPOF casi siempre vale la pena conocerla.

El análisis de alto acoplamiento mira en ambas direcciones: elementos que dependen de demasiadas cosas (saliente) y elementos de los que demasiadas cosas dependen (entrante). Los valores por defecto—seis salientes, cuatro entrantes—funcionan bien para la mayoría de las bases de código, pero un equipo de plataforma construyendo bibliotecas compartidas podría querer umbrales más altos que un equipo de producto construyendo características enfocadas.

Los elementos sobre-conectados atrapan un problema diferente: componentes que tienen tantas conexiones totales que son difíciles de razonar. Ocho conexiones podrían estar bien para tu API gateway pero ser preocupantes para un servicio de dominio. Ajusta el umbral para coincidir con tus patrones de arquitectura.

Las dependencias circulares son casi siempre problemáticas—hacen las pruebas más difíciles, crean dolores de cabeza de inicialización, y señalan límites poco claros. Esta regla es binaria: encendida o apagada. Si estás usando intencionalmente referencias circulares por alguna razón, apágala. La mayoría de los equipos la dejan habilitada.

Los elementos huérfanos encuentran componentes de arquitectura sin ninguna conexión. A veces eso es un descuido de documentación; a veces es un servicio obsoleto que olvidaste eliminar. La regla los marca para que puedas decidir.

Los patrones de seguridad detectan elecciones arquitectónicas preocupantes como sistemas externos con acceso directo a la base de datos. Estos son hallazgos de severidad crítica que la mayoría de los equipos quieren saber inmediatamente.

La documentación faltante ayuda a mantener la cobertura, pero en una base de código con miles de componentes, marcar cada elemento sin documentar crea ruido. Puedes establecer un umbral—solo verificar documentación si tienes menos de 20 componentes, o 50, o 500. Escala la regla al tamaño de tu arquitectura.

Consistencia a Nivel de Organización

Estas configuraciones aplican a toda tu organización, no por proyecto. Hicimos esta elección deliberadamente.

Los estándares de arquitectura deberían ser consistentes. Si tu equipo de plataforma decide que cuatro dependencias entrantes es el umbral para alto acoplamiento, ese estándar debería aplicar en todas partes. Los proyectos nuevos heredan automáticamente las reglas de la organización. Los equipos no pueden accidentalmente (o intencionalmente) establecer estándares más laxos que creen deuda técnica.

Las configuraciones viven en la configuración de tu organización. Cualquiera con permisos de edición puede ajustarlas, y los cambios toman efecto inmediatamente—Archyl re-analiza tu arquitectura con las nuevas reglas y actualiza el panel de análisis.

La Pestaña de Reglas

Hemos agregado una sección de Reglas dedicada a la página de Análisis. Cada regla aparece como una tarjeta con un interruptor y, donde aplique, entradas de umbral.

Para reglas basadas en umbral, verás el valor actual, el rango permitido, y el valor por defecto. Desliza el umbral hacia arriba para ser más permisivo, hacia abajo para ser más estricto. La interfaz valida tus entradas—no puedes establecer valores imposibles o crear configuraciones que no tengan sentido.

Para reglas binarias como la detección de dependencias circulares, es un simple interruptor on/off. La tarjeta explica qué detecta la regla para que puedas hacer una elección informada sobre si importa para tu base de código.

Cuando modificas configuraciones, aparece un botón de guardar en la parte inferior de la página. Haz clic, y Archyl inmediatamente vuelve a ejecutar el análisis con tu nueva configuración. En segundos, verás los análisis actualizados reflejando tus reglas personalizadas.

También hay un botón de reinicio que restaura todos los valores por defecto si quieres empezar de nuevo.

Qué Cambia en la Práctica

Con reglas personalizables, el panel de análisis se vuelve genuinamente útil en lugar de una fuente de fatiga de alertas.

Los equipos nos dicen que solían echar un vistazo a los análisis, ver una pared de advertencias que ya habían decidido ignorar, y cerrar la pestaña. Ahora configuran las reglas para coincidir con sus estándares reales, y cuando aparece un análisis, es algo que vale la pena investigar.

Los niveles de severidad ayudan a priorizar. Los puntos únicos de fallo en infraestructura crítica se muestran como Críticos. Las dependencias circulares son Altas. Los elementos sobre-conectados son Medios. La documentación faltante es Baja. Puedes enfocarte primero en los elementos rojos, sabiendo que tus umbrales están calibrados a tu contexto.

Y porque los análisis se actualizan automáticamente cuando las reglas cambian, puedes experimentar. ¿Curioso sobre cómo se ve tu arquitectura con reglas de acoplamiento más estrictas? Ajusta el umbral, guarda, y ve. ¿Demasiado ruidoso? Bájalo. El ciclo de feedback es inmediato.

Primeros Pasos

Las reglas de análisis personalizadas están disponibles en todos los planes. Navega a Análisis, haz clic en la pestaña Reglas, y empieza a ajustar.

Recomendamos empezar con los valores por defecto y ajustar basándote en lo que ves. Si una regla particular genera advertencias que consistentemente ignoras, eso es una señal para ya sea corregir la arquitectura subyacente o ajustar el umbral. Ambas son elecciones válidas—el objetivo es hacer los análisis accionables, no perseguir métricas arbitrarias.

Tu arquitectura tiene sus propias características, sus propios trade-offs intencionales, su propia definición de "suficientemente bueno". Ahora tu gobernanza puede reflejar eso.

¿Quieres ver cómo funcionan los análisis impulsados por IA? Lee sobre Descubrimiento Impulsado por IA para entender cómo Archyl analiza tu base de código y genera recomendaciones arquitectónicas.