> ## 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 # Lascia configurare tutto a un agente Incolla un prompt già pronto in un agente di codice, lascia che esegua la configurazione Web sul tuo computer e controlla il report che scrive su ogni passaggio. ## Puoi delegare la parte noiosa Questo repository è stato scritto perché un agente di codice possa leggerlo. Include un file mappa (`llms.txt`), un file di regole (`AGENTS.md`), un runbook passo passo (`docs/agent-setup.md`) e un prompt già pronto (`prompts/agent-setup.md`). Invece di imparare ogni comando di configurazione da solo, incolli un prompt e l'agente segue il runbook sul tuo computer. Delegare la digitazione non significa saltare i controlli. L'agente lavora dentro la tua copia del repository e deve riportare ciò che ha fatto con prove. Le sezioni qui sotto mostrano com'è fatto un buon report, così resti tu al comando del risultato. Un limite onesto: questo percorso automatizzato configura l'app Web e il suo backend — il server che gestisce account e dati. Il prompt e il runbook sono inclusi nel repository Web e nel monorepo All Platforms. I checkout solo Mobile e solo Desktop portano invece il proprio `llms.txt` dedicato e le guide di configurazione della piattaforma. [Configura l'app Mobile in locale](https://supastack.dev/it/docs/mobile/local-setup.md) [Esegui l'app Desktop](https://supastack.dev/it/docs/desktop/run.md) ## Cosa ti serve prima Completa prima la guida di preparazione: Node.js, Git e un editor installati, l'invito GitHub accettato e la cartella supastack scaricata sul tuo computer. L'agente lavora dentro quella cartella, quindi vale ancora tutto ciò che c'è in [Prima di iniziare](https://supastack.dev/it/docs/web/before-you-start.md). Ti serve anche uno strumento che possa fare da agente di codice — un editor con un agente di codice AI integrato (un IDE AI) o un agente che gira nel tuo terminale (una CLI agent). Va bene qualsiasi strumento attuale con capacità da agente; il prompt specifica già cosa deve leggere ed eseguire, quindi non devi scrivere istruzioni da solo. Infine, ti serve uno di due modi per eseguire l'app: Node.js 22 o più recente installato sul computer — il percorso preparato dalla guida di preparazione — oppure uno strumento di container come Docker o Podman, che esegue l'app dentro container e non richiede Node.js installato. Scegli tu quale dentro il prompt, e l'agente lo segue. ## Copia il prompt, compila due spazi vuoti, incolla Apri `prompts/agent-setup.md` nell'editor — si trova nella cartella `prompts` al livello più alto della cartella supastack, accanto a `llms.txt`. Seleziona tutto il testo e copialo. Due segnaposto richiedono le tue scelte. Sostituisci `` con uno tra docker, podman o host — host esegue l'app direttamente sul tuo computer usando il Node.js che hai installato; docker o podman la esegue dentro container. Sostituisci `` con dove l'app deve finire — local-only la esegue su questo computer e non distribuisce nulla, ed è la scelta giusta per un primo sguardo. Incolla il testo modificato nella chat dell'agente e invialo. La prima riga compilata qui sotto mostra le scelte docker più local-only; i passaggi numerati sotto quella riga restano esattamente come il file li include. ``` Stand up this supastack checkout end to end for **docker** and deploy it to **local-only**. ``` ## Cosa fa l'agente con il prompt Il prompt punta l'agente al runbook e alle regole di sicurezza, poi gli dice di lavorarci in ordine e di provare ogni fase. In parole semplici, l'agente: - Legge la mappa del repository (`llms.txt`), le regole del progetto (`AGENTS.md`) e le regole di gestione delle credenziali (`docs/agent-security.md`) prima di toccare qualsiasi cosa. - Crea i file di configurazione `.env` con `node scripts/setup-env.mjs`. Lo script di supporto copia solo da `.env.example`, quindi l'agente non inventa mai nomi di impostazioni e preserva i segreti che hai già invece di sovrascriverli. - Avvia Postgres — il database in cui l'app tiene account e record — e l'app stessa, come container per il percorso docker o podman oppure con comandi sul tuo computer per il percorso host. - Esegue le migrazioni del database — i comandi che creano le tabelle dell'app — prima del primo login reale, perché un account creato prima che le tabelle esistano è un account rotto. - Verifica ogni fase a un checkpoint e finisce con un report che marca ogni controllo PASS, FAIL, BLOCKED o NOT RUN, con l'output che lo dimostra. ## Cosa controlli nel report dell'agente Un buon report mostra prove, non dichiarazioni. Cerca la vera risposta di health e l'output dei comandi dietro ogni PASS — non una frase come «funziona tutto». Il prompt dice all'agente di fermarsi e riportare dopo che lo stesso passaggio fallisce due volte — non di aggirare il fallimento — e di chiederti prima di qualsiasi cosa distruttiva, come svuotare un database. Se il tuo agente continua a improvvisare dopo fallimenti ripetuti, fermalo e porta il primo errore alla [guida alla risoluzione dei problemi](https://supastack.dev/it/docs/web/troubleshooting.md). Due cose non devono mai apparire: una funzionalità di sicurezza spenta per silenziare un errore, e un valore segreto come una password o una chiave stampato nella chat o nel report. Se ne vedi una, considera l'esecuzione fallita. Tieni ben distinti nella testa la demo e il login reale. Il flusso di riferimento locale della demo `/dashboard` non ha bisogno di un database, quindi può passare da solo; creare un account su `/auth` funziona solo dopo che le migrazioni sono state eseguite. «La demo ha funzionato» non è ancora «gli account funzionano». ## Se preferisci farlo a mano Ogni passaggio qui sopra esiste anche come tutorial click per click. Esegui la [guida Web da cinque minuti](https://supastack.dev/it/docs/web/ship-in-5-minutes.md) per la prima demo, poi [Configurazione locale Web](https://supastack.dev/it/docs/web/local-setup.md) per l'ambiente locale completo con un database reale. Un agente resta utile anche dopo la configurazione, anche quando non è stato lui a installare — [la guida al workflow con gli agenti](https://supastack.dev/it/docs/web/agents.md) copre le attività di tutti i giorni come nuove schermate, restyling e revisioni. ## Successivo [Pubblica in 5 minuti](https://supastack.dev/it/docs/web/ship-in-5-minutes.md)