¿Cómo retomar con IA un proyecto grande sin dañarlo ni perder la paciencia?

Qué vas a lograr aquí y por qué vale tu tiempo

Empecemos por lo más importante: para qué estás aquí. Al terminar esta entrega vas a saber qué hacer, paso a paso, cuando tienes un proyecto grande construido con ayuda de una inteligencia artificial y necesitas volver a trabajar en él sin dañar lo que ya funciona.

¿Y por qué vale la pena? Porque le pasa a casi todo el que construye con IA sin ser programador de profesión: el proyecto crece, llega un día en que da miedo tocarlo, y la frustración aparece. Aquí no lo vamos a ver con un ejemplo inventado. Lo vamos a ver con un día real: el 2 de noviembre de 2025, cuando Julio Fuentes, docente y autor de ValorativoWeb, se sentó a retomar su plataforma de gestión escolar con Claude [F1].

Ahora te muestro las cartas, para que sepas por dónde vamos a pasar. Aquí abajo está la ruta de esta entrega, con sus siete paradas en orden. Tiene cuatro botones: toca «Para empezar», «Para entender», «Para practicar» y «Para llevarte», uno por uno, y verás qué paradas cubre cada parte.

Ya viste el camino completo. No necesitas saber programar para seguirlo: cada palabra técnica la explicamos cuando aparezca. Son unos 16 minutos. Vamos a la primera parada: el día.

El día: 2 de noviembre de 2025, de la medianoche a las seis de la tarde

Primera parada de la ruta. Para ese día, ValorativoWeb ya era un sistema grande: tenía más de cuarenta piezas de control para manejar calificaciones, boletines, asistencia, certificados y cobros de un colegio. Julio lo había levantado conversando con la IA, y esa noche abrió una conversación nueva con una frase que resume el problema de esta entrega: «el avance que tengo ya tiene muchos archivos y cosas creadas y no sé cómo retomar el trabajo sin empezar a dañarlo» [F1].

Lo que siguió fueron 90 mensajes en un solo día, 45 de ellos suyos [F1]. Recórrelo en la línea de tiempo de abajo. Son siete momentos, en orden. Léelos uno por uno y fíjate en cómo cambia el ánimo del día: dónde hay calma y dónde empieza la tormenta.

Lo que acabas de recorrer es un día con dos caras. En una, Julio explica con calma y la IA lo sigue. En la otra, un error se repite y la paciencia se acaba. Para entender por qué pasó cada cosa necesitamos ponernos de acuerdo en tres palabras.

Antes de entender ese día, pongámonos de acuerdo en tres palabras

Acabamos de ver el día completo. Para sacarle provecho necesitamos tres palabras que se usan mucho al trabajar con IA. Vamos a asegurarnos de que signifiquen lo mismo para todos, y a ubicar cada una en lo que pasó ese día.

La primera es contexto. El contexto es todo lo que la IA sabe de tu proyecto en el momento en que le hablas. Una IA de chat no ve tu computador: solo conoce lo que tú le muestras en esa conversación. Por eso lo primero que hizo Julio, a las 00:36, fue compartirle la lista de los archivos del sistema [F1].

La segunda es prompt. Un prompt es lo que le escribes a la IA para pedirle algo. Puede ser una frase o varios párrafos. De él depende casi todo: con un prompt vago, la IA adivina; con uno claro, trabaja [F3].

La tercera es registro. Un registro es una copia guardada del proyecto en un momento dado, con una nota que dice qué se hizo. La herramienta que los guarda se llama git, y en inglés a cada registro se le dice «commit». Sirve para devolverse: si un cambio daña algo, se regresa al último registro bueno. Eso hizo Julio a las 15:48 [F1].

Repasemos las tres antes de seguir. En la tabla de abajo toca «Contexto», «Prompt» y «Registro», uno por uno. La primera fila dice qué es cada una; la segunda, dónde apareció ese día.

Contexto, prompt y registro. Con esas tres palabras claras, volvamos al día y miremos primero el momento en que todo funcionó.

Lo que funcionó: 47 minutos explicando el oficio de un docente

Ya sabemos qué es un prompt. Ahora miremos los mejores del día. Entre las 15:59 y las 16:46, Julio dejó de pedir arreglos y se dedicó a explicar cómo evalúa un colegio a sus estudiantes. Necesitaba que la plataforma manejara dos maneras distintas de hacerlo, y que cada colegio eligiera una [F1].

No lo soltó todo en un solo mensaje. Lo hizo en ocho, y siguió un orden que vale la pena mirar despacio. Aquí abajo está ese tramo de la conversación, con los mensajes tal como se escribieron: los de Julio a la derecha y los de Claude a la izquierda. Van con su ortografía original, sin corregir, y donde veas el signo […] se recortó un tramo largo. Toca «La meta», «Modo 1», «Modo 2», «Quién decide» y «Por capas», en orden, y fíjate en qué dice Julio en cada paso y para qué sirve decirlo en ese momento.

Fíjate en tres cosas de ese tramo. La primera: después de un reclamo corto al comienzo, el tono se calma y los mensajes se vuelven largos y ordenados. La segunda: dos veces corrigió a la IA sobre cómo funciona un colegio, que es lo que él sabe [F1]. La tercera: nada de lo que explicó estaba en un manual de programación. Era el conocimiento de alguien que ha llenado planillas, entregado boletines y visto lo que pasa cuando un dato se cambia sin permiso.

Esa es la lección de este primer momento: quien conoce el oficio es quien dirige. La IA sabe escribir código; qué debe hacer ese código lo sabía el docente. Ahora miremos el otro momento del día, el que salió mal.

Lo que falló: un error que se repitió cuatro veces en 24 minutos

Venimos de 47 minutos en los que todo fluyó. A las 17:27 se acabó la calma. Julio intentó guardar una configuración y la pantalla respondió «419 Page Expired». La IA explicó la causa: estaba fallando la verificación de seguridad con la que el sistema comprueba cada formulario antes de aceptarlo [F1].

La IA propuso un arreglo. Julio lo aplicó y volvió a probar: el mismo error. Y así otra vez, y otra: cuatro reportes del mismo error en 24 minutos [F1]. Aquí abajo está ese tramo de la conversación, con los mensajes tal como se escribieron. Julio pidió mostrarlo completo, con lo bueno y con lo malo [F3]; lo único que se tapó fueron las groserías, con asteriscos, porque esta página también la leen menores. Toca «El error», «Se repite», «El límite», «Texto plano» y «El cambio», en orden, y fíjate en cómo se acortan los mensajes de Julio y cómo sube el tono.

Así se ve una persona cansada frente a una herramienta que no le responde como espera. Y así terminó de verdad esa historia: el error quedó resuelto de fondo 27 días después, el 29 de noviembre de 2025, según el historial del proyecto [F2].

¿Por qué tantos intentos no bastaron? Porque el problema estaba en la forma de trabajar. En un chat, la IA no ve el proyecto funcionando: propone un cambio, la persona lo copia a mano, lo prueba y le cuenta qué pasó. Cada vuelta es una adivinanza más. La misma IA lo dijo al final del día, al comparar el chat con Claude Code, una herramienta que trabaja dentro del proyecto: esa sí ve el proyecto completo, ejecuta órdenes y encuentra los errores reales del equipo [F1].

En el punto más bajo, a las 17:52, Julio pidió quitar la protección de esa pantalla con tal de que guardara. En esa copia de trabajo se hizo así. Hoy él mismo lo cuenta como lo que no se debe hacer: quitar una protección para salir de un error deja un problema nuevo y no resuelve el anterior [F3]. La salida de verdad llegó por otro lado, 27 días después, con un arreglo de fondo que quedó guardado en el historial del proyecto [F2].

Y una cosa más. Siete minutos después de ese punto bajo ya había tomado la decisión que cambió su manera de trabajar: «Vamos a ver si Claude Code da para trabajar con eso sin tantos errores» [F1]. La frustración lo llevó hasta el límite, y del límite salió un cambio de método. Miremos ahora las ideas equivocadas que hay detrás de un día así.

Las trampas de ese día, en las que cae casi todo el que empieza

Acabamos de ver los dos momentos del día. Detrás de cada uno hay una idea que parece cierta y no lo es. Julio las conoce bien porque las vivió, y hoy las cuenta sin adornos. Dice que cuando pierde la paciencia es porque está sobrecargado y sin foco, y que su mejor trabajo llega al revés: «cuando descanso y reflexiono, regreso y siempre obtengo mis mejores resultados» [F3].

Vamos a poner esas ideas a prueba. Abajo hay cuatro afirmaciones sobre trabajar con IA. En cada una decide si es mito o realidad, toca tu respuesta y lee la evidencia, que sale toda de ese día.

Guarda bien esas cuatro. Las tres que resultaron mito tienen algo en común: todas prometen un atajo. Ya las conoces; ahora te toca decidir a ti.

Tu turno: tres situaciones para decidir qué harías

Hasta aquí miramos lo que hizo otra persona. Ahora te toca a ti. Son tres situaciones parecidas a las de ese día. No hace falta saber programar para responderlas: basta con lo que vimos en las paradas anteriores.

Están aquí abajo, una a la vez. Piensa qué harías antes de elegir, toca tu respuesta y lee la explicación. Después pasa a la siguiente.

Si alguna te sorprendió, vuelve a la parada donde vimos esa idea. Si las tres te parecieron evidentes, mejor: lo difícil es acordarse de ellas cuando la cabeza está caliente. Para eso sirve la última parada.

El método que te llevas: cuatro pasos para retomar un proyecto con IA

Última parada. Repasemos lo que hicimos: recorrimos un día real, aclaramos tres palabras, miramos lo que funcionó y lo que falló, desmontamos cuatro ideas y decidiste en tres situaciones. Todo eso cabe en un método de cuatro pasos.

1. Guarda un registro antes de tocar nada. Así siempre tienes a dónde volver.
2. Da contexto antes de pedir: qué existe, cómo está organizado y qué quieres lograr.
3. Explica tu oficio con tus palabras y por partes: primero la meta, después cada pieza, y al final la orden de trabajar.
4. Si el mismo error se repite, detente. Descansa, y vuelve a cambiar la forma de trabajar o de explicar, en vez de insistir.

El diagrama de abajo es ese mismo método en una sola línea, para que lo recuerdes de un vistazo. Toca «Paso 1», «Paso 2», «Paso 3» y «Paso 4» y ubica en cada uno el momento del día en que se cumplió, o en que hizo falta.

Queda una idea para cerrar, y es de Julio. Trabajar con IA, dice, lo obliga a pensar mejor: «Es como si no me quedara de otra que razonar y ser más inteligente para que la IA me dé lo que sabe hacer» [F3]. La herramienta escribe el código, pero la claridad la pone quien la dirige. Con ese método, y con muchos días como este, se levantó una plataforma que hoy suma 1.831 registros guardados en su historial [F2]. En la próxima entrega seguimos con lo que vino después de ese día.