¿Cómo mides y mejoras la salud técnica de un equipo y una base de código?

Question

Accepted Answer

**Salud técnica** es la sostenibilidad con la que un equipo puede entregar, la calidad del código, la confiabilidad del sistema y la velocidad de entrega en conjunto. No puedes mejorar lo que no mides, pero el objetivo es *obtener información para impulsar la mejora*, nunca un número a alcanzar. Las métricas son una linterna, no un marcador.

## Por qué es importante

```text
DELIVERY (DORA metrics — well-researched, balanced):
  - Deployment frequency        - Lead time for changes
  - Change failure rate         - Time to restore service

QUALITY / RELIABILITY:
  - Production incident rate & severity
  - Test coverage trend (direction, not a vanity %)
  - Escaped-bug rate

TEAM / FLOW:
  - Cycle time, time-in-review (slow review = hidden bottleneck)
  - Recurring pain points (survey the team — they know)
```

## Usa DORA, equilibrado

Las cuatro métricas de DORA son valiosas porque *equilibran* velocidad y estabilidad; no puedes optimizar una sin perjudicar la otra. Una alta frecuencia de despliegue con una alta tasa de fallos es una bandera roja, no una victoria. Rastreá el conjunto, no un único número.

## Un ejemplo concreto

El tiempo de entrega de cambios va en aumento. Investigás y descubrís que los PRs se quedan en revisión durante días. La métrica te señaló un cuello de botella real, un problema en el proceso de revisión, que nunca hubieras detectado por intuición. Arreglás el proceso, y la métrica mejora como *efecto secundario*.

## El gran problema: manipulación

En el momento en que una métrica se convierte en un objetivo, la gente optimiza el número, no el resultado (Ley de Goodhart). Los objetivos de cobertura generan pruebas sin valor; los objetivos de velocidad generan estimaciones infladas. Usá las métricas para *encontrar* problemas, luego hablá con la gente, nunca para clasificarlos o castigarlos.

## Por qué es importante

Sin señales, la salud técnica se degrada invisiblemente hasta que el equipo es misteriosamente lento y nadie puede decir por qué.

La buena medición hace visible lo invisible, para que puedas invertir donde importa, y demuestres el impacto cuando lo hagas.