大量並列化クロードコード：22万行アプリ構築から得た教訓

並列処理戦略

最も大きな生産性向上は、コードベースの異なる部分で3〜4つのClaude Codeインスタンスを同時に実行することから得られました。1つのターミナルはバックエンドのCloud Functionsを処理し、別のターミナルはUIコンポーネントのリファクタリングを行い、さらに別のターミナルはテストを書きます。このアプローチにより、インスタンスが異なるファイルを扱う限り、セッションごとの変更数が2〜3件から10〜15件に増加しました。

プロンプトエンジニアリングの手法

プロンプトの質は出力の質に直接影響します。複雑なアーキテクチャタスクや難しいデバッグでは、「ultrathink」を前置して拡張思考モードを起動します。標準的なバグ修正にはデフォルトモードを使用します。効果的なプロンプトは、ファイルパス、コンポーネント名、現在の動作、期待される動作を指定します。「バグを修正して」のような曖昧なプロンプトは時間の無駄です。

コンテキスト管理の解決策

Claude Codeにはセッション間のメモリがないため、主要なセッション後に更新される引き継ぎドキュメントを維持します。このドキュメントには、構築した内容、壊れている部分、進行中の作業、主要なファイルパス、アーキテクチャの決定事項が含まれます。セッション開始時にこれを貼り付けることで、20分間のコンテキスト再説明を省けます。

プロジェクト設定

リポジトリのルートにCLAUDE.mdファイルを作成し、コーディング規約、コミットメッセージ形式、コンポーネントパターン、および「常にPressableScaleを使用し、生のPressableは使わない」や「すべてのcatchブロックはunknownとして型付けする必要がある」などの特定のルールを含めます。Claude Codeは自動的にこれらのルールを読み取り、従います。

カスタムコマンド

繰り返し作業をなくすためにカスタムスラッシュコマンドを構築します。例としては、コミット、プッシュ、OTAアップデートのデプロイを1ステップで行う/shipコマンドや、アプリとCloud Functionsの両方で型チェックを実行する/typecheckコマンドがあります。

コードベース監査

迅速な開発の後、Claude Codeに完全な監査を実行させ、問題を特定します。ある監査では、136の無防備なconsoleステートメント、309の型付けされていないcatchブロック、デッドファイル、セキュリティ問題、パフォーマンスのボトルネックが見つかりました。これらの問題を複数のターミナルで並行して修正することで、1日でコードベースの品質を大幅に向上させます。

コストと制限

このプロジェクトは約3か月で約40億トークンを消費し、約2,000ドルの費用がかかりました。これにより、AIチャット、Plaid APIを介した銀行連携、7つのテーマバリアント、市場データ、サブスクリプション管理、完全な通知システムを備えた本番アプリが構築されました。Claude Codeは非常に大きなファイル（1000行以上）に苦戦し、時々追跡に数時間かかる微妙なバグを導入することがあり、視覚的なデザイン決定はできず、セッション間のメモリはありません。