> ## Documentation Index > Fetch the complete documentation index at: https://supastack.dev/llms.txt > Use this file to discover all available pages before exploring further. > For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt # Deixe um agente fazer a configuração Cole um prompt pronto em um agente de codificação, deixe-o executar a configuração da Web no seu computador e verifique o relatório que ele escreve sobre cada etapa. ## Você pode delegar a parte chata Este repositório foi escrito para que um agente de codificação consiga lê-lo. Ele traz um arquivo de mapa (`llms.txt`), um arquivo de regras (`AGENTS.md`), um runbook passo a passo (`docs/agent-setup.md`) e um prompt pronto (`prompts/agent-setup.md`). Em vez de aprender cada comando de configuração, você cola um prompt e o agente segue o runbook no seu computador. 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. Um limite honesto: este caminho automatizado configura o app Web e o seu back-end — o servidor que cuida de contas e dados. O prompt e o runbook vêm com o repositório Web e com o monorepo Todas as Plataformas. Checkouts somente Mobile ou somente Desktop trazem, em vez disso, o seu próprio `llms.txt` com escopo próprio e os guias de configuração da plataforma. [Configure o app Mobile localmente](https://supastack.dev/pt/docs/mobile/local-setup.md) [Execute o app Desktop](https://supastack.dev/pt/docs/desktop/run.md) ## 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](https://supastack.dev/pt/docs/web/before-you-start.md) 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, você precisa de uma de duas formas de rodar o app: Node.js 22 ou mais recente instalado no seu computador — o caminho que o guia de preparação configurou — ou uma ferramenta de contêineres como Docker ou Podman, que roda o app dentro de contêineres e não precisa de Node.js instalado. Você escolhe uma dentro do prompt e o agente a segue. ## Copie o prompt, preencha duas lacunas, cole Abra `prompts/agent-setup.md` no editor — ele fica na pasta `prompts` no nível superior da pasta supastack, ao lado de `llms.txt`. Selecione todo o texto e copie-o. Dois placeholders precisam das suas escolhas. Substitua `` por uma das opções docker, podman ou host — host roda o app diretamente no seu computador usando o Node.js que você instalou; docker ou podman o executa dentro de contêineres. Substitua `` por onde o app deve terminar — local-only o executa apenas neste computador e não implanta nada, que é a escolha certa para uma primeira olhada. Cole o texto editado no chat do agente e envie. A primeira linha preenchida abaixo mostra as escolhas docker e local-only; as etapas numeradas abaixo dessa linha ficam exatamente como o arquivo traz. ``` Stand up this supastack checkout end to end for **docker** and deploy it to **local-only**. ``` ## O que o agente faz com o prompt O prompt aponta o agente para o runbook e para as regras de segurança, e manda ele trabalhar nelas 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 os arquivos de configuração `.env` com `node scripts/setup-env.mjs`. O auxiliar copia apenas de `.env.example`, então o agente nunca inventa nomes de configuração, e preserva os segredos que você já tem em vez de sobrescrevê-los. - Inicia o Postgres — o banco de dados onde o app guarda contas e registros — e o próprio app, como contêineres no caminho docker ou podman, ou com comandos no seu computador no caminho host. - Executa as migrações de banco de dados — os comandos que criam as tabelas do app — antes do primeiro login real, porque uma conta criada antes de as tabelas existirem é uma conta quebrada. - Verifica cada fase em um ponto de verificação e termina com um relatório marcando cada verificação como PASS, FAIL, BLOCKED ou NOT RUN, com a saída que a comprova. ## O que você verifica no relatório do agente Um bom relatório mostra evidências, não afirmações. Procure a resposta real do health check e a saída dos comandos por trás de cada PASS — não uma frase como 'está tudo funcionando'. O prompt manda o agente parar e relatar depois que a mesma etapa falha duas vezes — não contornar a falha — e perguntar a você antes de qualquer coisa destrutiva, como apagar um banco de dados. Se o seu agente continuar improvisando após falhas repetidas, pare-o e leve o primeiro erro ao [guia de resolução de problemas](https://supastack.dev/pt/docs/web/troubleshooting.md). 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 a demo e um login real separados na sua cabeça. O fluxo de referência local da demo `/dashboard` não precisa de banco de dados, então pode passar sozinho; criar uma conta em `/auth` só funciona depois que as migrações rodaram. 'A demo funcionou' ainda não é 'as contas funcionam'. ## Se você preferir fazer à mão Cada etapa acima também existe como um tutorial passo a passo. Execute o [guia Web de cinco minutos](https://supastack.dev/pt/docs/web/ship-in-5-minutes.md) para a primeira demo e depois a [Configuração local da Web](https://supastack.dev/pt/docs/web/local-setup.md) para o ambiente local completo com um banco de dados real. Um agente continua útil depois da configuração mesmo quando não foi ele quem instalou — [o guia do fluxo de trabalho com agentes](https://supastack.dev/pt/docs/web/agents.md) cobre tarefas do dia a dia como novas telas, mudanças de estilo e revisões. ## Seguinte [Lança em 5 minutos](https://supastack.dev/pt/docs/web/ship-in-5-minutes.md)