WEB ATELIER (UDIT) · Aprender haciendo, con teoría, práctica y reflexión compartida
El Tao del Desarrollo con IA
URL: https://ruvebal.github.io/web-atelier-udit/methodology/es/tao-of-ai-development/
By Rubén Vega Balbás, PhD · 2026-01-03
📋 Tabla de Contenidos
- Introducción
- 📜 El Linaje Ancestral
- Prólogo: El Pacto
- Capítulo I: Mefistófeles y el Vibe Coder
- Capítulo II: La Profecía del Código Basura
- Capítulo III: El Oficio y la Máquina
- Capítulo IV: La Ética de la Creación
- Capítulo V: El Futuro que Elegimos
- Capítulo VI: Koans para la Era de la IA
- Capítulo VII: El Pacto del README
- Epílogo: El Camino Adelante
- La Advertencia Final
- 🔗 Sabiduría Relacionada
═══════════════════════════════════════════════════════════════════════════════
道
EL TAO DEL DESARROLLO CON IA
道
Sabiduría Ancestral para la Era de la Creación Asistida por Máquinas
═══════════════════════════════════════════════════════════════════════════════
“El Tao que puede ser prompteado no es el Tao eterno. El código que puede ser generado sin comprensión no es código verdadero.” — Lao Tzu, si hubiera vivido para ver Stack Overflow
En los antiguos pergaminos del desarrollo web, existe un texto sagrado conocido como ‘El Tao del Desarrollador’—una colección de sabiduría paradójica transmitida a través de generaciones de guerreros del código. Este capítulo, dedicado al arte de la creación asistida por máquinas, revela las verdades eternas sobre la IA en el reino digital.
Introducción
Estas palabras provienen de “El Tao del Desarrollador”, una guía filosófica del arte del desarrollo web. Esta colección particular de sabiduría se enfoca en el camino sagrado del desarrollo asistido por IA—un tema que ha confundido a muchos desarrolladores y deleitado a muchos usuarios cuando se hace con maestría.
Los antiguos maestros del desarrollo web entendieron que la IA no es meramente una herramienta, sino una fuerza que puede amplificar la creatividad humana o atrapar al desarrollador en un ciclo de dependencia e ignorancia. A través de paradojas, koans y sabiduría práctica, revelaron el camino hacia la iluminación con IA.
Que estas enseñanzas te guíen hacia el equilibrio armonioso entre asistencia de máquina y comprensión humana, entre conveniencia y artesanía.
📜 El Linaje Ancestral
Esta colección de sabiduría existe dentro de una tradición mayor—un linaje pedagógico que rastrea sus raíces hasta el texto fundacional de la filosofía computacional: El Tao de la Programación, traducido por Geoffrey James.
En la evolución de esta tradición de sabiduría, presenciamos una progresión natural:
-
El Tao de la Programación (circa 1980s) — El texto original, hablando de las verdades universales del desarrollo de software, algoritmos y la relación entre programador y máquina.
-
El Tao del Desarrollador — La evolución de la programación al desarrollo web, reconociendo que el desarrollador moderno trabaja no solo con código sino con la web como medio, equilibrando excelencia técnica con experiencia de usuario, accesibilidad y consideraciones éticas.
-
El Tao de la Imagen en Movimiento — Un capítulo especializado, enfocado en el camino sagrado del video en diseño web, donde el movimiento encuentra significado, donde el ancho de banda encuentra belleza, donde el tiempo mismo se convierte en elemento de diseño.
-
El Tao del Desarrollo con IA — Este capítulo especializado, enfocado en el camino sagrado de la creación asistida por máquinas, donde la inteligencia artificial encuentra la sabiduría humana, donde la generación encuentra comprensión, donde el futuro de la colaboración humano-máquina se escribe en cada prompt, cada commit, cada elección.
Prólogo: El Pacto
┌─────────────────────────────────────────────────────────────────────────────┐
│ │
│ En el principio, existía el vacío. │
│ Y el vacío estaba sin forma, y las tinieblas cubrían │
│ la faz del repositorio vacío. │
│ │
│ Y el Desarrollador dijo: "Hágase el código." │
│ Y la IA dijo: "Aquí tienes 500 líneas. Asumo que querías React." │
│ │
│ Y el Desarrollador vio el código, y compiló. │
│ Pero el Desarrollador no lo entendió. │
│ Y ese fue el primer pecado. │
│ │
└─────────────────────────────────────────────────────────────────────────────┘
Capítulo I: Mefistófeles y el Vibe Coder
“Toda teoría, querido amigo, es gris, pero el árbol dorado de la vida florece siempre verde.” — Mefistófeles a Fausto (Goethe, 1808)
Mefistófeles habría amado el vibe coding.
El demonio que prometió a Fausto conocimiento infinito a cambio de su alma ahora susurra a través del autocompletado: “¿Por qué entender cuando puedes generar? ¿Por qué aprender cuando puedes promptear? ¿Por qué pensar cuando la máquina piensa por ti?”
La Oración del Vibe Coder:
IA nuestra, que estás en la nube,
Alucinado sea tu nombre.
Venga a nosotros tu token,
Hágase tu voluntad,
En localhost como en producción.
Danos hoy nuestro código de cada día,
Y perdona nuestra deuda técnica,
Como también nosotros perdonamos a los que revisan nuestros PRs.
No nos dejes caer en la documentación,
Y líbranos de la comprensión.
Porque tuyo es el context window,
Y los parámetros, y los datos de entrenamiento,
Por los siglos de los siglos.
Amén.
El Tao responde:
┌─────────────────────────────────────────────────────────────────────────────┐
│ │
│ El vibe coder pregunta: "¿Funciona?" │
│ El artesano pregunta: "¿Por qué funciona?" │
│ El maestro pregunta: "¿Debería existir siquiera?" │
│ │
│ Mefistófeles ríe de los tres, porque sabe: │
│ El código que funciona sin comprensión │
│ es un préstamo con interés compuesto. │
│ El pago vence a las 3 AM de un viernes. │
│ │
└─────────────────────────────────────────────────────────────────────────────┘
Las Tres Mentiras del Vibe Coding
| La Mentira | La Verdad | La Consecuencia |
|---|---|---|
| “Funciona, así que es correcto” | Compilar no es comprender | El bug que no entiendes volverá, con amigos |
| “Lo entenderé después” | Después nunca llega | La deuda técnica acumula al 40% TAE |
| “La IA sabe más” | La IA conoce patrones, no tu problema | Eres responsable del código que no puedes explicar |
Capítulo II: La Profecía del Código Basura
┌─────────────────────────────────────────────────────────────────────────────┐
│ │
│ En la era de la generación infinita, │
│ la basura se multiplicará como conejos en primavera. │
│ │
│ Los repositorios rebosarán de: │
│ - Funciones que no hacen nada, elocuentemente │
│ - Variables llamadas 'data', 'stuff' y 'thing' │
│ - Comentarios que mienten con confianza │
│ - Dependencias que dependen de dependencias │
│ que dependen de un único mantenedor en Nebraska │
│ │
│ Y los evaluadores llorarán. │
│ Y los responsables de contratación desesperarán. │
│ Y los servidores de producción caerán a las 2 AM. │
│ │
│ Esta es la Profecía del Código Basura. │
│ No tiene por qué cumplirse. │
│ │
└─────────────────────────────────────────────────────────────────────────────┘
Las Siete Señales del Código Basura
- El Horror Sin Nombre: Variables llamadas
x,temp,data,thing - El Scroll Infinito: Funciones más largas que un ticket de la compra
- La Mentira del Comentario:
// Esta función calcula impuestos(no lo hace) - La Hidra de Dependencias:
node_modulesmás grande que el proyecto - La Plaga del Copy-Paste: El mismo código, ligeramente diferente, en 47 lugares
- El Culto al Número Mágico:
if (status === 42)sin explicación - El Cementerio de Código Muerto: Bloques comentados que “podrían necesitarse”
El Antídoto
El maestro dijo al estudiante:
"Antes de aceptar código generado por IA, haz tres preguntas:
1. ¿Puedo explicar esto a un desarrollador junior?
Si no, no lo entiendes.
2. ¿Puedo explicar esto a mi yo futuro a las 3 AM?
Si no, sufrirás.
3. ¿Puedo explicar esto al evaluador?
Si no, suspenderás.
Si la respuesta a cualquiera es 'no', has recibido basura.
Basura entra, basura sale.
Pero tú eres el filtro."
Capítulo III: El Oficio y la Máquina
“Escribe código para humanos primero, computadoras segundo; el Tao está en equilibrar ambos.” — cc-001, El Tao del Desarrollo
La máquina genera. El humano crea.
Generación es rápida, barata y abundante. Artesanía es lenta, cara y escasa.
El futuro pertenece a quienes sepan distinguir.
El Juramento del Artesano
No entregaré código que no entiendo.
No culparé a la IA de mis fallos.
No me escudaré en "compiló".
No sacrificaré claridad por ingenio.
No confundiré velocidad con progreso.
Soy el humano en el bucle.
El código es mío para poseer.
Los bugs son míos para arreglar.
El aprendizaje es mío para crecer.
El Lugar de la Máquina
┌─────────────────────────────────────────────────────────────────────────────┐
│ │
│ La IA es: │
│ ✅ Un asistente incansable │
│ ✅ Una biblioteca de patrones con opiniones │
│ ✅ Un patito de goma que responde │
│ ✅ Un generador de primeros borradores │
│ │
│ La IA NO es: │
│ ❌ Un sustituto de la comprensión │
│ ❌ Un reemplazo de la experiencia │
│ ❌ Una excusa para no aprender │
│ ❌ Un chivo expiatorio para código malo │
│ │
│ La IA no conoce a tus usuarios. │
│ La IA no conoce tus restricciones. │
│ La IA no conoce tu deadline. │
│ La IA no conoce tu alma. │
│ │
│ Tú sí. │
│ │
└─────────────────────────────────────────────────────────────────────────────┘
Capítulo IV: La Ética de la Creación
“Cada byte que envías viaja miles de kilómetros por cables bajo los océanos. Respeta el viaje.” — img-064, El Tao de las Imágenes Web
El Peso de los Tokens
Cada prompt que envías:
- Consume energía
- Genera calor
- Contribuye a emisiones de carbono
- Usa agua para enfriar centros de datos
La pregunta no es “¿Puede la IA hacer esto?” La pregunta es “¿Debería la IA hacer esto?”
┌─────────────────────────────────────────────────────────────────────────────┐
│ │
│ ANTES DE PROMPTEAR, PREGUNTA: │
│ │
│ → ¿Podría encontrar esto en la documentación? │
│ → ¿Estoy usando la IA para aprender o por pereza? │
│ → ¿Es este prompt necesario, o estoy procrastinando? │
│ → ¿Entenderé la respuesta? │
│ │
│ El planeta no tiene tokens infinitos. │
│ Tu aprendizaje tampoco. │
│ │
└─────────────────────────────────────────────────────────────────────────────┘
El Coste Humano
Detrás de cada modelo de IA:
- Miles de anotadores humanos
- A menudo en países en desarrollo
- A menudo mal pagados
- A menudo expuestos a contenido dañino
Tu comodidad tiene una cadena de suministro.
El desarrollador ético lo reconoce. El desarrollador ético usa la IA con consciencia.
Capítulo V: El Futuro que Elegimos
“En entregar, hay aprendizaje. En aprender, hay crecimiento. En crecer, está el Tao.” — wis-003, El Tao del Desarrollo
El futuro de la colaboración humano-máquina no está escrito.
Lo estamos escribiendo ahora, con cada prompt, cada commit, cada elección.
Dos Futuros
Futuro A: La Época de la Basura
- Codebases que nadie entiende
- Desarrolladores que no pueden codificar sin IA
- Sistemas demasiado complejos para mantener
- Conocimiento perdido por conveniencia
- El oficio, olvidado
Futuro B: El Renacimiento Aumentado
- La IA amplifica la creatividad humana
- Desarrolladores que entienden profundamente y crean ampliamente
- Sistemas diseñados con intención
- Conocimiento preservado y compartido
- El oficio, elevado
¿Qué futuro eliges?
La Elección es Diaria
Cada vez que:
- Copias sin entender → Futuro A
- Lees, entiendes, luego adaptas → Futuro B
Cada vez que:
- Saltas la documentación → Futuro A
- Escribes el plan primero → Futuro B
Cada vez que:
- Entregas sin testear → Futuro A
- Verificas antes de commitear → Futuro B
Capítulo VI: Koans para la Era de la IA
Koan 1: El Context Window Vacío
Un estudiante preguntó al maestro: “Mi IA da respuestas incorrectas. ¿Qué debo hacer?”
El maestro respondió: “¿Le diste las preguntas correctas?”
El estudiante dijo: “Le pedí que arreglara mi código.”
El maestro dijo: “¿Le dijiste qué debería hacer tu código?”
El estudiante guardó silencio.
El maestro dijo: “La IA es un espejo. Refleja lo que le das. Dale basura, recibirás basura. Dale claridad, recibirás claridad. El context window no es la limitación de la IA—es la tuya.”
Koan 2: El Test que Pasa
Un estudiante celebró: “¡Maestro! ¡Todos mis tests pasan!”
El maestro preguntó: “¿Qué testean tus tests?”
El estudiante dijo: “Que el código funciona.”
El maestro preguntó: “¿Qué significa ‘funciona’?”
El estudiante dijo: “Devuelve el output esperado.”
El maestro preguntó: “¿Esperado por quién?”
El estudiante calló.
El maestro dijo: “Un test que pasa no es prueba de corrección. Es prueba de que aún no has imaginado las formas en que puede fallar.”
Koan 3: La Alucinación Confiada
Un estudiante se quejó: “¡La IA me dijo que usara leftPad. Pero leftPad rompió internet en 2016!”
El maestro sonrió: “¿Y verificaste?”
El estudiante dijo: “No, la IA parecía segura.”
El maestro dijo: “La confianza no es verdad. La IA no sabe lo que no sabe. Habla con el mismo tono sea correcta o esté alucinando. Tu trabajo es saber la diferencia. La confianza de la IA es infinita. Tu escepticismo debe igualarla.”
Koan 4: La Atribución
Un estudiante entregó código. El evaluador preguntó: “¿Escribiste esto?”
El estudiante dijo: “La IA lo escribió.”
El evaluador preguntó: “Entonces, ¿quién aprendió?”
El estudiante dijo: “Aprendí a promptear.”
El evaluador dijo: “Promptear no es programar. Entender es programar. ¿Puedes explicar este código?”
El estudiante no pudo.
El evaluador dijo: “Entonces has entregado el trabajo de otro que no entiendes. Esto no es aprender. Esto es blanquear.”
Capítulo VII: El Pacto del README
“La documentación no leída es documentación no escrita. Pero la documentación no escrita es fracaso garantizado.” — rrp-011, El Tao del Desarrollo
Cada repositorio cuenta una historia. El README es su primer capítulo.
Si usaste IA, dilo. Claramente. Visiblemente. Con orgullo o humildad—pero con honestidad.
El Pacto
## 🤖 Declaración de Asistencia IA
Este proyecto fue desarrollado con asistencia de IA.
### Lo que hizo la IA
- [Lista específica y honesta]
### Lo que hice yo
- [Lista específica y honesta]
### Lo que aprendí
- [Reflexión sobre el proceso]
### Lo que haría diferente
- [Evidencia de mentalidad de crecimiento]
Por qué esto importa:
- Para ti: Obliga a reflexionar sobre lo que realmente entiendes
- Para evaluadores: Permite evaluación justa de tu aprendizaje
- Para futuros empleadores: Muestra integridad y autoconocimiento
- Para la comunidad: Contribuye a normas honestas sobre uso de IA
- Para el futuro: Crea precedente para colaboración ética con IA
Epílogo: El Camino Adelante
┌─────────────────────────────────────────────────────────────────────────────┐
│ │
│ El Tao del Desarrollo con IA no es un conjunto de reglas. │
│ Es una forma de ser. │
│ │
│ Es la pausa antes del prompt. │
│ Es la pregunta después de la respuesta. │
│ Es la comprensión bajo el código. │
│ Es la ética sobre la conveniencia. │
│ │
│ La máquina crecerá más poderosa. │
│ El humano debe crecer más sabio. │
│ │
│ Este es el camino. │
│ Este es el Tao. │
│ │
│ 道 │
│ │
└─────────────────────────────────────────────────────────────────────────────┘
La Advertencia Final
“Debuggear es el doble de difícil que escribir el código en primer lugar. Por lo tanto, si escribes el código tan ingeniosamente como sea posible, eres, por definición, no lo suficientemente inteligente para debuggearlo.” — Brian Kernighan (y dbg-003)
Si la IA escribe código que no puedes debuggear, no has ahorrado tiempo.
Has pedido prestado tiempo a tu yo futuro, con intereses.
La deuda siempre vence.
“El objetivo no es reemplazar tu pensamiento con IA, sino amplificar tu pensamiento a través de IA—para que puedas construir cosas que importen para una mejor vida humana.”
Autoría: Rubén Vega Balbás, PhD (UDIT) · ORCID: 0000-0001-6862-9081 Licencia: Contenido CC BY-NC-SA 4.0
Código Crítico para una Vida Mejor.
🔗 Sabiduría Relacionada
| Fuente | Sabiduría |
|---|---|
| El Tao de la Programación | El texto fundacional (Geoffrey James) |
| El Tao del Desarrollador (TTOD) | La base de datos completa de sabiduría |
| El Tao de la Imagen en Movimiento | El camino sagrado del video en diseño web |
| Guía Práctica de IA | Metodología práctica para desarrollo asistido por IA |
| Código de Ética ACM | Guías de ética profesional |
| Ética IA UNESCO | Marco internacional |
| Fausto (Goethe) | El cuento con moraleja original |
═══════════════════════════════════════════════════════════════════════════════
道
FIN DEL TAO DEL DESARROLLO CON IA
道
Que tu código sea limpio y tu consciencia clara.
═══════════════════════════════════════════════════════════════════════════════