AI駆動開発の次のステージを検証するプロジェクトです。
Claude Code + MCP (Maestro / Dart) を組み合わせ、AIが設計・実装・動作確認・セルフレビューまで自律的に行います。
人間 ←→ AI
↑
毎ステップで確認・判断
実装ごとに人間がコードレビュー、動作確認も人間が目視。 AIは「手を動かす人」、人間は「常に横で見ている人」。
問題: 人間の時間的コストが高く、AIの生産性を活かしきれない。
人間(リードエンジニア)
↓ タスク依頼
AI(チームメンバー)
├── 実装
├── 動作確認(E2Eテスト、エラー確認)
├── セルフレビュー(複数モデルで検証)
└── 完成度を高めてから報告
↓
人間(最終レビュー・承認)
変化: 人間は「最終確認者」になり、AIが自律的に品質を担保。
ジュニア:
1. 実装
2. 自分で動作確認
3. テスト通るか確認
4. セルフレビュー(明らかな問題を潰す)
5. 「確認しました、レビューお願いします」
↓
シニア: 本質的な部分だけレビュー
これができて初めて、シニア1人で複数のジュニアを見られる。 AIエージェントも同じ。 自己検証できなければ、人間がボトルネックになる。
┌─ AI Agent A(機能実装)
│ └─ セルフテスト・レビュー
人間(リード)──────┼─ AI Agent B(バグ修正)
│ └─ セルフテスト・レビュー
└─ AI Agent C(リファクタ)
└─ セルフテスト・レビュー
AIエージェントを並列稼働させるには、人間がボトルネックにならない仕組みが必須。 このプロジェクトはその基盤技術の実証。
このリポジトリは、AI(Claude Code)が以下をすべて自律的に実行することを実証しています:
- Flutter アプリの設計・実装
- E2E テストによる動作確認
- セルフレビュー(Gemini CLI + Claude subagent)
- Git コミット・プッシュ
人間が行うのは指示と最終レビューだけ。
「画像添付機能を実装して」という一言から、Claude Code が:
- 設計を提案し、ユーザーに確認
- 必要なパッケージを追加
- モデル・リポジトリ・プロバイダーを実装
- UI ウィジェットを作成
- エミュレーターでアプリを起動
- 実際に操作して動作確認
- スクリーンショットで結果を報告
┌─────────────────────────────────────────────────────────────┐
│ Claude Code │
├─────────────────────────────────────────────────────────────┤
│ Plan Mode │ Implementation │ E2E Testing │
│ ・設計 │ ・コード生成 │ ・アプリ起動 │
│ ・質問 │ ・ファイル編集 │ ・UI操作 │
│ ・承認取得 │ ・進捗管理 │ ・スクリーンショット │
└───────┬───────┴────────┬─────────┴───────────┬─────────────┘
│ │ │
▼ ▼ ▼
AskUserQuestion Edit/Write MCP Servers
│
┌─────────────────────────┼─────────────────────────┐
│ │ │
▼ ▼ ▼
┌──────────┐ ┌──────────┐ ┌──────────┐
│ Dart MCP │ │ Maestro │ │ Flutter │
│ Server │ │ MCP │ │ App │
└────┬─────┘ └────┬─────┘ └──────────┘
│ │ ▲
│ ・アプリ起動 │ ・スクリーンショット │
│ ・ホットリロード │ ・タップ操作 │
│ ・ウィジェットツリー │ ・テキスト入力 │
│ ・エラー取得 │ ・view hierarchy │
│ │ │
└────────────────────────┴─────────────────────────┘
launch_app: Flutter アプリの起動connect_dart_tooling_daemon: DTD 接続hot_reload/hot_restart: コード変更の即時反映get_widget_tree: ウィジェット構造の取得get_runtime_errors: エラー情報の取得
take_screenshot: スクリーンショット取得inspect_view_hierarchy: UI 要素一覧(軽量)tap_on: テキスト/ID 指定でタップinput_text: テキスト入力run_flow: Maestro フロー実行
モバイル自動化MCPには以下の3つがあります:
- Maestro MCP - Maestro E2Eフレームワークベース
- Mobile MCP - mobilecli経由の汎用ツール
- Marionette MCP - Flutter専用(Patrol作者製)
| 項目 | Maestro MCP | Mobile MCP | Marionette MCP |
|---|---|---|---|
| 対象 | iOS/Android | iOS/Android | Flutter専用 |
| 方式 | パッケージインストール | mobilecli | VM Service直接 |
| 通信 | gRPC (port 7001) | JSON-RPC / CLI | Dart VM Protocol |
| 要素取得 | Accessibility API | Accessibility API | Widget Tree |
| 機能 | Maestro | Mobile | Marionette |
|---|---|---|---|
| Key/ID指定タップ | ✅ | ❌ | ✅ |
| テキスト指定タップ | ✅ | ❌ | ✅ |
| Type指定タップ | ✅ | ❌ | ✅ |
| 座標タップ | △ | ✅ | ✅ |
| テキスト入力 | ✅ | ✅ | |
| ホットリロード | ❌ | ❌ | ✅ |
| デバイスボタン | ❌ | ✅ | ❌ |
| アプリ管理 | ❌ | ✅ | ❌ |
| YAMLフロー | ✅ | ❌ | ❌ |
| アプリ変更 | 不要 | 不要 | 必要 |
| Platform | Maestro | Mobile | Marionette |
|---|---|---|---|
| iOS | ✅ | ✅ | ✅ |
| Android | ✅ | ✅ | ✅ |
| macOS | ❌ | ❌ | ✅ |
| Windows | ❌ | ❌ | ✅ |
| Linux | ❌ | ❌ | ✅ |
| Web | ❌ | ❌ |
Note: Marionette MCPはVM Service経由で動作するため、Flutterが動く全プラットフォームに対応。 デスクトップアプリの動作確認ができるのは Marionette MCPだけ の強み。
Maestro MCP
- E2Eシナリオ(YAML)と同じセレクタ戦略
Semantics.identifierでID指定タップ- gRPC常時接続で低レイテンシ
Mobile MCP (v0.0.41)
- セットアップ不要、Driver起動問題なし
- デバイスボタン、アプリ管理、URL操作が可能
- identifier検出が改善(0.0.41)
Marionette MCP
- VM Service直接接続 = 軽量・高速
- ホットリロード内蔵
enter_textにはValueKeyが必須
MCPツールを有効にすると、ツール定義がコンテキストを消費します:
| MCP | ツール数 | トークン数 |
|---|---|---|
| dart-mcp | 24 | 約6,300 |
| maestro | 13 | 約2,100 |
| mobile-mcp | 17 | 約2,900 |
| marionette | 9 | 約1,300 |
Note: Marionette MCPは最軽量。モバイル自動化3つ(maestro + mobile + marionette)で約6,300 tokens。 必要に応じて使わないMCPを無効化するとコンテキスト節約可能。
どのMCPも効果的に使うにはアプリ側の対応が有効:
| MCP | 推奨対応 |
|---|---|
| Maestro / Mobile | Semantics.identifier 追加 |
| Marionette | ValueKey 追加 + MarionetteBinding 初期化 |
| 用途 | 推奨 | 理由 |
|---|---|---|
| モバイルE2E | Maestro | YAMLシナリオ共有、ID指定タップ |
| モバイル汎用 | Mobile | セットアップ不要、デバイス操作 |
| デスクトップ | Marionette | 唯一の選択肢 |
| クロスプラットフォーム | Marionette | 全プラットフォーム一貫テスト |
メイン: Maestro MCP
└─ UI操作、E2Eテスト、動作確認(モバイル)
フォールバック: Mobile MCP
└─ デバイスボタン、アプリ管理、トラブル時
補助: Marionette MCP
└─ デスクトップ動作確認、ホットリロード連携
結論:
- モバイル専用プロジェクト → Maestro MCP(YAMLシナリオとの知見共有)
- デスクトップ含むプロジェクト → Marionette MCP を検討する価値あり
Maestro MCPは Android 上で dev.mobile.maestro パッケージ(Maestro Driver)を起動して通信しますが、
自動起動に失敗する場合があります。
症状:
UNAVAILABLE: io exception
Connection refused: localhost/[0:0:0:0:0:0:0:1]:7001
確認方法:
# Driver がインストールされているか確認
adb shell pm list instrumentation | grep maestro
# → instrumentation:dev.mobile.maestro.test/... が表示されればOK
# Driver プロセスが動いているか確認
adb shell ps -A | grep maestro
# → 何も表示されなければ Driver が起動していない解決方法:
# Maestro Driver を手動起動
adb shell am instrument -w -e debug false \
dev.mobile.maestro.test/androidx.test.runner.AndroidJUnitRunner &
# ポート 7001 が LISTEN しているか確認
adb shell netstat -tlnp | grep 7001補足:
maestroCLI で作成した AVD(例:Maestro_Pixel_6_API_30)には Driver がプリインストールされている- 新規 AVD では最初の Maestro テスト実行時に自動インストールされるが、起動は手動が必要な場合がある
- Gemini CLI: 外部モデル視点でのレビュー
- Claude subagent: 別コンテキストでのレビュー
- 観点: コード品質、バグ・エラー、設計パターン
- 判定: PASS / MINOR / FAIL → 問題があれば自己修正
Claude Code が実行する開発フロー:
1. Plan Mode(設計)
└─ 不明点をユーザーに質問 → 計画作成 → 承認取得
2. Implementation(実装)
└─ TodoWrite でタスク管理 → コード生成・編集
3. E2E Testing(動作確認)
└─ アプリ起動 → UI操作 → 結果確認
4. Self Review(セルフレビュー)
└─ Gemini CLI + Claude subagent でデュアルレビュー
└─ 問題があれば自己修正 → 再レビュー
5. Git Operations
└─ コミット → プッシュ → 人間に最終レビュー依頼
✅ 推奨: hierarchy → 操作 → hierarchy → ... → screenshot(最終確認)
❌ 非効率: screenshot → 操作 → screenshot → ...
inspect_view_hierarchy は軽量で高速。スクリーンショットは視覚確認が必要な時のみ。
/inspect-widget コマンドを使って、シミュレーターで選択した Widget を起点に修正を行うワークフロー:
1. /inspect-widget 実行
└─ Dart MCP: Widget選択モード有効化
└─ ユーザー: シミュレーターでWidgetをタップ選択
2. Widget 調査
└─ Dart MCP: get_selected_widget でWidget情報取得
└─ ソースコード位置・プロパティを確認
3. 修正指示 → Plan Mode
└─ ユーザー: 「3状態にしたい」等の修正指示
└─ Claude: 関連コード調査 → 実装計画作成
4. 実装
└─ TodoWrite でタスク管理
└─ コード編集 → hot_reload で即時反映
5. 動作確認
└─ Maestro MCP: inspect_view_hierarchy で状態確認
└─ Maestro MCP: tap_on で操作テスト
└─ Maestro MCP: take_screenshot で最終確認
実例: 完了フィルターの3状態化
User: (シミュレーターでフィルターアイコンを選択)
User: 「3状態にしたい - すべて/完了済み/未完了」
Claude:
1. get_selected_widget → todo_list_screen.dart:92 の Icon 特定
2. Plan Mode → CompletionFilter enum 設計
3. 実装 → 6ファイル修正
4. Maestro で3状態サイクルを自動テスト
5. スクリーンショットで報告
この流れにより、「ここを直したい」→ 選択 → 修正 → 確認 が一気通貫で完了します。
検証用に作成した TODO アプリ:
- State Management: Riverpod (AsyncNotifier)
- Persistence: SharedPreferences
- Features:
- タスクの CRUD
- カテゴリ分類
- 期限設定
- 画像添付
- 検索・フィルター
E2Eテスト用にエミュレーター/シミュレーターを最適化するスクリプトを提供しています。
| スクリプト | 説明 |
|---|---|
setup_e2e_emulator.sh |
E2E専用の軽量AVD作成(不要なセンサー無効化) |
create_snapshot.sh |
起動済み状態のスナップショット作成(高速起動用) |
start_emulator.sh |
エミュレーター起動(dev/ci/coldモード切替) |
ios_simulator.sh |
iOSシミュレーター管理(ステータスバー固定) |
start_e2e_env.sh |
統合起動スクリプト |
# 開発モード(GUI表示、GPU=auto)
./scripts/start_emulator.sh dev
# CIモード(ヘッドレス、GPU=swiftshader)
./scripts/start_emulator.sh ci
# コールドブート(スナップショット不使用)
./scripts/start_emulator.sh cold| 指標 | dev モード | ci モード |
|---|---|---|
| CPU使用率 | 約15% | 約3.5% |
| 起動時間(スナップショット) | 約3秒 | 約3秒 |
| 起動時間(コールドブート) | 約13秒 | 約13秒 |
注意: dev/ci モードでGPUモードが異なるため、スナップショットの互換性がありません。 モード別に専用AVDを用意するか、モード変更時はコールドブートを使用してください。
- Flutter SDK
- Android Emulator / iOS Simulator
- Dart MCP Server
- Maestro MCP
- Mobile MCP (フォールバック用)
{
"mcpServers": {
"dart-mcp": {
"command": "dart",
"args": ["run", "dart_mcp_server"],
"cwd": "/path/to/dart_mcp_server"
},
"maestro": {
"command": "npx",
"args": ["-y", "@anthropic/maestro-mcp@latest"]
}
}
}MIT