LinuxからFreeBSDへのWi-Fiドライバ移植におけるAI活用：事例研究

AIによる直接的なコード移植の試み

開発者は、Broadcom BCM4350 Wi-Fiチップを搭載した2016年製MacBook Proを持っていましたが、このチップはFreeBSDのネイティブサポートがありませんでした。一般的な回避策は、PCIパススルーを備えたLinux VMであるwifiboxを使用することです。代わりに、彼らはAIを使用してLinux brcmfmacドライバ（ISCライセンス）を直接FreeBSDに移植しようと試みました。

彼らはbrcmfmacサブツリーをクローンし、Claude CodeにFreeBSDで動作するように修正するよう依頼しました。特に、LinuxKPI（FreeBSDのLinuxカーネル互換レイヤー）を使用するための参考としてiwlwifiドライバを指摘しました。最初の試みでは、コンパイルはできるものの機能しないモジュールが生成されました。これは、テスト用VMに実際のハードウェアがなかったためです。

実際のPCIデバイスでテストしたところ、カーネルパニックが発生しました。Claude Codeは#ifdef __FreeBSD__ラッパーを追加し、FreeBSD固有のシムやコールバックを構築することでパニックを修正しようとしましたが、プロジェクトが「非常に複雑で煩雑になっている」と警告しました。結果として生成された差分は予想よりも大幅に大きく、ドライバは依然として機能しませんでした。

仕様書先行アプローチ

Armin RonacherのClaude OpusとPiエージェントの経験に触発され、開発者はアプローチを切り替えました。彼らのタスクが限定的である（1つのチップ、PCIのみ、Wi-Fiクライアントのみ）ことを認識し、新しいPiセッションを開始して、エージェントにBCM4350に焦点を当てたbrcmfmacドライバの動作に関する詳細な仕様書を作成するよう依頼しました。

彼らは読者を「クリーンルーム環境で仕様書を実装する任務を負った人々」と明示的に設定し、「ビットレベルまで」説明するよう求めました。エージェントは以下の11章からなる仕様書を生成しました：

• 00-overview.md
• 01-data-structures.md
• 02-bus-layer.md
• 03-protocol-layer.md
• 04-firmware-interface.md
• 05-event-handling.md
• 06-cfg80211-operations.md
• 07-initialization.md
• 08-data-path.md
• 09-firmware-commands.md
• 10-structures-reference.md

開発者は、AIが生成した仕様書は検証が必要であると指摘しています。なぜなら、「AIが書いたものを単純に信頼することはできない」からです。