---

name: mobile-test description: "Flutter モバイルアプリのE2Eテストを Maestro で実行し、動画エビデンスを取得する。テスト完了には動画取得が必須。ログインが必要なテストは必ずテストアカウントを使用し、スキップ禁止。トリガー：モバイルテスト、Flutterテスト、アプリテスト、E2Eテスト、maestroテスト、テストを実行、動作確認"

モバイルテスト

Flutterアプリ（flutter_app/）のE2EテストをMaestroで実行し、動画エビデンスを取得する。

必須制約

1. 動画取得は必須

テスト完了の定義: .maestro/recordings/ に動画ファイル（.mp4）が生成されていること。

2. ログイン必須テストのスキップ禁止

認証が必要なテストをスキップしない。必ずテストアカウントでログインして実行する。

テストアカウント情報: references/test-account.md

テスト実行手順

ステップ1: 環境確認

cd <project-root>/flutter_app
flutter devices

ステップ2: テスト実行と動画取得

cd <project-root>
maestro record .maestro/flows/<flow-name>.yaml --output .maestro/recordings/<flow-name>.mp4

ステップ3: テスト完了確認

ls -la .maestro/recordings/

.mp4 が存在しなければテスト未完了。

新規フロー作成

フローテンプレート: references/flow-templates.md

チェックリスト

• .maestro/recordings/ に .mp4 が存在する
• ログイン必須テストを実行した
• すべてのアサーションが成功した

⚠️ よくある落とし穴

• 動画ファイルの生成確認を省略: maestro test だけでは動画は生成されない。必ず maestro record を使い、.maestro/recordings/ に .mp4 が存在することを確認する
• ログイン必須テストのスキップ: 認証が必要なフローを「面倒だから」とスキップすると、テストカバレッジに穴が開く。テストアカウント情報は references/test-account.md を参照して必ず実行する
• シミュレータ/実機の未起動: maestro record 実行前に flutter devices でデバイスが接続されていることを確認する。デバイスがないとエラーメッセージがわかりにくい