Como você mede e melhora a saúde técnica de um time e codebase?

Question

Accepted Answer

**Saúde técnica** é como um time consegue entregar de forma sustentável, qualidade de código, confiabilidade do sistema e velocidade de entrega em conjunto. Você não pode melhorar o que não mede, mas o objetivo é *gerar insights para impulsionar melhorias*, nunca atingir um número. Métricas são uma lanterna, não um placar.

## O que medir

```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)
```

## Use DORA, de forma balanceada

Os quatro métricas DORA são valiosas porque *equilibram* velocidade e estabilidade; você não consegue otimizar uma sem prejudicar a outra. Alta frequência de deploy com uma taxa de falha alta é uma bandeira vermelha, não uma vitória. Acompanhe o conjunto, não um número isolado.

## Um exemplo concreto

Lead time para mudanças está aumentando. Você investiga e descobre que PRs ficam em revisão por dias. A métrica apontou um gargalo real, um problema no processo de revisão, que você nunca teria percebido por intuição. Você corrige o processo e a métrica melhora como um *efeito colateral*.

## A grande armadilha: gaming

No momento em que uma métrica vira uma meta, as pessoas otimizam o número, não o resultado (Lei de Goodhart). Metas de cobertura geram testes inúteis; metas de velocidade geram estimativas inflacionadas. Use métricas para *encontrar* problemas, depois converse com as pessoas, nunca para classificar ou punir.

## Por que isso importa

Sem sinais, a saúde técnica se degrada invisível até o time ficar misteriosamente lento e ninguém conseguir dizer por quê.

Boa medição torna o invisível visível, para que você possa investir onde importa e prove o impacto quando fizer.