Позвольте агенту выполнить настройку

Рутинную часть можно делегировать

Этот репозиторий написан так, чтобы агент кодирования мог его прочитать. Он содержит файл-карту (llms.txt), файл правил (AGENTS.md), заметки памяти для каждого файла (.ai/) и навыки задач (.agents/skills/). Отдельный checkout Mobile не включает папку prompts/, поэтому готовый промпт напечатан в этом руководстве — скопируйте его ниже вместо открытия файла.

Делегировать набор текста не значит пропустить проверки. Агент работает внутри вашей копии репозитория и должен отчитываться о выполненном с доказательствами. Разделы ниже показывают, как выглядит хороший отчёт, чтобы результат оставался под вашим контролем.

Этот путь настраивает приложение Expo и его подключение к Web-бэкенду — серверу, обрабатывающему аккаунты и данные. Если ваш checkout также содержит apps/web, агент может запустить этот бэкенд локально; checkout только Mobile нуждается в предоставленном вам доступном адресе бэкенда.

• Вместо этого запустите приложение Mobile вручную

Что нужно сначала

Сначала пройдите подготовительное руководство: установлены Node.js, Git и редактор, принято приглашение GitHub, а папка supastack загружена на ваш компьютер. Агент работает внутри этой папки, поэтому всё из Прежде чем начать по-прежнему применимо.

Вам также понадобится инструмент, который может выступать кодинг-агентом — редактор со встроенным AI-агентом для кодирования (AI IDE) или агент, работающий в вашем терминале (агентный CLI). Подойдёт любой современный инструмент с возможностями агента; промпт уже описывает, что он должен прочитать и запустить, поэтому писать инструкции самостоятельно не нужно.

Наконец, определите две вещи, которые запрашивает промпт: адрес бэкенда, доступный вашему устройству — LAN-адрес вашего компьютера для локального бэкенда или предоставленный вам адрес HTTPS, — и где вы будете смотреть приложение: Expo Go на телефоне, симулятор iOS на Mac или эмулятор Android.

Скопируйте промпт, заполните два поля, вставьте

Промпт — это блок кода ниже — выделите и скопируйте блок целиком.

Два плейсхолдера требуют вашего выбора. Замените <API_URL> адресом бэкенда, доступным вашему устройству — LAN-адрес вашего компьютера с портом 3000 для локального бэкенда в той же сети Wi-Fi, или предоставленный вам адрес HTTPS. Замените <DEVICE: expo-go | simulator> на expo-go для физического телефона или simulator для установленного симулятора iOS/Android. Нумерованные шаги остаются точно как написано.

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), прежде чем что-либо трогать.
• Создаёт apps/mobile/.env.local только из имён в .env.example, с указанным вами адресом API и схемой — агент никогда не выдумывает настройку EXPO_PUBLIC_, которой нет в файле-примере.
• Проверяет, что бэкенд отвечает по вашему адресу — запуская apps/web самостоятельно, только если эта папка существует в данном checkout, — вместо предположения о сервере, которого нет.
• Устанавливает зависимости и запускает сервер разработки Expo, затем сообщает о QR-предпросмотре или запуске симулятора с реальным выводом.
• Останавливается и сообщает после двух неудач одного и того же шага — он не обходит сбой и не удаляет что-либо без запроса.

Что проверить в отчёте агента

Хороший отчёт показывает доказательства, а не утверждения. Ищите за каждым PASS отвечающий URL бэкенда, завершённую установку зависимостей и вывод сервера Expo — а не фразу вроде «всё работает».

Промпт велит агенту остановиться и сообщить после двух неудач одного и того же шага — не обходить сбой — и спросить вас перед чем-либо разрушительным. Если ваш агент продолжает импровизировать после повторных сбоев, остановите его и обратитесь к руководству по устранению неполадок с первой ошибкой.

Две вещи никогда не должны появляться: отключённая функция безопасности ради подавления ошибки и секретное значение, такое как пароль или ключ, напечатанное в чате или отчёте. Если вы видите что-либо из этого, считайте запуск проваленным.

Держите в уме разницу между предпросмотром и настоящим входом. Успешный QR-предпросмотр показывает только экраны — настоящим аккаунтам нужна база данных бэкенда, а настоящим покупкам нужна сборка разработки EAS. «Предпросмотр открылся» — это ещё не «аккаунты работают».

Если вы предпочитаете сделать это вручную

Каждый шаг, который выполняет агент, расписан в руководствах ниже — те же команды, те же проверки, в вашем темпе.

• Запустите приложение Mobile за 5 минут
• Прочитайте полную локальную настройку
• Исправьте сбой настройки