ESP32のファームウェア開発にAIを使っているMakerなら、同じ問題に何度も直面したことがあるはずだ。セッションをまたぐと文脈が消える。ピン番号を誤解する。コードはコンパイルできるが動かない。同じ「Guru Meditation」エラーを何時間もかけて調べ直す——。
GitHubで公開された「esp32-claude-workbench」は、そうした場当たり的なAIプロンプティングを廃止するためのプロジェクトだ。Claude Codeをベースに、ESP32ファームウェア開発を構造化されたワークフローとして管理する仕組みを提供する。
中心となるのは「ミッションファイル」という概念だ。新機能や修正を始める際にMarkdownファイルを作成し、目標・対象ボード・制約・受け入れ基準・現在のステータスを記録する。このファイルが複数セッションをまたぐ「プロジェクトの記憶」として機能し、Claude Codeはミッションファイルを読んで前回の続きから作業を再開できる。
コード変更の前には「実装コントラクト」を生成する設計になっている。変更対象ファイル・リスク評価・テスト計画をコード記述前に合意するフローで、根拠のないAI生成コードが混入するのを防ぐ。/contractスラッシュコマンドで呼び出せる。
ESP32固有の問題にも対処している。Wi-Fi使用時のADC2ピン競合、ストラッピングピンの制約、FreeRTOSタスクのスタックサイズ不足などを自動検出するPython製CLIツール（scan-pins、check-stacks、analyze-sdkconfig）が付属する。デバッグプレイブックとしてGuru Meditation、Wi-Fiドロップ、I2C/SPI立ち上げ、OTAアップデート失敗など10種類の手順書も含まれる。
テスト戦略はハードウェアなしで始められる5層構成だ。実機なしでもリポジトリロジックとホスト側ロジックの検証（pytest）が可能で、148以上のテストが付属する。MCPサーバーとして登録するとESP32の技術参照マニュアルやデータシートをローカルのFAISSインデックスで検索できる機能も備える。
ライセンスはMITで、スキル定義・プレイブック・テンプレートの追加も歓迎されている。
