In 10 Minuten zum ersten Lauf.

1. Entpacken und .env anlegen

Entpacke das ZIP, öffne ein Terminal im entpackten Ordner und lege die Konfiguration aus der Vorlage an:

cp .env.example .env            # Windows: Copy-Item .env.example .env

Trag in der .env ein eigenes Admin-Passwort ein:

SOFTWAREFABRIK_ADMIN_PASSWORD=dein-eigenes-passwort

Für den Mock-Durchgang musst du sonst nichts umstellen: Den Mock wählst du gleich in der Ersteinrichtung, und ohne Lizenz läuft ein Lauf, den du in der Oberfläche startest, ohnehin angekündigt mit dem Mock. Eine Agenten-CLI brauchst du dafür nicht. Die .env enthält Zugangsdaten: nicht weitergeben, nicht committen.

2. Starten und anmelden

./start.sh                      # Windows: .\start.ps1

Das Skript prüft die Voraussetzungen, startet die Datenbank im Container und danach die Fabrik. Öffne http://localhost:8080 und melde dich als admin mit deinem Passwort an. Beenden kannst du die Fabrik später mit Ctrl+C im Terminal; docker compose down stoppt die Datenbank, die Daten bleiben erhalten.

3. Ersteinrichtung

Als Administrator siehst du auf dem Dashboard „Willkommen — richte die Fabrik in drei Schritten ein“. Klick auf „Ersteinrichtung starten“:

1. KI-Zugang: Hier wählst du später Claude Code & Co. und Abo oder API-Schlüssel. Für diesen Durchgang klickst du unten auf „Erst ohne KI-Agent ausprobieren (Mock)“: Der Mock wird Standard — ein Lauf zeigt den ganzen Ablauf, es entsteht aber kein echter Code. Zurück auf einen echten Agenten wechselst du später unter Einrichtung → KI-Zugang.
2. System: Die Systemprüfung zeigt nur offene Punkte, je mit nächstem Schritt; als aktiver Adapter steht dort der Mock. Für den Mock ist keine davon ein Hindernis — auch nicht die Zeile „Lizenz“: Ohne Lizenz startet kein neuer Lauf mit einem echten KI-Agenten; Läufe mit dem Mock bleiben möglich. Die kostenlose Community-Lizenz („Lizenz einrichten“) brauchst du erst für echte Läufe. Dann „Weiter“.
3. Loslegen: „Neues Projekt beschreiben“ öffnet den Schnellstart.

Oben rechts schaltest du mit „Einfach | Experte“, wie viel die Oberfläche zeigt. Eine neue Fabrik startet in „Einfach“; diese Anleitung folgt dieser Darstellung.

4. Beschreiben und bauen

Im Schnellstart genügen drei Angaben:

1. Wie heißt das Projekt? Mein erstes Backend
2. Was für ein Projekt ist es? Web-Anwendung mit Java (Spring Boot)
3. Was soll entstehen? Ein Maven-Projekt mit Spring Boot, Health-Endpoint und einem ersten Smoke-Test.

localhost:8080/wizard/schnellstart

Über dem Knopf steht, dass der Lauf mit dem Mock läuft und kein echter Code entsteht (mit dem Mock fallen auch keine Kosten an). Klick „Bauen“ (ohne Lizenz und ohne Mock-Wahl heißt er „Mit dem Mock ausprobieren“): Die Fabrik legt das Projekt an und startet sofort den ersten Lauf — deine Beschreibung ist sein Auftrag. Du landest auf der Laufseite; der Kasten „Mock-Lauf“ erinnert daran, dass es ein Probedurchgang ist.

5. Laufseite: beobachten und freigeben

Der Lauf arbeitet im Hintergrund; die Seite aktualisiert sich selbst. Der Kasten „Was jetzt?“ sagt dir in jedem Stand, was zu tun ist, und es erscheinen nur die Knöpfe, die gerade gehen.

localhost:8080/runs/…

1. Vor der Ausführung hält der Lauf in Wartet auf deine Freigabe. Wirf einen Blick auf die Änderungen und klick „Freigeben und fortsetzen“.
2. Weil der Mock keine Build-Dateien schreibt, meldet die Build-Prüfung „Build nicht geprüft“ — eine Warnung, kein Fehler. Der Lauf wartet ein zweites Mal, diesmal vor dem Merge. Gib ihn erneut frei; dann läuft er bis Abgeschlossen.

Geht etwas schief, steht die Ursache ganz oben; „Erneut versuchen“ startet einen neuen Lauf mit demselben Auftrag.

6. Ergebnis

Nach dem Abschluss fasst die Karte „Ergebnis“ zusammen, wo die Änderungen liegen und welche Dateien geändert wurden; unter „Selbst ausprobieren“ steht der Befehl, mit dem du die Anwendung startest. „Ergebnis als ZIP herunterladen“ liefert den Projektordner ohne Git-Daten und Bauartefakte. Unter „Logs anzeigen“ siehst du jede Zeile des Laufs. Der Mock simuliert den Lauf nur und schreibt keinen Code; die KI-Reviewer im Quality-Gate überspringt er (das steht auf der Laufseite und im Log).

Die nächsten 20 Minuten: erkunden

• Projektseite: Beschreibung, „Nächster Auftrag“ mit „Bauen“, letztes Ergebnis und bisherige Läufe.
• Artefakte: Schalte auf „Experte“ und öffne „Generierte Artefakte“: PROJECT.md, INSTRUCTIONS.md, AGENTS.md. Du siehst, wie aus deiner Beschreibung ein Auftrag für den Agenten wurde.
• Weiter verbessern: Auf der Ergebnis-Karte führt „Weiter verbessern“ zum nächsten Auftrag; „Vorschläge machen lassen“ startet einen Plan-Lauf, der Vorschläge ins Backlog legt.
• Ausführlicher Assistent: Wer Stack und Prüfwerkzeuge selbst festlegen will, probiert in „Experte“ den Assistenten in sechs Schritten.