エージェントにセットアップを任せる

面倒な部分はエージェントに任せられます

このリポジトリは、コーディング エージェントが読めるように書かれています。マップ ファイル (llms.txt)、ルール ファイル (AGENTS.md)、ファイルごとのメモリ ノート (.ai/)、タスク スキル (.agents/skills/) が付属しています。スタンドアロンの Mobile チェックアウトには prompts/ フォルダーが含まれていないため、既製のプロンプトはこのガイドに印刷されています。ファイルを開くのではなく、以下からコピーしてください。

入力を任せることは、チェックを省略することではありません。エージェントはリポジトリのあなたのコピー内で作業し、何をしたかを証拠とともに報告しなければなりません。以下のセクションでは、良いレポートがどのようなものかを示すので、あなたが結果を掌握したままでいられます。

このパスは Expo アプリと Web バックエンド (アカウントとデータを処理するサーバー) への接続をセットアップします。チェックアウトに apps/web も含まれている場合、エージェントはそのバックエンドをローカルで実行できます。Mobile 専用チェックアウトでは、提供された到達可能なバックエンド アドレスが必要です。

• 代わりに手動で Mobile アプリを実行する

最初に必要なもの

まず準備ガイドを完了してください：Node.js、Git、エディターのインストール、GitHub 招待の承認、supastack フォルダーのコンピューターへのダウンロード。エージェントはそのフォルダー内で作業するため、始める前に のすべての内容が引き続き適用されます。

コーディングエージェントとして機能するツールも必要です — AI コーディングエージェントを内蔵したエディター（AI IDE）、またはターミナルで動作するエージェント（エージェント CLI）です。現在のエージェント対応ツールならどれでも動作します。プロンプトには読むべきものと実行すべきものがすでに明記されているため、自分で指示を書く必要はありません。

最後に、プロンプトが求める 2 つのことを決めます: デバイスが到達できるバックエンド アドレス (ローカル バックエンドの場合はコンピューターの LAN アドレス、または提供された HTTPS アドレス) と、アプリを表示する場所 (電話の Expo Go、Mac の iOS シミュレーター、または Android エミュレーター)。

プロンプトをコピーし、2 か所を埋めて、貼り付ける

プロンプトは以下のコード ブロックです — ブロック全体を選択してコピーします。

2 つのプレースホルダーに選択が必要です。<API_URL> をデバイスが到達できるバックエンド アドレスに置き換えます — 同じ Wi-Fi 上のローカル バックエンドにはコンピューターの LAN アドレスにポート 3000、または提供された HTTPS アドレスを使います。<DEVICE: expo-go | simulator> を、実機の電話なら expo-go、インストール済みの iOS/Android シミュレーターなら simulator に置き換えます。番号付きステップは記述どおりに保ちます。

Set up this supastack Mobile checkout end to end and open the Expo app on **<DEVICE: expo-go | simulator>** against the backend at **<API_URL>**.
1. Read llms.txt, AGENTS.md and docs/agent-security.md before changing anything.
2. Run corepack pnpm install.
3. Create apps/mobile/.env.local from the names in .env.example: EXPO_PUBLIC_API_URL=<API_URL>, EXPO_PUBLIC_APP_SCHEME=supastack and EXPO_PUBLIC_MOBILE_PURCHASES_PROVIDER=off. Never invent a variable absent from .env.example.
4. If apps/web exists in this checkout, start it in a second terminal; otherwise verify <API_URL> answers from this computer and report its status.
5. Start Expo with corepack pnpm --filter @supastack/mobile start and report the QR preview or simulator launch with the real output.
6. Stop after any step fails twice and report the failing command and first error. Ask before deleting anything.

エージェントがプロンプトで行うこと

プロンプトはエージェントにマップ、ルール、セキュリティ チェックリストを示し、セットアップを順番に進め、各フェーズを証明するよう指示します。平易に言うと、エージェントは:

• 何かに触れる前に、リポジトリのマップ（llms.txt）、プロジェクトのルール（AGENTS.md）、認証情報の取り扱いルール（docs/agent-security.md）を読みます。
• .env.example の名前だけから apps/mobile/.env.local を作成し、提供した API アドレスとスキームを設定します — エージェントはサンプル ファイルにない EXPO_PUBLIC_ 設定を決して作りません。
• バックエンドが指定アドレスで応答することを確認します — このチェックアウトに apps/web フォルダーが存在する場合のみ自分で起動します — 存在しないサーバーを仮定しません。
• 依存関係をインストールして Expo 開発サーバーを起動し、QR プレビューまたはシミュレーター起動を実際の出力とともに報告します。
• 同じステップが 2 回失敗したら停止して報告します — 失敗を回避したり、確認せずに何かを削除したりしません。

エージェントのレポートで確認すること

良いレポートは主張ではなく証拠を示します。各 PASS の背後に、応答するバックエンド URL、完了した依存関係インストール、Expo サーバー出力があるか確認します — 「すべて動作する」のような文ではなく。

プロンプトはエージェントに、同じステップが 2 回失敗したら停止して報告すること (失敗を回避しないこと)、および破壊的な操作の前に確認することを指示します。エージェントが繰り返し失敗した後も即興で進め続ける場合は停止し、最初のエラーをトラブルシューティング ガイドに持ち込みます。

絶対に現れてはいけないものが 2 つあります：エラーを黙らせるためにオフにされたセキュリティ機能と、チャットやレポートに出力されたパスワードやキーなどのシークレット値です。どちらかを見かけたら、その実行は失敗として扱ってください。

プレビューと実際のサインインを頭の中で分けてください。QR プレビューの成功は画面が表示されることだけを意味します — 実アカウントにはバックエンドのデータベースが必要で、実際の購入には EAS 開発ビルドが必要です。「プレビューが開いた」はまだ「アカウントが動作する」ではありません。

手動で行いたい場合

エージェントが実行するすべてのステップは、以下の手動ガイドに記載されています — 同じコマンド、同じチェックを自分のペースで。

• 5 分で Mobile アプリを実行する
• 完全なローカル セットアップを読む
• セットアップの失敗を修正する