Cuando el “ritmo” del desarrollo se interrumpe con Claude Code: El arte de afinar un flujo de trabajo de triple amenaza creado con IA
Cualquiera que trabaje en desarrollo se habrá encontrado con ruidos técnicos inesperados. Yo mismo, durante una sesión con IA (Claude Code) en un proyecto reciente, me enfrenté a conflictos de dependencia local y errores de compilación. En ese momento, el "groove" del desarrollo, es decir, el ritmo y el flujo creativo, se interrumpió temporalmente, y sentí que mi atención se desviaba del diseño del valor esencial del producto.
TL;DR
En el desarrollo con IA, el autor considera indispensable no limitarse a la resolución de problemas locales, sino replantear a la IA los objetivos de negocio del producto y su arquitectura general, adoptando una perspectiva de 'director' para armonizar el conjunto.
Antecedentes y el flujo de trabajo de triple estilo del autor
El autor es un empresario individual con tres facetas: músico (fundador de Hormonize Records), ingeniero web y empresario, con sede en Osaka. En el desarrollo diario, se centra en Next.js, TypeScript y Python(FastAPI), utilizando una pila tecnológica moderna como Supabase y GCP. Y, para maximizar la eficiencia del desarrollo, ha utilizado activamente el asistente de IA, Claude Code.
En este flujo de trabajo de triple estilo, las habilidades de implementación como ingeniero son, por supuesto, importantes, pero al mismo tiempo, perspectivas como la "armonía" y la "improvisación" como músico, y la "optimización global" y la "presentación de la visión" como empresario, son indispensables. La IA, precisamente, estaba destinada a ser un socio poderoso para acelerar este flujo de trabajo.
Punto de tropiezo: El ritmo de desarrollo interrumpido
Se trata de un proyecto en el que estuve trabajando recientemente, desarrollando un nuevo módulo de funciones en colaboración con Claude Code. Cuando implementamos las sugerencias de la IA y realizamos pruebas en el entorno local, surgieron frecuentemente conflictos de dependencia inesperados y errores de compilación.
Por ejemplo, problemas como que diferentes módulos definidos en package.json referenciaran versiones incompatibles de librerías, o que las definiciones de tipo de Typescript no coincidieran con una versión específica del framework. Claude Code analizó con precisión los mensajes de error e inmediatamente propuso varias soluciones provisionales.
Sin embargo, las soluciones propuestas a veces podían inducir nuevos problemas o comprometer la integridad de la arquitectura existente. Me sumergí tanto en esa depuración localizada que me sentí como atrapado en un lodazal, y noté cómo mi atención se desviaba de los objetivos comerciales esenciales que debía considerar: "¿Qué valor aportará esta función al usuario?" y "¿Cómo contribuirá al crecimiento general del producto?". Fue precisamente el momento en que el ritmo de desarrollo se interrumpió y la sesión se estancó.
Solución: Redefinir la IA como el "afinador de orquesta"
En esta situación, el autor decidió dejar de lado el código por un momento. Luego, reenfocó su aproximación a Claude Code siguiendo los siguientes pasos:
- Interrupción temporal del trabajo de codificación y organización de la situación
En lugar de reaccionar emocionalmente al error inmediato, organizó con calma cuál era el problema y hacia dónde se dirigía. - Re-presentación de la visión del producto y la arquitectura a Claude Code
No se limitó a un simple informe de error, sino que explicó a Claude Code, de manera más detallada y exhaustiva, los objetivos de negocio que el producto en desarrollo buscaba alcanzar y el diseño arquitectónico actual de todo el sistema (responsabilidades de cada módulo, flujo de datos, elección de tecnologías clave y sus razones, etc.). - Solicitud de una propuesta de corrección que considere la optimización global
En lugar de una corrección de un archivo o línea específica, solicitó 'una solución que considerara el impacto de este conflicto de dependencias o error de compilación en la salud general del sistema, que fuera la más coherente y fácil de mantener en el futuro'. Como un director de orquesta que no solo busca la afinación de un instrumento específico, sino la armonía del sonido en su conjunto. - Revisión y aplicación de las propuestas de mejora estructural de la IA
Claude Code comprendió profundamente la intención del autor. Lo que se propuso no fue una simple sugerencia de actualización de versión, sino propuestas de mejora más fundamentales y estructurales, como el rediseño de dependencias en módulos específicos, la abstracción a una capa de utilidad común o la refactorización para aplicar el modo estricto de TypeScript de manera más rigurosa.
Por ejemplo, el autor comunicó su intención con un prompt como el siguiente:
「現在開発中のNext.jsアプリケーションでは、ユーザー管理をSupabase、API連携をFastAPIで行っています。今回の機能（例: リアルタイム通知）は、ユーザーエンゲージメント向上というビジネスゴールに直結します。現在、通知モジュールとSupabaseクライアント間の依存関係でビルドエラーが出ていますが、これは単にバージョンを合わせるだけでなく、今後スケールすることを考慮し、各モジュールの責務を明確にした上で、システム全体として最もクリーンで一貫性のある解決策を提案してください。」Claude Code, basándose en este amplio contexto, explicó lógicamente no solo las propuestas concretas de modificación de código, sino también por qué eran necesarias y cómo afectarían a la arquitectura general. Por ejemplo, sugirió la transición de dependencias monolíticas a un diseño de interfaz más débilmente acoplado, e indicó código de refactorización específico para lograrlo.
// 提案された修正の一例（ダミー）
// BEFORE: 直接的な依存関係で型定義が衝突
// import { SomeService } from 'shared-library-v1';
// AFTER: 抽象化されたインターフェースを介した依存関係
interface INotificationService {
sendNotification(userId: string, message: string): Promise<void>;
}
class SupabaseNotificationService implements INotificationService {
// ... Supabase specific implementation ...
}
// DIなどを活用し、具体的な実装を分離Gracias a este enfoque, el autor pudo recuperar el ritmo de desarrollo, mejorando la calidad general del sistema sin perder tiempo en la resolución de problemas localizados.
Resumen y ajuste del nuevo flujo de trabajo de tres sables
Lo que sorprendió al autor en este caso fue la profundidad de la comprensión contextual de Claude Code y la rapidez de su respuesta a la resolución de problemas. Tuvo una sensación de euforia, como si estuviera improvisando con un músico talentoso.
La IA no es solo una herramienta de generación de código. Si el autor presenta claramente la visión del producto y la arquitectura general como el «director de orquesta», la IA se convierte en un colaborador de confianza que comprende el papel de cada «instrumento (módulo)» y optimiza su afinación y ejecución (implementación y depuración).
A través de esta experiencia, el flujo de trabajo de tres sables del autor se profundizó aún más. Las rutinas como la implementación y depuración detalladas se dejan a la IA, mientras que el autor se concentra en idear estrategias de crecimiento del producto como empresario y en la «dirección general (conducción)» y la «presentación de la visión» diseñando el «groove» y la «resonancia» de todo el sistema como músico. Esta fue una experiencia que hizo sentir la verdadera consolidación de un nuevo flujo de trabajo que equilibra creatividad y eficiencia.
En el futuro, el autor continuará explorando más profundamente el «groove» del desarrollo a través de la colaboración con la IA, y perseguirá la creación de productos únicos donde la tecnología, los negocios y el arte se fusionen.
