El diagrama antes que el código: pídele a la IA el mapa, no la solución Claude

Pídele a la IA el diagrama de flujo de un ejercicio de programación ANTES de que tu alumnado escriba una sola línea de código, repártelo como enunciado, y cuando terminen, que sea la propia IA quien compare su programa con ese diagrama y señale dónde no coincide — sin corregirlo. La IA dibuja el mapa al principio y lo revisa al final; programar en medio lo hacen ellos solos. Aquí tienes el proceso completo, paso a paso.

El problema que resuelve

El orden correcto para aprender a programar es pensar primero el algoritmo y escribirlo en código después — algo que ya está en el currículo de Tecnología con los diagramas de flujo. El problema habitual es que dibujar el diagrama a mano lleva tiempo de clase, así que muchas veces se acaba proyectando ya hecho, sin que el alumnado vea cómo se construye. Pedírselo a la IA no salta el paso de pensar el algoritmo: lo pone en el centro, porque hay que describírselo bien para que lo dibuje bien.

Lo que necesitas antes de empezar

• Acceso a Claude con capacidad de generar diagramas (dentro de un Artifact, se dibujan solos).
• Un ejercicio de programación ya pensado, aunque sea a grandes rasgos — el nivel de complejidad del algoritmo es lo que ajusta esto a cada curso.

Paso 1 — Describe el ejercicio en palabras y pide el diagrama, no el código

Cuenta el ejercicio como se lo explicarías al alumnado en voz alta, y pide explícitamente que no incluya código todavía. Este es el prompt real:

“Quiero un diagrama de flujo, en formato Mermaid, para un ejercicio de programación que le voy a dar a mis alumnos. El ejercicio es este: un programa le pide números al usuario, uno detrás de otro, y los va sumando. Cuando el usuario escribe ‘fin’ en vez de un número, el programa deja de pedir y muestra en pantalla cuántos números ha metido en total y la suma de todos ellos. Quiero el diagrama con el inicio, la entrada de datos, la decisión de si ha escrito ‘fin’ o no, el bucle que vuelve a pedir, y el final donde se muestran los resultados. No quiero el código todavía, solo el diagrama.”

Paso 2 — Reparte el diagrama dibujado como enunciado

El resultado es un diagrama con un óvalo de inicio, rectángulos para cada paso, un rombo para la decisión y una flecha que vuelve hacia atrás formando el bucle. Ese dibujo —no el texto que hay detrás— es lo que se proyecta o se reparte en clase. El alumnado todavía no ha visto ni una línea de código.

Paso 3 — El alumnado programa solo, sin IA de por medio

Este paso no cambia nunca: escriben el programa siguiendo el diagrama, con sus propios medios. Es a propósito que la IA no participa aquí — es donde está el aprendizaje real.

Paso 4 — La IA compara el código con el diagrama, sin corregirlo

Cuando terminan, se le da a la IA el diagrama original junto al código, pidiéndole explícitamente que señale las diferencias sin arreglarlas:

“Aquí tienes el diagrama de flujo que me diste antes y aquí está el programa en Python que he escrito siguiéndolo. ¿Mi programa sigue exactamente los pasos del diagrama? Si hay algo que no coincide —un paso que falta, una condición al revés, un bucle que no para cuando debería— dime en qué parte del diagrama no coincide, pero no me des el código corregido: quiero arreglarlo yo.”

Esa última frase es la clave: sin ella, la IA tiende a devolver el código ya arreglado, y se pierde la parte de encontrar y corregir el propio error.

Un aviso sobre “Mermaid”

Mermaid es el lenguaje de texto que usa la IA para describir el diagrama. Si ese texto queda suelto (fuera de un Artifact), no se ve dibujado por sí solo — hace falta un sitio que lo “lea”, como un Artifact de Claude o un editor gratuito como mermaid.live.

Avisos

• Revisa siempre el diagrama antes de repartirlo: comprueba que dice exactamente lo que querías enseñar.
• Este ciclo se adapta subiendo o bajando la complejidad del algoritmo: sin bucle, para un nivel inicial; con bucles, funciones o varias decisiones encadenadas, para un nivel avanzado.
• Si la IA “casi” corrige el código sin querer al revisarlo, es buena ocasión para hablar de por qué conviene pedirle explícitamente que no lo haga.

Idea para llevarse a casa

El diagrama de flujo deja de ser un dibujo ya terminado y pasa a ser un plano de verdad: la IA lo dibuja al principio y comprueba al final si se ha seguido, pero nunca programa por en medio, que es donde está el aprendizaje.