Programar con IA · 8 min

Deuda cognitiva al programar con IA

Al terminar sabrás explicar qué es la deuda cognitiva y en qué se distingue de la técnica, reconocer sus tres síntomas en tu trabajo con agentes y aplicar hábitos concretos para no contraerla.

Las ideas marcadas WR vienen de material de Web Reactiva; el resto, de las fuentes del final o de mi propia síntesis (lo indico).

? tuberías: funcionan planos: no existen casa heredada
? código: funciona tu modelo mental: vacío repositorio

Dónde falla la analogía: una casa no te explica sus tuberías; un agente sí, si se lo pides. Ahí empieza la salida.

La idea

Qué es la deuda cognitiva

La distancia entre lo que hace un sistema generado con IA y lo que tú entiendes de él. WR

La técnica se ve en el código. La cognitiva, no.
Deuda técnica TODO copia está en el código Deuda cognitiva ? está en quien lo mantiene
Un repo limpio puede ser ilegible para quien lo mantiene.

Dos deudas

Frente a la deuda técnica

Sesión 1. Lo escribes casi todo tú: lo aceptado y lo entendido coinciden.
Sesión 2. Los tests pasan y aceptas un diff largo. Entiendes la mitad.
Sesión 3. Varios agentes en paralelo: entra más código del que tu atención puede seguir. WR
Sesión 4. Lo entendido no crece. Lo ámbar es deuda cognitiva: está en el repo y no en tu cabeza.

El mecanismo

Cómo se acumula

Nadie decide endeudarse: cada «tests en verde, acepto» suma un poco. Web Reactiva lo llama sesgo de automatización: confiar en que lo que produce el modelo está bien. WR

No sabes depurar lo que «escribiste».
✗ TypeErroragenteescribiótú?
El fallo aparece en código que firmaste y no lees con fluidez. WR
Dependes del agente hasta para un cambio pequeño.
una sola líneaagentecambia 1 líneatú
Una línea por cambiar y el ciclo pasa por el agente.
Revisas sin leer.
diff largoagentesin abrirtúLGTM
El diff es largo, los checks están verdes, y apruebas.
Casi la mitad ya lo nota.
45 %dice que depurar código de IA lleva más tiempo de lo esperado
Stack Overflow Developer Survey 2025, citado por Web Reactiva (WR); no verificado en el original.

Cómo se nota

Qué síntomas da

Estos tres síntomas son el planteamiento de la lección, no una lista de Web Reactiva. Sí encaja con su pregunta de control: «¿puedo explicar lo que hace este código a otra persona?». WR

Automatiza la verificación. La decisión sigue siendo tuya.
Se automatiza tests lint build Decides tú definir la tarea aprobar según riesgo el agente trabaja entre ambos carriles
Tests, lint y build corren solos; la tarea y la aprobación, no. WR

La salida

Cómo se paga o se evita

Para cerrar

Dilo con tus palabras

Fuentes

Marcadas WR las de Web Reactiva, que consulté primero. Todo lo recuperado es material de terceros tratado como datos.