¡El desarrollo de IA es una "sesión de improvisación"! Creando con Claude Code, el nuevo ritmo del ingeniero polivalente

El desarrollo de IA se suponía que sería fluido. Sin embargo, he experimentado cómo cierto "ruido" perturbó el ritmo de mi desarrollo y casi me desvió de la esencia del producto. Pero cuando superé esa barrera, el desarrollo con IA se transformó drásticamente en algo lleno de euforia, como una intensa sesión de improvisación con músicos profesionales.

TL;DR

El desarrollo de IA con Claude Code no se limita a modificaciones de código locales, sino que, mediante la "ingeniería de prompts" que armoniza la visión y la arquitectura de todo el producto como un "ensamble", es posible aumentar drásticamente la consistencia y la eficiencia.

Contexto y entorno: La triple función del autor y sus expectativas con la IA

El autor es un empresario individual con sede en Osaka, que ejerce una triple función: músico (fundador de Hormonize Records), ingeniero web y gestor. En su desarrollo diario, utiliza Next.js y TypeScript para el frontend, Python (FastAPI) para el backend, Supabase para la base de datos y GCP para la infraestructura. Con la notable evolución de la IA, siempre ha estado buscando cómo integrar la IA en su flujo de trabajo de desarrollo para mejorar la productividad y la creatividad generales.

Entre ellos, Claude Code de Anthropic, gracias a su excelente capacidad de comprensión contextual y su rápida respuesta, había generado grandes expectativas como nuevo socio de desarrollo para el autor. Para el autor, que persigue un estilo musical que enfatiza ritmos ajustados e improvisación como el BOOM BAP, el desarrollo interactivo con la IA contenía el potencial de crear un verdadero 'nuevo groove'.

Sesiones de improvisación en el desarrollo de IA: Pasos y el "groove" inicial

Mi desarrollo de IA comienza presentando a Claude Code los objetivos de negocio del producto y el marco arquitectónico. Al comunicar en detalle los requisitos específicos, la pila tecnológica y las funcionalidades esperadas, la IA se encarga de la generación inicial de código y la creación de los esqueletos de los módulos.

Por ejemplo, al solicitar la construcción de una API REST simple con gestión de usuarios y funciones de autenticación, se comienza con un prompt como el siguiente:

「あなたはPython (FastAPI) とSupabaseを用いたREST API開発のエキスパートです。ユーザー登録、ログイン、セッション管理、プロフィール更新機能を持つAPIを構築してください。セキュリティと拡張性を考慮し、モジュール分割も提案してください。」

Claude Code responde instantáneamente, proporcionando lógica de autenticación, propuestas de esquemas de bases de datos, estructuras de enrutamiento e incluso plantillas de código de prueba. Esta interacción inicial fue una experiencia estimulante, como si se le comunicara el tema de una canción a músicos de sesión y, al instante, se construyeran líneas de bajo y patrones de batería.

Reviso el código generado y doy feedback sobre la dirección arquitectónica y la lógica de negocio específica. La IA corrige y mejora el código basándose en ese feedback, y el "groove" del desarrollo parece acelerarse sin problemas.

Puntos de tropiezo y soluciones: La afinación del 'groove' desordenado

Aunque el desarrollo de la IA fue descrito como una "sesión de improvisación", en realidad no fue fluido desde el principio. En un momento, durante un diálogo con Claude Code, surgieron frecuentes conflictos de dependencias y errores de compilación en el entorno local. Aunque la IA ofrecía soluciones en cada ocasión, poco a poco comenzó a desviarse de la visión general que el autor pretendía.

Específicamente, al solicitar la refactorización de un módulo particular, la IA se centró únicamente en la optimización local, lo que resultó en un bucle donde se generaban nuevos errores al interactuar con otros módulos. Este "ruido técnico" era como si cada parte estuviera tocando de forma descoordinada durante una sesión de grabación, creando una cacofonía. El "groove" del desarrollo se alteró, y recuerdo que mi atención estuvo a punto de desviarse del "tema de la canción", que era el diseño del valor esencial del producto.

Lo que desconcertó al autor fue que las soluciones proporcionadas por la IA estaban demasiado enfocadas en la resolución de problemas puntuales. Por ejemplo, el siguiente intercambio:

\n筆者：「〇〇モジュールをリファクタリングして、テストコードを追加してほしい。」\nAI：「承知いたしました。以下に修正案を提示します。（コードブロック）しかし、この変更は△△モジュールに影響を与える可能性があります。」\n筆者：「では、△△モジュールも修正してほしい。」\nAI：「承知いたしました。（コードブロック）この修正は〇〇モジュールと競合する可能性があります。」\n

De esta manera, al resolver un problema, surgía otro, y estuve a punto de caer en un "bucle infinito" de depuración. Esta era precisamente una situación en la que me alejaba de la "musicalidad" del "código limpio y consistente" que el autor buscaba.

La solución fue detener la escritura de código por un momento.

Y luego, le presenté a Claude Code los objetivos comerciales del producto y el diseño arquitectónico general a un nivel de abstracción más alto. En lugar de instrucciones de corrección locales, busqué la armonía de todo el sistema como un "ensamble". El prompt específico fue el siguiente:

\n「一時停止しよう。現在の問題は局所的な修正の繰り返しから生じているようだ。この機能はプロダクト全体の『ユーザー体験のシームレスな流れ』という価値を提供する重要なセクションだ。現在のコードベースを、まるで一つの楽曲のように、各モジュールがそれぞれの役割を担い、全体として調和の取れた『アンサンブル』になるよう調律し直してほしい。特に、ユーザー体験の『リズム』を損なわないよう、パフォーマンスと保守性を重視してくれ。モジュールの依存関係を整理し、将来的な拡張性を考慮した設計を優先してほしい。」\n

Con este enfoque, Claude Code transformó su papel de una simple herramienta de corrección de código a un "director" de todo el proyecto. Se corrigió el rumbo hacia un código consistente y limpio, que consideraba la independencia y la interconexión de cada módulo. El autor sintió que esto era precisamente como un director de orquesta que no solo persigue el sonido individual de cada instrumento, sino también la armonía del conjunto.

Sorpresa y aprendizaje: El nuevo 'groove' establecido por el ingeniero polivalente

A partir de esta experiencia, el autor quedó nuevamente sorprendido por la profunda comprensión contextual y la rapidez de respuesta de Claude Code. Sentía una euforia como si estuviera improvisando con un músico talentoso. Cuando el autor presentaba una visión o un concepto abstracto, la IA lo convertía en "notas" de código concreto y empezaba a "tocar" al instante. Y si el autor daba una pequeña instrucción de modificación, ajustaba la "frase" de inmediato. Este ciclo de retroalimentación de alta velocidad generó un "groove" único que no se obtiene en el desarrollo convencional.

En este nuevo flujo de trabajo, el papel del autor también se clarificó. Las tareas rutinarias como la implementación detallada y la depuración se delegaron a la IA, permitiéndole al autor concentrarse en la "conducción": presentar la "visión" del producto como gerente y dirigir el "conjunto" de toda la base de código como músico. Esto es precisamente una nueva forma del estilo polivalente que el autor persigue, y siente que es un gran paso en la mejora del flujo de trabajo en el desarrollo de IA. El autor considera que la ingeniería de prompts no es una técnica para manipular la IA, sino una "dirección" y "comunicación" para aprovechar al máximo la IA como instrumento.

Conclusión + Próximas acciones: En busca de un nuevo "groove" con la IA

El desarrollo de IA ya no es una herramienta para que los humanos generen código unilateralmente. El autor cree firmemente que es una "sesión de improvisación" donde humanos e IA se estimulan mutuamente y mejoran la creatividad. En particular, las IA de alto rendimiento como Claude Code, que comprenden conceptos abstractos y pueden hacer sugerencias que consideran la armonía general, permiten a los desarrolladores concentrarse en una creación de valor más esencial.

Como experimentó el autor esta vez, incluso si ocurre "ruido técnico" durante el desarrollo, al volver a presentar a la IA la visión general del producto y los objetivos de negocio, y al promover la afinación como un "ensamble", definitivamente será posible recuperar el "groove" del desarrollo.

Este nuevo estilo de desarrollo de IA influirá en gran medida en la futura eficiencia del desarrollo. El autor continuará buscando el "nuevo groove" con Claude Code, y avanzando en un desarrollo de productos más creativo y esencial. A los lectores, les animo a experimentar una "sesión de improvisación" con la IA, y a encontrar su propio "nuevo groove". La clave es, no dejar que la IA "dirija", sino ser uno mismo el "director", y que la ingeniería de prompts presente una visión clara.