De un script monolítico a una arquitectura de software
Proyecto educativo de práctica deliberada aplicando disciplina metodológica con asistentes de código
Hace unos años, cuando empecé a aprender NextJS, hice lo típico: un mini proyecto siguiendo un curso. Una página de Pokémon. Un ejercicio más.
Más adelante se me ocurrió que podía resultar una especie de juego para que mi hija practicara el uso del ratón. Se la puse y funcionó.
Ahora ha crecido y le encanta Monster High. Dado el éxito, me planteé: ¿Y si hago algo parecido, pero para que practique a leer?
Del problema simple a la solución estructurada
Empecé por lo simple: raspar datos de la Wiki en Fandom. Personajes, imágenes, biografías… lo justo para tener material. Y entonces apareció la tentación inevitable: "¿Y si lo enriquezco?"
Conecté un LLM y empecé a generar cuentos personalizados por personaje. Funcionaba.
Pero en paralelo yo tenía otro objetivo: la práctica deliberada. No "hacer que funcione", sino poder valorar los resultados y experiencia de construir software que aguante el paso del tiempo usando la IA como apoyo.
Así que decidí convertir ese script de un solo archivo en un proyecto con arquitectura hexagonal, cumpliendo los principios de ingeniería de software totalmente asistido por IA.
El experimento: enseñar metodología a una IA
Y aquí es donde empezó el experimento de verdad.
Gracias a lo visto en las mentorías de Software Crafters y los recursos compartidos, me propuse transformar un script básico de un solo archivo en un proyecto estructurado bajo principios SOLID, pero hecho asistido por IA. No fue un proceso de 'copiar archivos': el hecho de usar un IDE alternativo a Cursor, que es el que se ve en las masterclass, me ayudó para tener que entender la lógica interna de las reglas y cómo cada herramienta de IA las procesa. Fue un ejercicio de práctica deliberada donde el objetivo no era solo terminar la web, sino dominar el flujo de trabajo asistido por IA.
Escribí unas reglas claras y no negociables:
- Test primero. Siempre.
- Red → Green → Refactor (sin saltos)
- Transformaciones simples (TPP)
- Sin mocks "porque sí"
- YAGNI de verdad (nada de construir por si acaso)
La experiencia fue brutal. Trabajaba como si estuviéramos haciendo pair programming con disciplina.
No era magia. Era ritmo. Feedback. Control.
Conclusión
Mi hija tiene material para practicar lectura.
Yo he podido confirmar en mi propio terreno lo que ya intuía: no se trata de "usar IA", sino de lograr que la IA trabaje para ti dentro de un marco de disciplina y método.
Además de todo lo aplicado siguiendo las recomendaciones de la mentoría de Software Crafters, descubrí que organizar las tareas mediante archivos que representan la planificación detallada es fundamental. Esta estructura documental me permitió mantener el desarrollo ordenado, retomar el trabajo sabiendo exactamente dónde lo había dejado, y tener siempre claro de dónde vengo y hacia dónde voy. La combinación de metodología + IA + planificación explícita resultó ser la clave del éxito.
Explora el código
Si a alguien le sirve como referencia o le pica la curiosidad de "XP + TDD + humano-IA", todos los detalles, el proceso y recursos en los que me he apoyado, están documentados en el README del repo.