コードパターンがAIガイドラインを打ち負かす：Firefox拡張機能をChromeに移植する

r/ClaudeAIのある開発者が、AIコーディングエージェントを使ったクロスブラウザ拡張機能の構築に関する具体的なケーススタディを共有しました。プロジェクトは、人間が設計したアーキテクチャで構築されたFirefox拡張機能です。AIプロンプトを使ってChromeに移植する試みは2回失敗しました。根本原因は、プロンプトがトレーニングのギャップを補おうとしたものの、モデルバージョンに依存し、規模が大きくなると劣化したことでした。

解決策は、BrowserShellインターフェースを持つコアパッケージにブラウザ非依存のロジックを抽出することでした。各拡張機能は薄いシェルとなり、Chrome版の最終コードはFirefox版とわずか5行の意味のある違いしかありませんでした。重要な洞察は、コードパターンが抽象的なガイドラインより優れていることです。明確でテスト可能なコードベースにより、モデルはパターンを確実に複製でき、抽象的なプロンプトはモデルのトレーニング分布と戦うことになります。Humble Objectパターンは、境界コードを薄く保ちます。

実践的な教訓

• tabs、storage、messagingなどのAPIを抽象化するブラウザ非依存のコア（例：BrowserShell）を定義する。
• そのインターフェースをプラットフォーム固有のアダプター（例：FirefoxShell、ChromeShell）で実装する。
• ルールを列挙するのではなく、確立されたパターンに従うようにAIにプロンプトを与える。動作するアダプターを見せて、新しいブラウザ用にパターンを複製するよう依頼する。
• テスト容易性に焦点を当てる——コアロジックはブラウザAPIなしで単体テスト可能であるべき。

このアプローチはスケールします。なぜなら、パターンはモデルにとって決定論的ですが、ガイドラインは曖昧でモデルの更新によって変化するからです。AIを使ってコードをプラットフォーム間で移植するなら、モデルが最も得意とすること、つまりパターンマッチングを最大限に活かせるアーキテクチャに投資しましょう。