Dieses Tutorial fuehrt dich in einer Runde durch den vollstaendigen Fabrik-Workflow: Projekt erfassen, Artefakte generieren, Run gegen Claude Code ausfuehren, Ergebnis pruefen. Kein Mock, kein Abkuerzen — das ist der reale Einsatzpfad.
| Werkzeug | Version | Pruefkommando |
|---|---|---|
| Docker Compose | v2.x | docker compose version |
| JDK | 25 | java -version |
| Maven | ≥ 3.9 | mvn -v |
| Claude Code CLI | aktuell | claude --version |
| git | ≥ 2.4 | git --version |
Claude Code muss bereits einmal interaktiv angemeldet sein. Die Fabrik ruft das claude-CLI als Subprozess auf und nutzt deine gespeicherten Credentials.
Postgres ueber Docker Compose hochfahren, App per Maven starten. Die App laeuft bewusst nicht im Container, damit sie Claude Code als lokalen Subprozess aufrufen kann.
# im Repo-Root: docker compose up -d postgres # in einem zweiten Terminal: cd app export SOFTWAREFABRIK_ADMIN_PASSWORD='test-admin-123' export SOFTWAREFABRIK_EXECUTION_ADAPTER=claude export SOFTWAREFABRIK_CLAUDECODE_COMMAND="$(which claude)" export SOFTWAREFABRIK_WORKSPACES_ROOT=/tmp/softwarefabrik-workspaces mvn spring-boot:run
http://localhost:8080 oeffnen, als admin anmelden (Passwort aus der Env-Variable). Beim ersten Login wird der Bootstrap-Admin in der DB angelegt.
Im Wizard Titel, Kurzbeschreibung, Ziel und Technologie-Kontext eintragen. Gut formulierte Felder liefern deutlich bessere Ergebnisse — die Fabrik generiert daraus die Arbeitsauftraege fuer den Agenten.
Button Artefakte generieren erstellt sechs Markdown-Dokumente (PROJECT.md, INSTRUCTIONS.md, AGENTS.md, WORKFLOW.md, DEFINITION_OF_DONE.md, README.md). Diese sind editierbar — lies sie durch, besonders INSTRUCTIONS.md und DEFINITION_OF_DONE.md.
Danach Status auf READY setzen.
Menue Teams → neues Team, mindestens einen Agenten waehlen (z.B. Developer). Anschliessend Runs → neuer Run: Projekt, Team, Titel, Ziel. Status auf READY, dann Run starten.
Der Run durchlaeuft asynchron vier Phasen:
| Phase | Was passiert |
|---|---|
WORKSPACE_PREPARATION | Git-Repo unter SOFTWAREFABRIK_WORKSPACES_ROOT/<slug>/<run-id> anlegen, Artefakte reinkopieren |
EXECUTION | claude --print <aufgabe> laeuft im Workspace, Agent produziert Code |
VALIDATION | mvn verify (oder konfigurierter Build) prueft das Ergebnis |
COMPLETION | Bei Erfolg: Commit + Status COMPLETED. Bei Fehler: NEEDS_CORRECTION |
Parallel kannst du die Buttons Logs anzeigen und Git-Status nutzen und bei Bedarf einen manuellen Freigabeschritt durchfuehren.
cd /tmp/softwarefabrik-workspaces/<slug>/<run-id> git log --oneline -10 mvn verify # optional nochmal lokal
Code + Artefakte bleiben im Workspace, bis du ihn manuell loescht. Der Workspace ist ein normales Git-Repo — du kannst von hier aus pushen, branchen, reviewen.
| Symptom | Loesung |
|---|---|
claude: command not found | Absoluten Pfad in SOFTWAREFABRIK_CLAUDECODE_COMMAND setzen. |
Run bleibt in PREPARING | Schreibrechte im SOFTWAREFABRIK_WORKSPACES_ROOT pruefen, Logs oeffnen. |
mvn verify scheitert sofort | Agent hat kein Maven-Projekt erzeugt. Build-Tool ueber SOFTWAREFABRIK_MAVEN_COMMAND auf gradle/npm umstellen oder erst Mock-Adapter probieren. |
| Lizenz-Block verhindert Start | V1-Lizenz-Modul ist per Default aus (SOFTWAREFABRIK_LICENSE_V1_ENABLED=false). Wert nicht setzen oder auf false lassen. |
| Port 8080 belegt | SOFTWAREFABRIK_PORT=9090 setzen oder den anderen Prozess stoppen. |