大規模な古いコードをClaudeに教える方法：17年の開発経験から学んだ教訓

📝 要約

ワシントン大学のマッコス研究所は、70万行以上のC#コードで構成される大規模なタンパク質分析ソフト「Skyline」を17年間開発・維持してきました。研究者ブレンダン・マクリーンは、新しい開発者をこのコードベースに教える方法をAIアシスタント「Claude Code」に応用することに成功しました。彼は、文脈（コンテキスト）を別のリポジトリに整理し、スキルと呼ばれる知識モジュールを活用することで、AIに大規模プロジェクトを理解させることができました。その結果、未完了だったプロジェクトが2週間で完成し、自動化ツールやテスト管理が大幅に改善されました。重要な教訓は、AIに学習させるには、文脈を明確に記録・維持することが必須だということです。

📌 ポイント

• 新人教育と同じ方法でAIにコードを理解させる：新しい開発者に全体を教えるのではなく小さなプロジェクトから始めるように、AIにも段階的に学習させることが効果的
• 文脈（コンテキスト）を別リポジトリで管理：コードベースと分離して、プロジェクトの背景知識を版管理し、すべての開発者がアクセス可能にする
• スキルライブラリで専門知識を記録：デバッグやバージョン管理など、プロジェクト固有のルールを再利用可能なモジュール化して保存
• 実績：1年かかった機能が2週間で完成、長年停止していた機能開発が再開でき、自動テストと日次レポートが完全自動化される
• レガシーコードベースでの成功の鍵：AIは「魔法」ではなく、適切な文脈提供と知識管理が成功を決定する