Arte de desarrollo al ritmo de Claude Code y el hip-hop: Un nuevo flujo de trabajo donde la IA es el "encargado del código" y el autor dirige la visión
En el ámbito del desarrollo, no es raro enfrentarse a ruidos técnicos inesperados. Conflictos de dependencias, errores de construcción, errores impredecibles. Estos problemas pueden desviar la atención del diseño de valor esencial del producto y alterar el ritmo del desarrollo. Especialmente ahora que la colaboración con la IA se ha vuelto cotidiana, el autor siente que la calidad de esa comunicación es un factor crucial que influye en el tempo general del desarrollo.
TL;DR: La IA no es simplemente una herramienta de codificación, sino que al dirigirla como un "encargado del código" que comparte la visión, el desarrollo se acelera como un conjunto musical.
Entorno de desarrollo para "sesiones" con IA
El autor desarrolla habitualmente en un entorno GCP, utilizando Next.js y TypeScript para el frontend, y Python (FastAPI) y Supabase para el backend. En este flujo de trabajo, Claude Code no es solo una herramienta de generación de código, sino que funciona como un talentoso músico de sesión. Debido a que el autor es un "triple amenaza" —músico (fundador de Hormonize Records), ingeniero web y empresario— es muy consciente de la importancia de la "visión" y la "dirección" en el desarrollo.
En el desarrollo de IA tradicional, la IA a menudo se percibía como un subcontratista que simplemente escribía código. Sin embargo, en esencia, la colaboración con la IA es similar a la producción de hip-hop, donde un humano crea el ritmo y la IA añade líneas frescas sobre él. El autor se convierte en el director y da la bienvenida a Claude Code como un excelente "encargado del código". Creo que esta postura es la clave para innovar el flujo de trabajo de IA.
Flujo de desarrollo que dirige el "Ensamble"
Presento los pasos concretos del "arte del desarrollo al estilo hip-hop" que yo practico con Claude Code.
- Presentación de la visión y diseño de la arquitectura
Primero, explico detalladamente a Claude Code los objetivos comerciales del producto, los usuarios objetivo y el diseño general de la arquitectura. No se trata solo de una lista de requisitos funcionales, sino de compartir los aspectos fundamentales como "por qué es necesaria esa función" o "qué valor se ofrece al usuario". Por ejemplo, "este módulo de autenticación proporciona una experiencia segura y fluida al usuario, y considera futuras integraciones con servicios externos".
- Generación de código inicial y retroalimentación
Se le encarga a la IA la implementación inicial. El código generado no se ejecuta de inmediato, sino que primero se revisa desde la perspectiva de la coherencia con el diseño de la arquitectura, la legibilidad y la escalabilidad. La retroalimentación en esta etapa es un proceso crucial para que la IA aprenda "mi estilo". Es similar a la tarea de seleccionar el material adecuado, como la elección de samples en el BOOM BAP.
- Afinación como "Ensamble"
Esta es la fase más importante. No me limito a dar instrucciones para la corrección de errores locales o la adición de funciones en el código, sino que emito directrices para mantener la coherencia de todo el producto. Son órdenes de un nivel superior, como "este componente es responsable de tal experiencia de usuario, por lo que quiero que se refactorice considerando el flujo de datos con otros módulos relacionados". Al igual que un director de orquesta, afino el papel de cada módulo como un "ensamble". Como resultado, la IA no se convierte en un simple generador de código, sino que hace las propuestas más óptimas al comprender el contexto general.
- Delegar rutinas a la IA y yo me concentro en la dirección
Las tareas rutinarias como la implementación detallada, la depuración, la generación de código de prueba y la creación de documentación se delegan activamente a Claude Code. Mientras tanto, yo me concentro en desafíos de más alto nivel, como el diseño de UX, la optimización de la lógica de negocio, la elaboración de una hoja de ruta para futuras expansiones de servicios, o la búsqueda de nuevos enfoques musicales; áreas creativas que solo los humanos pueden realizar. Esto no solo conduce directamente a la optimización de la eficiencia del desarrollo, sino que también establece un flujo de trabajo con IA que maximiza mis habilidades "de tres espadas".
"Ruido" que interrumpió el ritmo del desarrollo y su solución mediante la "improvisación"
Puntos de tropiezo:
Durante las sesiones con Claude Code, hubo frecuentes "ruidos técnicos" como conflictos de dependencias locales y errores de compilación. Dado que mi entorno está siempre compuesto por las últimas bibliotecas y herramientas, hubo ocasiones en las que las sugerencias de la IA se desviaban temporalmente de mi intención, es decir, del ritmo general del producto. La IA proponía correcciones de código localizadas para solucionar los errores inmediatos, pero esto conllevaba el riesgo de dañar la arquitectura general. Esta no fue la primera vez que el ritmo de desarrollo se veía alterado y que mi atención se desviaba del diseño del valor esencial del producto.
Solución:
En ese momento, detuve mi trabajo con el código. Y volví a presentar a Claude Code los objetivos comerciales del producto y el diseño arquitectónico general de manera más profunda y específica. En lugar de pedir una corrección de error localizada, le di la instrucción: "Este error se debe a una inconsistencia entre el papel del módulo 〇〇 y la colaboración con el servicio 〇〇. Por favor, reajusta el papel de cada módulo como un conjunto y redirige el código hacia uno limpio y consistente". Era como una improvisación de jazz, volviendo al tema para luego tejer nuevas frases.
Sorprendentemente, Claude Code entendió perfectamente mi intención y, en unas pocas interacciones, propuso un código limpio y coherente que era irreconociblemente mejor. Sentí que esto no solo demostraba la alta capacidad de generación de código, sino también una mejora notable en la precisión de la comprensión del contexto y la inferencia de intenciones.
Resumen: La IA es un "músico de sesión habilidoso"
A través de esta experiencia, el autor se dio cuenta de que la comprensión contextual y la rapidez de respuesta de Claude Code proporcionaban una sensación de euforia, como si estuviera improvisando con un músico habilidoso. Las rutinas de desarrollo como la implementación de detalles y la depuración se dejan en manos de la IA, mientras que el autor, como gerente, músico e ingeniero, se concentra en la "dirección general (conducción)" y la "presentación de la visión". Se puede decir que el establecimiento de este nuevo enfoque de triple vía del flujo de trabajo de IA ha abierto nuevos horizontes para la optimización del desarrollo.
Próximos pasos:
La IA ya no es una simple herramienta, sino un co-creador y un excelente miembro de la banda. El autor continuará profundizando su diálogo con Claude Code y persiguiendo el ritmo del "desarrollo hip-hop". También les animamos a ustedes, los lectores, a desafiar nuevas sesiones de desarrollo, no viendo a la IA como un simple codificador, sino como el "encargado del código" para realizar su propia visión. Seguramente, allí les espera una nueva creatividad y la alegría del desarrollo con IA.
