Deixe um agente fazer a configuração

Você pode delegar a parte chata

Este repositório foi escrito para que um agente de codificação possa lê-lo. Ele traz um arquivo de mapa (llms.txt), um arquivo de regras (AGENTS.md), notas de memória por arquivo (.ai/) e skills de tarefas (.agents/skills/). O checkout Mobile independente não inclui a pasta prompts/, portanto o prompt pronto está impresso neste guia — copie-o abaixo em vez de abrir um arquivo.

Delegar a digitação não significa pular as verificações. O agente trabalha dentro da sua cópia do repositório e precisa relatar o que fez com evidências. As seções abaixo mostram como é um bom relatório, para que você continue no comando do resultado.

Este caminho configura o aplicativo Expo e sua conexão com o backend Web — o servidor que gerencia contas e dados. Se o seu checkout também contém apps/web, o agente pode executar esse backend localmente; um checkout somente Mobile precisa do endereço de backend acessível que lhe foi fornecido.

• Execute o aplicativo Mobile manualmente em vez disso

O que você precisa primeiro

Conclua primeiro o guia de preparação: Node.js, Git e um editor instalados, o convite do GitHub aceito e a pasta supastack baixada no seu computador. O agente trabalha dentro dessa pasta, então tudo em Antes de começar continua valendo.

Você também precisa de uma ferramenta que atue como agente de codificação — um editor com um agente de codificação de IA embutido (uma IDE de IA) ou um agente que roda no seu terminal (uma CLI de agente). Qualquer ferramenta atual com agente funciona; o prompt já detalha o que ele deve ler e executar, então você não precisa escrever as instruções.

Por fim, decida as duas coisas que o prompt pede: o endereço do backend que seu dispositivo consegue alcançar — um endereço LAN do seu computador para um backend local ou seu endereço HTTPS fornecido — e onde você vai visualizar o aplicativo: Expo Go num telefone, um simulador de iOS num Mac ou um emulador Android.

Copie o prompt, preencha duas lacunas, cole

O prompt é o bloco de código abaixo — selecione e copie o bloco inteiro.

Dois placeholders precisam das suas escolhas. Substitua <API_URL> pelo endereço do backend que seu dispositivo consegue alcançar — o endereço LAN do seu computador mais a porta 3000 para um backend local na mesma rede Wi-Fi, ou seu endereço HTTPS fornecido. Substitua <DEVICE: expo-go | simulator> por expo-go para um telefone físico ou simulator para um simulador iOS/Android instalado. As etapas numeradas permanecem exatamente como escritas.

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.

O que o agente faz com o prompt

O prompt aponta o agente para o mapa, as regras e a checklist de segurança, e depois manda ele trabalhar na configuração em ordem e provar cada fase. Em termos simples, o agente:

• Lê o mapa do repositório (llms.txt), as regras do projeto (AGENTS.md) e as regras de tratamento de credenciais (docs/agent-security.md) antes de tocar em qualquer coisa.
• Cria apps/mobile/.env.local somente a partir dos nomes de .env.example, com o endereço de API e o esquema que você forneceu — o agente nunca inventa uma configuração EXPO_PUBLIC_ ausente do arquivo de exemplo.
• Verifica se o backend responde no seu endereço — iniciando o apps/web ele mesmo apenas quando essa pasta existe neste checkout — em vez de assumir um servidor que não existe.
• Instala dependências e inicia o servidor de desenvolvimento Expo, depois relata a pré-visualização QR ou a inicialização do simulador com a saída real.
• Para e relata depois que a mesma etapa falha duas vezes — ele não contorna uma falha nem exclui nada sem perguntar.

O que você verifica no relatório do agente

Um bom relatório mostra evidências, não afirmações. Procure a URL do backend respondendo, a instalação de dependências concluída e a saída do servidor Expo atrás de cada PASS — não uma frase como 'tudo funciona'.

O prompt diz ao agente para parar e relatar depois que a mesma etapa falhar duas vezes — não para contornar a falha — e para perguntar antes de qualquer coisa destrutiva. Se o seu agente continuar improvisando após falhas repetidas, pare-o e leve o primeiro erro ao guia de solução de problemas.

Duas coisas nunca devem aparecer: um recurso de segurança desligado para silenciar um erro e um valor secreto, como uma senha ou chave, impresso no chat ou no relatório. Se vir qualquer uma delas, trate a execução como falha.

Mantenha separadas na sua mente a pré-visualização e o login real. Uma pré-visualização QR bem-sucedida mostra apenas telas — contas reais precisam do banco de dados do backend, e compras reais precisam de um build de desenvolvimento EAS. 'A pré-visualização abriu' ainda não é 'as contas funcionam'.

Se você preferir fazer à mão

Cada etapa que o agente executa está escrita nos guias manuais abaixo — os mesmos comandos, as mesmas verificações, no seu ritmo.

• Execute o aplicativo Mobile em 5 minutos
• Leia a configuração local completa
• Corrija uma falha de configuração