¿Cuánto te está costando realmente una mala documentación?

La mala documentación es uno de esos costes que se esconden a plena vista. Nadie tiene una partida presupuestaria para el "tiempo perdido porque las cosas no están escritas". Nadie hace un seguimiento de las "decisiones vueltas a debatir porque nadie documentó la discusión original". Nadie mide los "errores causados por ingenieros que no entendieron por qué se construyó el sistema de esta manera". Pero todos estos son costes reales, y cuando se suman incluso para un equipo de ingeniería modesto, el total es lo suficientemente grande como para que valga la pena abordarlo.

A continuación, te explicamos cómo calcular tu cifra.

Categoría 1: Interrupciones a ingenieros senior

Cada pregunta que un compañero responde verbalmente es tiempo que podría haberse dedicado al trabajo de ingeniería. El coste es la propia interrupción más el tiempo de recuperación: aproximadamente 25 minutos de pérdida de concentración por interrupción.

Tus datos:

• Número de ingenieros senior

• Interrupciones estimadas al día para preguntas que se pueden responder con la documentación (normalmente de 3 a 8)

• Coste medio de recuperación por interrupción: 25 minutos

• Tarifa horaria cargada del ingeniero senior

Ejemplo: 5 ingenieros senior × 5 interrupciones/día × 25 minutos × 95 $/hora × 250 días laborables = 248.000 $/año

La mayoría de los equipos subestiman el recuento de interrupciones porque cada interrupción individual parece trivial. Haz un seguimiento durante una semana y la cifra suele ser más alta de lo esperado.

Categoría 2: Retrasos en la incorporación (onboarding)

Cada semana que un nuevo empleado pasa adaptándose y que podría haberse acortado con una mejor documentación es una semana de salario pagado por un rendimiento reducido.

Tus datos:

• Número de ingenieros contratados al año

• Semanas estimadas de tiempo de adaptación con la documentación actual

• Semanas estimadas de tiempo de adaptación con una buena documentación (normalmente entre un 40 y un 60 % menos)

• Coste mensual cargado del nuevo empleado

Ejemplo: 8 contrataciones/año × 4 semanas de tiempo de adaptación evitable × 4.500 $/semana de coste cargado = 144.000 $/año

Categoría 3: Decisiones vueltas a debatir

Cuando las decisiones pasadas no se documentan, los equipos pierden tiempo de reunión debatiendo cuestiones que ya se habían resuelto. El coste es el tiempo de reunión multiplicado por el número de asistentes.

Tus datos:

• Horas estimadas al mes dedicadas a reuniones para volver a debatir decisiones pasadas

• Número medio de asistentes a esas reuniones

• Tarifa horaria cargada media

Ejemplo: 4 horas/mes × 5 asistentes × 85 $/hora × 12 meses = 20.400 $/año

Esto parece poco, pero el coste indirecto es mayor: las decisiones vueltas a debatir retrasan el trabajo que depende de ellas, y el retraso se propaga en cascada por todo el sprint.

Categoría 4: Pérdida de conocimiento por salidas de personal

Cuando un ingeniero clave se marcha y sus conocimientos no están documentados, el equipo sufre un golpe en la productividad mientras reconstruye el contexto que se marchó con él.

Tus datos:

• Número de salidas clave al año

• Semanas estimadas de productividad reducida del equipo por salida

• Coste semanal del equipo durante la productividad reducida

Ejemplo: 2 salidas/año × 6 semanas de velocidad reducida × 15.000 $/semana de coste de equipo × 30 % de reducción de productividad = 54.000 $/año

Categoría 5: Errores por falta de contexto

Errores y fallos causados por ingenieros que no entendieron por qué un sistema se construyó de la manera en que se hizo. Estos son los más difíciles de cuantificar pero a menudo los más costosos, porque un malentendido conceptual puede producir errores difíciles de diagnosticar y costosos de solucionar.

Tus datos:

• Incidentes estimados al año atribuibles a la falta de documentación o contexto

• Coste medio por incidente (tiempo de ingeniería para diagnosticar, solucionar y revisar)

Ejemplo: 6 incidentes/año × 5.000 $ de coste medio = 30.000 $/año

Categoría 6: Herramientas de IA que operan sin contexto

Tus herramientas de programación con IA, agentes internos y automatizaciones rinden a una fracción de su potencial porque el contexto de ingeniería que necesitan no está documentado ni se puede buscar. Esta es la categoría más difícil de cuantificar porque se trata de un coste de oportunidad más que de un coste directo: el valor que tus herramientas de IA podrían aportar si tuvieran el contexto adecuado frente al valor que aportan sin él.

Impacto estimado: Si tus herramientas de IA son entre un 30 y un 50 % más efectivas con una documentación completa, y tu equipo pasa de 2 a 3 horas al día interactuando con herramientas de IA, la productividad recuperada gracias a un contexto mejor documentado es significativa incluso con estimaciones conservadoras.

Sumándolo todo

Para un equipo de ingeniería de 20 personas con un ritmo de contratación moderado y una calidad de documentación típica:

Esto es antes de contar el coste de oportunidad de la IA. Para un equipo de 20 personas, el coste total documentado de una mala documentación es de aproximadamente medio millón de dólares al año, lo que equivale a entre dos y tres puestos de ingeniería a tiempo completo dedicados a problemas que una documentación completa eliminaría en gran medida.

La comparación

La documentación que se redacta sola, generándose y manteniéndose actualizada a partir de la actividad en GitHub, las conversaciones de Slack y las reuniones de tu equipo, cuesta una fracción de un solo salario de ingeniería. Si aborda tan solo el 50 % de los costes anteriores, el retorno de la inversión es de diez a veinte veces el coste de la herramienta.

La pregunta para la mayoría de los líderes de ingeniería no es si la mala documentación es costosa. Es que nadie ha sumado los costes antes, porque cada categoría está distribuida en docenas de pequeñas ineficiencias que individualmente parecen insignificantes.

No son insignificantes. Simplemente son invisibles hasta que alguien las calcula.

Preguntas frecuentes

¿Son realistas estas cifras para equipos más pequeños? Escálalas proporcionalmente. Un equipo de diez personas con menos contrataciones y menos interrupciones tendrá un total más bajo, pero el coste por ingeniero es similar. La mayoría de los equipos de diez o más personas están perdiendo más de 100.000 $ al año debido a problemas de documentación. El coste crece de forma no lineal con el tamaño del equipo porque el cuello de botella del conocimiento tácito empeora a medida que el equipo crece.

¿Qué pasa si ya tenemos algo de documentación? Ajusta las estimaciones para las áreas donde tus documentos sean sólidos. Si tus documentos de incorporación son buenos pero te falta documentación sobre las decisiones, el coste de la incorporación será menor pero el coste de volver a debatir decisiones será mayor. La mayoría de los equipos tienen focos de buena documentación rodeados de lagunas significativas.

¿Cómo convencemos a la dirección para que invierta en documentación? Calcula tu cifra específica utilizando las categorías anteriores con los datos reales de tu equipo. Preséntala junto con el coste de la solución. El cálculo del ROI suele ser lo suficientemente convincente por sí solo, porque el coste del problema es grande y el coste de la solución es comparativamente pequeño.

Lecturas relacionadas: El coste de redactar documentos de ingeniería, El coste real de la incorporación en ingeniería, El factor autobús, Los buenos documentos son un multiplicador de 10x. Páginas relacionadas: Documentos autogenerados, Para equipos de ingeniería, Retención del conocimiento.