Cómo saber si el código de la IA es bueno, sin ser experto

Un asistente de programación con IA puede escribir una pantalla que funciona en minutos. Esa velocidad es real, y por eso cada vez más software se construye así. El detalle es que “funciona en mi pantalla” y “es buen código” no son lo mismo. El buen código sigue funcionando cuando alguien lo cambia, cuando crece el uso y cuando quien lo escribió ya no está.

No necesitas leer código para notar la diferencia. Ya sea que estés aprobando el proyecto o construyéndolo tú con una herramienta de IA, hay señales que puedes revisar desde afuera.

Seis señales que cualquiera puede revisar

1. Arranca desde cero, con pasos escritos. Pídele a alguien que nunca ha tocado el proyecto que lo instale en una computadora limpia usando solo las instrucciones escritas (normalmente un archivo llamado README). Si hace falta llamar al autor original, el conocimiento vive en una sola cabeza, no en el proyecto. Piensa en una receta: si solo el cocinero puede preparar el plato, no tienes receta.

2. Hay pruebas, y pasan. Una prueba es un pequeño chequeo automático de que el código sigue haciendo lo que debe, y corre cada vez que algo cambia. Pregunta cuántas hay, qué cubren, y pide verlas correr. “Probamos a mano” significa que cada cambio depende de que alguien se acuerde de revisar todo.

3. Los secretos están fuera del código. Las contraseñas y las llaves de API (las claves que permiten a tu software usar servicios pagados) van en un almacén de configuración aparte y protegido, nunca escritas dentro del código. Las herramientas de IA a veces pegan una llave directo en un archivo para que algo funcione. Pregunta: “¿Hay alguna contraseña o llave escrita en el código o en su historial?”. Si nadie sabe, haz que lo revisen. Una llave filtrada puede generar cobros o exponer tus datos.

4. Otra persona puede explicar cualquier parte. Elige cualquier pantalla o función y pregúntale a alguien del equipo cómo funciona. Si la respuesta es “eso lo escribió la IA, no estoy seguro”, nadie es dueño de esa parte. El código que nadie entiende es código que nadie puede arreglar con seguridad cuando falla a las 2 de la mañana.

5. Los cambios son pequeños y revisados. Los proyectos sanos avanzan en pasos cortos: cada cambio hace una cosa, y una segunda persona lo lee antes de publicarlo. Un cambio gigante que reescribe medio sistema es difícil de revisar y difícil de deshacer. Pide ver la lista de cambios recientes (el historial de versiones). Muchos cambios pequeños y bien descritos son buena señal.

6. Maneja los errores. Prueba los caminos incómodos. Envía un formulario vacío, una fecha imposible, un nombre larguísimo. Corta la conexión a mitad de camino. El buen software muestra un mensaje claro y protege tus datos. El software débil muestra una página en blanco o un muro de texto técnico. Las herramientas de IA suelen escribir bien el camino donde todo sale bien y olvidar el resto, así que ahí se esconden los problemas.

Preguntas para la propia IA

Si estás construyendo con una herramienta de IA, úsala como un segundo par de ojos. No va a detectar todo, pero estas instrucciones sacan mucho a la luz:

• “Haz una lista de cada lugar donde aparece una contraseña, llave o token en este proyecto.”
• “¿Qué pasa si este servicio externo está caído o lento? Muéstrame el código que lo maneja.”
• “¿Qué partes de este proyecto no tienen pruebas? Ordénalas por riesgo.”
• “Explícale este archivo a alguien que no programa. ¿Qué podría salir mal?”
• “¿Qué cambiarías antes de que lo usen clientes reales?”

Toma las respuestas como pistas para verificar, no como veredictos. La misma herramienta que escribió el código puede equivocarse sobre él con total seguridad.

Preguntas para un revisor

Un ingeniero con experiencia puede responder en uno o dos días lo que a ti te tomaría semanas aprender. Pregúntale:

• ¿Cuál es la parte más riesgosa de este código, y por qué?
• Si el desarrollador principal se fuera mañana, ¿alguien más podría tomar el control?
• ¿Qué se rompería primero si el uso creciera diez veces?
• ¿Hay algo aquí que ponga en riesgo los datos de los clientes?
• ¿Cuáles tres arreglos vale la pena hacer primero?

Un buen revisor te da una lista corta y ordenada, no una cátedra.

El código escrito con IA puede ser buen código

Nada de esto significa que el código escrito con IA sea malo. Significa que necesita la misma disciplina que cualquier otro código. En SuperEscuela, una plataforma de aprendizaje gratuita para niños, 74 de 97 cambios de código se escribieron junto a un asistente de programación con IA, y cada uno fue aceptado por un ingeniero antes de entrar. La IA aportó la velocidad; una persona siguió siendo responsable de cada cambio. Ese es el patrón que debes buscar.