¿Cómo explicas la deuda técnica a una audiencia no técnica?

Question

Accepted Answer

**Traduzco la tech debt al lenguaje que la audiencia ya usa: dinero, velocidad y riesgo.** A un stakeholder no técnico no le importa el acoplamiento ni la cobertura de tests; le importa que las features sean cada vez más lentas y caras de entregar. Así que enmarco la deuda como un problema financiero y de entrega, no como un problema de código.

## El encuadre que uso

- **La metáfora financiera, usada con cuidado.** "Tomamos un atajo para entregar rápido, como pedir un préstamo. Funcionó, y ahora pagamos intereses cada sprint. Cada nueva feature en esta área cuesta más por esos intereses." Esto cala porque todos entienden la deuda y los intereses.
- **Hazlo concreto con sus métricas.** No "el código está desordenado" sino "esta feature tardó tres semanas; hace dos años algo del mismo tamaño tardaba una. La diferencia es el sobrecoste de mantenimiento que hemos acumulado."
- **Lígalo a resultados que les importan.** Entrega más lenta, más bugs llegando a los clientes, onboarding más difícil para los nuevos, riesgo creciente de una caída. Conecta la deuda con los ingresos, la reputación y la velocidad del roadmap.

## Cómo lo convierto en una decisión, no en una queja

- Preséntalo como un **trade-off con opciones**, no como una exigencia: "Podemos seguir entregando features al ritmo cada vez más lento actual, o invertir dos sprints ahora para reducir el coste futuro de las features en aproximadamente un tercio."
- Cuantifica donde pueda: tiempo perdido por sprint, frecuencia de incidentes, el porcentaje de capacidad gastado apagando fuegos.
- Sé honesto en que **algo de deuda está bien.** No toda la deuda debe pagarse; el punto es amortizar la deuda que está gravando activamente la entrega.

## Errores a evitar

- **Usar jerga** ("refactor", "acoplamiento", "la arquitectura está mal"). Hace que suenes como si quisieras sobrepulir el código.
- Enmarcarlo como ingenieros que quieren código limpio por sí mismo; eso se lee como autocomplaciente.
- Gritar que viene el lobo — llamar deuda a todo erosiona la credibilidad cuando surge algo de verdad urgente.

## Por qué es importante

Si no puedes explicar la tech debt en términos de negocio, nunca se financia, y el equipo se va frenando hasta detenerse mientras el liderazgo se pregunta por qué cae la velocidad. Enmarcarla como coste, velocidad y riesgo es lo que te consigue el tiempo para arreglarla antes de que se vuelva una crisis.