Laat een agent het inrichten

U kunt het saaie deel delegeren

Deze repository is zo geschreven dat een codeeragent hem kan lezen. Hij levert een kaartbestand (llms.txt), een regelbestand (AGENTS.md), een stapsgewijs runbook (docs/agent-setup.md) en een kant-en-klare prompt (prompts/agent-setup.md). In plaats van elke installatieopdracht zelf te leren, plakt u één prompt en volgt de agent het runbook op uw computer.

Het typen delegeren betekent niet dat u de controles overslaat. De agent werkt binnen uw kopie van de repository en moet met bewijs rapporteren wat hij heeft gedaan. De secties hieronder laten zien hoe een goed rapport eruitziet, zodat u de leiding over het resultaat behoudt.

Een eerlijke beperking: dit geautomatiseerde pad richt de webapp en zijn backend in — de server die accounts en gegevens afhandelt. De prompt en het runbook worden meegeleverd met de webrepository en met de All Platforms-monorepo. Checkouts voor alleen mobiel of alleen desktop dragen in plaats daarvan hun eigen toegespitste llms.txt en platforminstallatiegidsen.

• De mobiele app lokaal installeren
• De desktop-app draaien

Wat u eerst nodig heeft

Voltooi eerst de voorbereidingsgids: Node.js, Git en een editor geïnstalleerd, de GitHub-uitnodiging geaccepteerd en de supastack-map gedownload naar uw computer. De agent werkt in die map, dus alles in Voordat u begint geldt nog steeds.

U heeft ook een tool nodig die als codeeragent kan optreden — een editor met een ingebouwde AI-codeeragent (een AI-IDE) of een agent die in uw terminal draait (een agent-CLI). Elke huidige tool met agentmogelijkheden werkt; de prompt beschrijft al wat hij moet lezen en uitvoeren, dus u hoeft zelf geen instructies te schrijven.

Ten slotte heeft u één van twee manieren nodig om de app te draaien: Node.js 22 of nieuwer op uw computer geïnstalleerd — het pad dat de voorbereidingsgids heeft ingericht — of een containertool zoals Docker of Podman, die de app in containers draait en geen geïnstalleerde Node.js nodig heeft. U kiest er één in de prompt en de agent volgt die.

Kopieer de prompt, vul twee lege plekken in, plak

Open prompts/agent-setup.md in de editor — het staat in de map prompts op het hoogste niveau van de supastack-map, naast llms.txt. Selecteer de hele tekst en kopieer die.

Twee placeholders hebben uw keuzes nodig. Vervang <SETUP_PATH: docker | podman | host> door een van docker, podman of host — host draait de app direct op uw computer met de Node.js die u heeft geïnstalleerd; docker of podman draait hem in containers. Vervang <DEPLOY_TARGET: coolify | vps-docker | local-only> door waar de app moet terechtkomen — local-only draait hem op deze computer en rolt niets uit, wat de juiste keuze is voor een eerste kennismaking.

Plak de bewerkte tekst in de chat van de agent en verstuur hem. De ingevulde eerste regel hieronder laat de keuzes docker plus local-only zien; de genummerde stappen onder die regel blijven precies zoals het bestand wordt geleverd.

Stand up this supastack checkout end to end for **docker**
and deploy it to **local-only**.

Wat de agent met de prompt doet

De prompt wijst de agent naar het runbook en de beveiligingsregels en zegt hem die op volgorde door te werken en elke fase te bewijzen. In gewone taal doet de agent het volgende:

• Leest de repositorykaart (llms.txt), de projectregels (AGENTS.md) en de regels voor omgang met inloggegevens (docs/agent-security.md) voordat hij iets aanraakt.
• Maakt de .env-configuratiebestanden aan met node scripts/setup-env.mjs. De helper kopieert alleen uit .env.example, dus de agent verzint nooit instellingsnamen, en hij behoudt geheimen die u al heeft in plaats van ze te overschrijven.
• Start Postgres — de database waarin de app accounts en records bewaart — en de app zelf, als containers voor het pad docker of podman of met opdrachten op uw computer voor het pad host.
• Voert de databasemigraties uit — de opdrachten die de tabellen van de app aanmaken — vóór de eerste echte aanmelding, want een account dat wordt aangemaakt voordat de tabellen bestaan, is een defect account.
• Verifieert elke fase bij een controlepunt en eindigt met een rapport dat elke controle als PASS, FAIL, BLOCKED of NOT RUN markeert, met de uitvoer die dat ondersteunt.

Wat u in het rapport van de agent controleert

Een goed rapport toont bewijs, geen beweringen. Zoek achter elke PASS naar de echte health-response en opdrachtuitvoer — niet naar een zin als 'alles werkt'.

De prompt vertelt de agent te stoppen en te rapporteren nadat dezelfde stap twee keer is mislukt — niet om de mislukking heen te werken — en u te vragen voor alles destructiefs, zoals het leegmaken van een database. Als uw agent na herhaalde mislukkingen blijft improviseren, stop hem dan en neem de eerste fout mee naar de probleemoplossingsgids.

Twee dingen mogen nooit verschijnen: een beveiligingsfunctie die is uitgeschakeld om een fout tot zwijgen te brengen, en een geheime waarde zoals een wachtwoord of sleutel die in de chat of het rapport wordt afgedrukt. Als u een van beide ziet, beschouw de run dan als mislukt.

Houd de demo en een echte aanmelding in uw hoofd uit elkaar. De lokale referentiestroom van de /dashboard-demo heeft geen database nodig, dus die kan op zichzelf slagen; een account aanmaken op /auth werkt pas nadat migraties hebben gedraaid. 'De demo werkte' is nog niet 'accounts werken'.

Als u het liever met de hand doet

Elke stap hierboven bestaat ook als klik-voor-klik-tutorial. Voer de vijfminuten-webgids uit voor de eerste demo en daarna de lokale webinstallatie voor de volledige lokale omgeving met een echte database.

Een agent is ook na de installatie nog nuttig, zelfs als hij het installeren niet heeft gedaan — de agentworkflowgids behandelt alledaagse taken zoals nieuwe schermen, herstijlen en reviews.