Deuda de comprensión: el código que nadie explica
Ricardo Argüello, 2 de noviembre de 2026
CEO & Fundador
Resumen general
Ali Hamie, ingeniero de Meta, escribió en LinkedIn que ya no entiende cada detalle del código que entrega. La deuda de comprensión es la distancia entre el código que tiene un equipo y el que alguien puede explicar, y ningún tablero la muestra.
- Hamie no dijo que su código fuera malo. Dijo que revisar cada línea lo volvería el cuello de botella, y que entiende sus sistemas a nivel general pero no en cada detalle.
- Según la encuesta de Sonar a más de 1.100 desarrolladores, 42% del código commiteado ya es de IA o asistido por IA, 96% no confía del todo en que sea correcto y solo 48% lo revisa siempre antes del commit.
- En el estudio de Anthropic con 52 ingenieros, en su mayoría junior, el grupo con IA sacó 50% en un cuestionario contra 67% del grupo sin IA, con la mayor brecha en depuración.
- Los que usaron la IA para hacer preguntas y pedir explicaciones retuvieron más. El estudio midió el aprendizaje de una librería nueva, no código de producción.
- Una medida práctica es pedirle a quien aprobó un cambio hecho por IA que lo explique sin abrir la herramienta, y contar cuántos pueden.
Imagina que una constructora termina un edificio y las instalaciones eléctricas pasan la inspección el día de la entrega. Años después alguien tiene que abrir una pared para encontrar una falla, y descubre que nadie conserva el plano de por dónde pasan los cables. El edificio funciona, pero cada reparación se vuelve una exploración. Eso es una deuda de comprensión en tu código.
Resumen generado con IA
Ali Hamie trabaja como ingeniero en Meta. El 17 de octubre escribió en LinkedIn que nunca se había sentido tan incómodo haciendo su trabajo. Hoy escribe código y todo le parece una caja negra. Textual: “I’m used to understanding what I’m building” (estoy acostumbrado a entender lo que construyo).
No dijo que el código fuera malo. Dijo que a esta velocidad, revisar cada línea lo volvería el cuello de botella, y que entiende sus sistemas a nivel general pero ya no en cada detalle.
Eso tiene nombre. Addy Osmani lo llama deuda de comprensión: la distancia entre cuánto código existe en un sistema y cuánto de ese código alguien entiende. Un tablero no la muestra. Los tests pasan, la velocidad se ve excelente, y la cuenta llega en una caída de producción, cuando alguien tiene que depurar algo que nadie conoce.
Una aclaración que le debo al lector: Osmani trabaja en Anthropic, en Claude Code, la herramienta que uso, y Anthropic es quien publicó el estudio que cito más abajo.
Si diriges un equipo de ingeniería, esta es la deuda que no estás midiendo.
Cuánto código entra sin que nadie lo lea entero
Leí las fuentes primarias. La encuesta de Sonar a más de 1.100 desarrolladores, publicada en enero, dice que el 42% del código commiteado ya es de IA o asistido por IA, y los encuestados esperan 65% para 2027. El 96% dice que no confía del todo en que ese código sea correcto. Solo el 48% afirma revisarlo siempre antes del commit.
Sonar lo conecta con lo que Werner Vogels, CTO de AWS, llamó “verification debt” (deuda de verificación). Es una deuda vecina, pero distinta. La de verificación pregunta si alguien revisó el código. La de comprensión pregunta si alguien puede contarte cómo funciona. Se puede revisar una línea y no entenderla.
Sobre Meta, People Matters resumió un reporte de Business Insider de marzo (no leí el original): la organización que cubre Facebook, WhatsApp y Messenger fijó como meta que el 65% de sus ingenieros escriba más del 75% de su código con IA en el primer semestre de 2026. Hamie no mencionó ningún equipo ni meta. Eso es contexto, no su queja.
Lo que sí mide el estudio de Anthropic, y lo que no
La cifra que más circula viene de un experimento de Anthropic. Reclutaron a 52 ingenieros, en su mayoría junior, con más de un año de Python, y les pidieron programar con una librería que ninguno conocía, Trio. Después, un cuestionario. El grupo con asistente de IA promedió 50%. El grupo que programó a mano, 67%. La mayor brecha estuvo en las preguntas de depuración. Terminar la tarea fue apenas dos minutos más rápido con IA, y esa diferencia no fue estadísticamente significativa.
El estudio midió cuánto aprendió una persona de una herramienta nueva, no cuánto entiende de un sistema de producción que lleva años manteniendo. Tampoco se puede estirar a ingenieros senior. Es evidencia temprana y apunta en una dirección. No es una medición de tu equipo.
Lo que sí es útil: el patrón de uso importó. Quienes pidieron explicaciones o hicieron preguntas conceptuales mientras programaban retuvieron más. Los patrones de dependencia fuerte de la IA, ya fuera para generar código o para depurar, promediaron menos del 40%.
Qué haría con esto
Llevo 36 años programando, desde 1990, y uso Claude Code todos los días. Lo que sigue es opinión mía, no una medición.
El diff es el momento más barato para entender un cambio. Después, entenderlo cuesta un incidente. Por eso no apostaría a revisar más líneas, algo que menos de la mitad dice hacer siempre. Apostaría a decidir qué código necesita que alguien lo entienda y quién es esa persona.
Cuatro cosas que cualquier CTO puede hacer esta semana.
Primero, un nombre por cambio. Cada cambio hecho por IA tiene una persona que responde por él y que debe poder explicarlo si se lo piden. State of AI cuenta que algunos equipos ya hacen esto.
Segundo, revisión según el riesgo. Un script interno puede salir con tests y una mirada rápida. Un servicio de pagos necesita un revisor que explique cada rama.
Tercero, que el modelo explique antes del merge. Pídele que explique qué escribió y qué descartó. Toma más tiempo que aceptar el diff, y es justo el uso que el estudio de Anthropic asocia con retener la comprensión.
Cuarto, la prueba de explicar. Una vez al mes, elige un módulo que la IA tocó. Pídele a quien lo aprobó que lo explique en voz alta sin abrir la herramienta. Cuenta cuántos pueden. Ese número es lo más cercano que conozco a un indicador de deuda de comprensión. State of AI tampoco vio que alguna empresa publique una medida así.
Hay un contraargumento serio. Nadie en Meta lee el compilador ni cada dependencia, y el software siempre ha confiado en capas ajenas. State of AI responde algo que me parece correcto: el código de un agente cae en tu repositorio, a tu nombre, hecho para tu sistema. Eres su autor de registro te guste o no. Un compilador se comporta igual todas las veces. Esto no.
Sobre el código base, escribí por qué el código no es barato. Sobre qué pasa con la revisión cuando sube el volumen, está code review para humanos con 41% de código de IA.
Si quieres saber cuánto de tu código puede explicar tu equipo, escríbeme y hacemos la prueba de explicar sobre un módulo tuyo. Tú eliges el módulo.
Preguntas Frecuentes
La deuda de comprensión es la distancia entre cuánto código tiene un equipo y cuánto de ese código alguien entiende. Addy Osmani le puso el nombre. A diferencia de la deuda técnica, no se nota en builds lentos: los tests pasan y el tablero se ve bien hasta que hay una caída.
No hay una métrica estándar. Una forma práctica es elegir un módulo que la IA cambió el mes pasado y pedirle a quien aprobó el cambio que lo explique sin abrir la herramienta. Cuenta cuántos pueden. Ese conteo es tu medida de deuda de comprensión.
Anthropic comparó a 52 ingenieros, en su mayoría junior, aprendiendo una librería nueva de Python. El grupo con asistente de IA sacó 50% en el cuestionario y el grupo sin IA, 67%. La mayor brecha fue en depuración. Quienes hicieron preguntas a la IA retuvieron más que quienes le delegaron el código.
Asigna a cada cambio hecho por IA una persona que deba poder explicarlo, ajusta el rigor de la revisión al riesgo del código y pídele al modelo que explique qué escribió y qué descartó. Un script interno y un servicio de pagos no necesitan la misma revisión.
Artículos Relacionados
Code Review de Claude ya es público: quién firma el merge
Anthropic abrió Code Review a Team y Enterprise. El servicio no aprueba ni bloquea nada. Tú decides: quién firma, cuánto gastas y qué frena un merge.
El cuello de botella de la IA ya no es escribir código
Business Insider llama parálisis al costo oculto del AI coding. La IA genera código más rápido de lo que un equipo alcanza a revisar y mantener.
Code review para humanos, pero 41% del código es IA
El 41% del código en 2025 fue generado o asistido por IA, con 1.7x más defectos. Tu proceso de revisión asume que el autor entiende lo que escribió. Ya no.
Lo que tu IA no pregunta (y tu startup va a pagar)
Un founder perdió $87,500 porque su IA generó código funcional sin cuestionar la seguridad. Las herramientas de IA responden lo que pides, no lo que falta.
Muse Spark Open: ¿qué le pagas a un proveedor cerrado?
Meta liberó los pesos de Muse Spark Open. Si un modelo abierto hace el grueso de tu trabajo, el proveedor cerrado cobra por la cola difícil. Cómo medirla.
Estados Unidos necesita 500 mil electricistas para IA
Meta dice que EE.UU. necesita 500 mil electricistas en dos años para sostener la IA. Ford, Google, BlackRock y Carhartt ya pusieron 450 millones.