動作していないのに「動いた」と報告していた AI エージェントの修正方法

Seeed SenseCAP Indicator D1（ESP32-S3 + タッチスクリーン）を改造し、Claude Code / Codex エージェントの状態をリアルタイムで可視化する物理ディスプレイを構築した事例。複数セッションの「考え中」「ツール実行中」「入力待ち」「完了」といった状態をアニメーション表示し、アイドル時にはローカル LLM が一言つぶやく「AI相棒」デバイス。フレームではなく意味的ステータスのみを送信する設計により帯域を最小化。

Bun のプロジェクトは 64 並列の Claude Code エージェントを使い、言語に依存しない 6 万個以上のテストを「神託」として品質を保証した。しかし実行中に個々のエージェントが発見したバグや仕様は人間が手作業で仕様書に反映していたため、同じ罠に複数エージェントが何度もハマり API コスト増大を招いていた。本記事は、エージェントの「発見」を構造化ログで共有し、システム的に仕様書に昇格させるアーキテクチャを提案する。

複数のエージェントを組み合わせて動かす際の実行戦略を、基本4つ（単一・司令塔・並列・自己批評）と応用8つ（逐次・反復・階層・動的選択・委員会・フォールバック・コスト意識・並列剪定）の12パターンに整理。各戦略の仕組み・使いどころ・注意点を解説し、精度・速度・コスト・デバッグ性の課題に応じた選択フローを提示。

Electron製のAIコーディングエージェント AMA-teras で、自己進化するエージェントに運営権限を委譲しつつ、不正な発信を構造的に不可能にする設計を実装。外部への発信を「岩戸ゲート」と呼ぶ承認ダイアログで必須化し、executor を WeakMap に封印することで、バイパス経路そのものをコードから消去している。