Lascia configurare tutto a un agente

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
• Esegui l'app Desktop

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.

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 <SETUP_PATH: docker | podman | host> 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 <DEPLOY_TARGET: coolify | vps-docker | local-only> 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.

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 per la prima demo, poi Configurazione locale Web 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 copre le attività di tutti i giorni come nuove schermate, restyling e revisioni.