Einrichtung durch einen Agenten

Sie können den langweiligen Teil delegieren

Dieses Repository wurde so geschrieben, dass ein Coding-Agent es lesen kann. Es liefert eine Kartendatei (llms.txt), eine Regeldatei (AGENTS.md), ein Schritt-für-Schritt-Runbook (docs/agent-setup.md) und einen fertigen Prompt (prompts/agent-setup.md) mit. Statt jeden Einrichtungsbefehl selbst zu lernen, fügen Sie einen Prompt ein, und der Agent folgt dem Runbook auf Ihrem Computer.

Das Delegieren des Tippens bedeutet nicht, die Kontrollen zu überspringen. Der Agent arbeitet in Ihrer Kopie des Repositorys und muss mit Belegen berichten, was er getan hat. Die folgenden Abschnitte zeigen, wie ein guter Bericht aussieht, damit Sie die Kontrolle über das Ergebnis behalten.

Eine ehrliche Grenze: Dieser automatisierte Weg richtet die Web-App und ihr Backend ein — den Server, der Konten und Daten verwaltet. Prompt und Runbook liegen dem Web-Repository und dem All-Platforms-Monorepo bei. Reine Mobile- und Desktop-Checkouts enthalten stattdessen ihre eigene, eingegrenzte llms.txt und plattformeigene Einrichtungsanleitungen.

• Mobile-App lokal einrichten
• Desktop-App ausführen

Was Sie zuerst brauchen

Schließen Sie zuerst die Vorbereitungsanleitung ab: Node.js, Git und ein Editor installiert, die GitHub-Einladung angenommen und der supastack-Ordner auf Ihren Computer heruntergeladen. Der Agent arbeitet in diesem Ordner, daher gilt alles aus Bevor Sie beginnen weiterhin.

Außerdem brauchen Sie ein Werkzeug, das als Coding-Agent arbeiten kann — ein Editor mit eingebautem KI-Coding-Agenten (eine KI-IDE) oder ein Agent, der in Ihrem Terminal läuft (eine Agenten-CLI). Jedes aktuelle agentenfähige Werkzeug funktioniert; der Prompt legt bereits fest, was er lesen und ausführen muss, sodass Sie keine Anweisungen selbst schreiben müssen.

Schließlich brauchen Sie einen von zwei Wegen, die App auszuführen: Node.js 22 oder neuer auf Ihrem Computer installiert — der Weg, den die Vorbereitungsanleitung eingerichtet hat — oder ein Container-Werkzeug wie Docker oder Podman, das die App in Containern ausführt und kein installiertes Node.js benötigt. Sie wählen eine Option im Prompt, und der Agent folgt ihr.

Prompt kopieren, zwei Lücken ausfüllen, einfügen

Öffnen Sie prompts/agent-setup.md im Editor — die Datei liegt im Ordner prompts auf der obersten Ebene des supastack-Ordners, neben llms.txt. Markieren Sie den gesamten Text und kopieren Sie ihn.

Zwei Platzhalter brauchen Ihre Auswahl. Ersetzen Sie <SETUP_PATH: docker | podman | host> durch docker, podman oder host — host führt die App direkt auf Ihrem Computer mit dem installierten Node.js aus; docker oder podman führt sie in Containern aus. Ersetzen Sie <DEPLOY_TARGET: coolify | vps-docker | local-only> durch das Ziel, an dem die App landen soll — local-only führt sie auf diesem Computer aus und deployt nichts; das ist die richtige Wahl für einen ersten Blick.

Fügen Sie den bearbeiteten Text in den Chat des Agenten ein und senden Sie ihn ab. Die ausgefüllte erste Zeile unten zeigt die Auswahl docker plus local-only; die nummerierten Schritte darunter bleiben genau so, wie die Datei ausgeliefert wird.

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

Was der Agent mit dem Prompt macht

Der Prompt verweist den Agenten auf das Runbook und die Sicherheitsregeln und weist ihn an, sie der Reihe nach abzuarbeiten und jede Phase nachzuweisen. Einfach gesagt, der Agent:

• Liest die Repository-Karte (llms.txt), die Projektregeln (AGENTS.md) und die Regeln zum Umgang mit Zugangsdaten (docs/agent-security.md), bevor irgendetwas angefasst wird.
• Erstellt die .env-Konfigurationsdateien mit node scripts/setup-env.mjs. Das Hilfsskript kopiert nur aus .env.example, sodass der Agent nie Einstellungsnamen erfindet, und es bewahrt bereits vorhandene Geheimnisse, statt sie zu überschreiben.
• Startet Postgres — die Datenbank, in der die App Konten und Datensätze hält — und die App selbst, als Container auf dem docker- oder podman-Pfad oder mit Befehlen auf Ihrem Computer auf dem host-Pfad.
• Führt die Datenbankmigrationen — die Befehle, die die Tabellen der App anlegen — vor der ersten echten Anmeldung aus, denn ein Konto, das vor den Tabellen entsteht, ist ein kaputtes.
• Verifiziert jede Phase an einem Kontrollpunkt und schließt mit einem Bericht ab, der jede Prüfung als PASS, FAIL, BLOCKED oder NOT RUN markiert — mit der Ausgabe, die das belegt.

Was Sie im Bericht des Agenten prüfen

Ein guter Bericht zeigt Belege, keine Behauptungen. Achten Sie hinter jedem PASS auf die echte Health-Antwort und die Befehlsausgabe — nicht auf einen Satz wie „alles funktioniert“.

Der Prompt weist den Agenten an, nach dem zweiten Fehlschlag desselben Schritts zu stoppen und zu berichten — statt den Fehler zu umgehen — und vor allem Destruktiven zu fragen, etwa dem Löschen einer Datenbank. Wenn Ihr Agent nach wiederholten Fehlschlägen weiter improvisiert, stoppen Sie ihn und nehmen Sie den ersten Fehler mit in die Fehlerbehebungs-Anleitung.

Zwei Dinge dürfen nie vorkommen: ein Sicherheitsfeature, das abgeschaltet wurde, um einen Fehler zum Schweigen zu bringen, und ein geheimer Wert wie ein Passwort oder Schlüssel, der in den Chat oder den Bericht geschrieben wurde. Wenn Sie eines davon sehen, werten Sie den Lauf als fehlgeschlagen.

Halten Sie die Demo und eine echte Anmeldung gedanklich getrennt. Der lokale Referenzablauf der /dashboard-Demo braucht keine Datenbank und kann daher allein bestehen; ein Konto unter /auth anzulegen funktioniert erst, nachdem die Migrationen gelaufen sind. „Die Demo lief“ ist noch nicht „Konten funktionieren“.

Wenn Sie es lieber von Hand machen

Jeder Schritt oben existiert auch als Klick-für-Klick-Anleitung. Folgen Sie der Fünf-Minuten-Web-Anleitung für die erste Demo, dann der lokalen Web-Einrichtung für die vollständige lokale Umgebung mit echter Datenbank.

Ein Agent ist auch nach der Einrichtung nützlich, selbst wenn er die Installation nicht übernommen hat — die Anleitung zum Arbeiten mit Agenten behandelt Alltagsaufgaben wie neue Bildschirme, Umgestaltungen und Reviews.