Claude Codeで開発の“グルーヴ”が乱れた時：AIと創る三刀流ワークフローの調律術
開発の現場で、予期せぬ技術的なノイズに遭遇した経験は誰にでもあるだろう。筆者もまた、最近のプロジェクトでAI（Claude Code）とのセッション中に、ローカルの依存関係コンフリクトやビルドエラーに直面した。その時、一時的に開発のグルーヴ、つまりリズムと創造的な流れが乱され、プロダクトの本質的な価値設計から意識が逸れそうになった経験がある。
TL;DR
AIとの開発では、局所的な問題解決に留まらず、プロダクトのビジネスゴールと全体アーキテクチャをAIに再提示し、”指揮者”として全体を調律する視点が不可欠だと筆者は考える。
背景と筆者の三刀流ワークフロー
筆者は大阪を拠点に、音楽家（Hormonize Records主宰）、Webエンジニア、そして経営者という三つの顔を持つ個人事業主だ。日々の開発では、Next.jsとTypeScript、Python(FastAPI)を軸に、SupabaseやGCPといったモダンな技術スタックを駆使している。そして、開発効率を最大化するために、AIアシスタントであるClaude Codeを積極的に活用してきた。
この三刀流ワークフローにおいて、エンジニアとしての実装スキルはもちろん重要だが、同時に音楽家としての「調和」や「即興性」、経営者としての「全体最適」や「ビジョン提示」といった視点も欠かせない。AIは、まさにこのワークフローを加速させる強力なパートナーとなるはずだった。
つまずいたポイント：乱された開発のグルーヴ
最近手がけていたプロジェクトで、新しい機能モジュールの開発をClaude Codeと共同で行っていた時の話だ。AIの提案に基づき実装を進め、ローカル環境でテストを行った際、予期せぬ依存関係のコンフリクトとビルドエラーが頻発した。
例えば、package.json内で定義された異なるモジュールが、互換性のないバージョンのライブラリを参照していたり、Typescriptの型定義が特定のフレームワークバージョンと合致していなかったりといった問題だ。Claude Codeは、エラーメッセージを正確に解析し、すぐにその場しのぎの修正案をいくつか提示してきた。
しかし、提示された修正案は、時として新たな問題を誘発したり、既存のアーキテクチャの整合性を損ねる可能性があった。筆者は、その局所的なデバッグ作業に没頭してしまい、まるで泥沼にはまったかのように、本来考えるべき「この機能がユーザーにどのような価値を提供するのか」「プロダクト全体の成長にどう貢献するのか」といった、本質的なビジネスゴールから意識が逸れていくのを感じた。まさに、開発のグルーヴが乱れ、セッションが停滞してしまった瞬間だった。
解決策：AIを「オーケストラの調律師」として再定義する
この状況で筆者は、一度コードから手を止めることを決めた。そして、Claude Codeに対し、以下のステップで再アプローチを行った。
- コード作業の一時中断と状況整理
目の前のエラーに感情的に反応するのではなく、何が問題で、どこに向かっていたのかを冷静に整理した。 - Claude Codeへのプロダクトビジョンとアーキテクチャの再提示
単なるエラー報告に終わらず、開発中のプロダクトが目指すビジネスゴール、そして現在のシステム全体のアーキテクチャ設計（各モジュールの責務、データフロー、主要な技術選択とその理由など）を、より詳細かつ網羅的にClaude Codeに説明した。 - 全体最適を考慮した修正案の依頼
特定のファイルや行の修正ではなく、「この依存関係のコンフリクトやビルドエラーが、システム全体の健全性に与える影響を考慮し、最も整合性が高く、将来的に保守しやすい解決策」を求めた。まるでオーケストラの指揮者が、特定の楽器の音程だけでなく、全体の響きの調和を求めるように。 - AIが提案した構造的改善案のレビューと適用
Claude Codeは、筆者の意図を深く汲み取った。提示されたのは、単なるバージョンアップ提案ではなく、特定のモジュールにおける依存関係の再設計や、共通ユーティリティ層への抽象化、あるいはTypescriptのStrictモードをより厳密に適用するためのリファクタリングなど、より根源的かつ構造的な改善案だった。
例えば、以下のようなプロンプトで、筆者の意図を伝えた。
「現在開発中のNext.jsアプリケーションでは、ユーザー管理をSupabase、API連携をFastAPIで行っています。今回の機能（例: リアルタイム通知）は、ユーザーエンゲージメント向上というビジネスゴールに直結します。現在、通知モジュールとSupabaseクライアント間の依存関係でビルドエラーが出ていますが、これは単にバージョンを合わせるだけでなく、今後スケールすることを考慮し、各モジュールの責務を明確にした上で、システム全体として最もクリーンで一貫性のある解決策を提案してください。」Claude Codeは、この広範なコンテキストを踏まえ、具体的なコード修正案に加え、なぜその修正が必要なのか、それがアーキテクチャ全体にどう影響するのかを論理的に説明してくれた。例えば、モノリシックな依存関係から、より疎結合なインターフェース設計への移行を提案し、そのための具体的なリファクタリングコードを示唆する、といった具合だ。
// 提案された修正の一例（ダミー）
// 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などを活用し、具体的な実装を分離このアプローチにより、筆者は局所的な問題解決に時間を浪費することなく、システム全体の品質を向上させながら、開発のグルーヴを取り戻すことができた。
まとめと新たな三刀流ワークフローの調律
今回の一件で筆者が驚いたのは、Claude Codeの文脈理解の深さと、問題解決に対するレスポンスの速さだ。それはまるで、腕の立つミュージシャンとインプロヴィゼーション（即興演奏）をしているような高揚感があった。
AIは単なるコード生成ツールではない。筆者が「全体の指揮者」としてプロダクトのビジョンやアーキテクチャの全体像を明確に提示すれば、AIは個々の「楽器（モジュール）」の役割を理解し、その調律や演奏（実装・デバッグ）を最適化してくれる、信頼できる共同制作者となる。
この経験を通じて、筆者の三刀流ワークフローはさらに深化を遂げた。細かな実装やデバッグといったルーティンはAIに任せ、筆者自身は経営者としてプロダクトの成長戦略を練り、音楽家としてシステム全体の「グルーヴ」と「響き」をデザインする「全体の指揮（コンダクション）」と「ビジョンの提示」に集中する。これは、創造性と効率性を両立させる、まさに新たなワークフローの確立を実感させる体験だった。
今後も筆者は、AIとの協調を通じて開発の「グルーヴ」をより深く探求し、技術とビジネス、そしてアートが融合する、独自のプロダクト創りを追求していく所存だ。
