はじめに：AIエージェント開発の「理想と現実」
昨今、Claude CodeやDevinなどを筆頭に、AIエージェントに自律的にコードを書かせ、ターミナルを操作させる「エージェント駆動開発（Agent Orchestration）」が大きなトレンドになっています。
しかし、実務に投入するとすぐに以下の壁にぶつかります。
- API課金の爆発: 自律型エージェントは背後で大量のプロンプトチェーンを繰り返すため、APIコストが驚くほど早く溶ける
- ハルシネーションによる品質崩壊: コンテキストが長くなるにつれ、AIが勝手に不要なライブラリをインポートしたり、過去のバグを再発させたりする
本記事では、APIコストに依存せず、Webブラウザ上のLLM（Gemini）とローカル環境（Antigravity）を連携させ、厳格なルール（SSOT）を敷くことでこれらの課題を解決した「ハイブリッド型エージェント開発体制」のノウハウを公開します。
1. Quota-Aware Hybrid Strategy（クオータ最適化戦略）
APIの従量課金に怯えていては、AIの最大の強みである「試行錯誤の速度」が死んでしまいます。そこで我々は、処理をクラウドとローカルで物理的に分離しました。
-
思考・生成エンジン（Gemini Web版）
要件定義、アーキテクチャ設計、コード生成といった「重い思考処理」はすべてWeb版のGemini（Pro/Advanced等）に任せます。
これにより、長大なコンテキストを読み込ませても「追加のAPI課金はゼロ」という、実質的なゼロ・クオータ環境を実現します。 -
実行・検証エンジン（ローカル / Antigravity）
生成されたコードの実行、環境依存のデバッグ、ビルド作業はローカル環境（Antigravityなど）で行います。
この「最強の思考エンジン（Web）に設計図を描かせ、手元（Local）で確実に実行する」体制こそが、個人開発におけるコストパフォーマンスの正解です。
2. Strict SSOT：ハルシネーションを「物理的に」封じる
Web版のAIエージェントを活用する際、セッションが切り替わった瞬間に発生するハルシネーションをどう防ぐかが鍵になります。
我々はプロジェクトの絶対的な法律となるドキュメント 「SSOT（Single Source of Truth）」 を作成し、すべてのエージェントに毎回必ずこれを読み込ませる「絶対防壁」を構築しています。
具体例：AIの「余計なお世話」を封殺するプロトコル
AIは時に「気を利かせて」実務上致命的なコードを書きます。例えば、Pandasによる勝手な型変換（.0問題）などです。
これに対し、我々は 「The Data Purity Protocol」 をSSOTに定義し、AIの行動を縛っています。
※Pandasが数値に勝手に小数を付けてしまい、会計ソフトでエラーが出る等の「技術的な罠」の詳細は、以前の記事『AIにPythonを書かせて陥る「Pandasの罠」と「UIの壁」を突破するアーキテクチャ思考』で詳しく解説しています。
SSOTを介することで、AIは「勝手な解釈」を禁じられ、人間が定めたドメイン知識の範囲内で最高精度のコードを出力するようになります。
3. Agent Orchestration（役割の細分化と監査体制）
「なんでもできる1つの万能AI」ではなく、役割を完全に細分化したエージェント同士で監査し合う体制を構築しています。
以前、『週末開発の限界を突破する。AIを「チャットボット」から「最強の開発チーム」に変えるMarkdownプロトコル術』という記事を書きましたが、現在はこれをさらに進化させ、以下の4つの専門エージェントをオーケストレーションしています。
- The Architect（司令塔）: 要件をSSOTに基づきシステム定義書へ落とし込む
- Code Architect（実装）: 開発環境（WASM等）の制約を遵守したコードを出力する
- Quality Gatekeeper（監査）: コードがSSOTに違反していないかレビューする
- Biz Partner（戦略）: 技術的強みをベネフィットへ翻訳し、ドキュメント化する
「Canvas機能」を意図的に排除する理由
最新のLLMにはコードを直接編集するCanvas（Artifacts）機能がありますが、我々はこれを「意図的に排除」しています。
理由は、「サイレントな書き換え（破壊）」を防ぐためです。明示的にコードブロックとして出力させ、Git等を用いて人間が厳密に差分（Diff）を管理することで、高い品質を担保しています。
まとめ：AI開発の主導権は「人間」にある
エージェント駆動開発は、ツールに丸投げすることではありません。
- クラウドとローカルの役割を分離する（クオータ戦略）
- 厳密なSSOTでAIの暴走を縛る
- 明示的な監査プロセスを挟む
これからのエンジニアに求められるのは、コードを書くこと自体ではなく、 「AIエージェントという優秀な部下たちを束ねるルール（SOP/SSOT）を設計し、指揮を執るオーケストレーション能力」 です。
宣伝： この体制で開発した「維持費0円・完全オフライン」の銀行CSV変換ツールをココナラで公開中です。
【銀行CSVを会計用へ変換するアプリ（WASM-FinCSV Transformer）】