KI-Agenten sind gut darin, Code zu erzeugen, aber ohne Struktur neigen sie zur Improvisation. AIUP gibt der KI eine vordefinierte Kette von Artefakten vor, die jeweils den Lösungsraum für den nächsten Schritt einengen.
Wenn Sie bei /implement ankommen, hat die KI bereits eine Vision, eine Use-Case-Spezifikation, ein Entitätsmodell und ein Datenbankschema, an denen sie sich orientieren kann — der erzeugte Code wurzelt in Ihrer Domäne, nicht in einer generischen Vorlage.
Was Sie brauchen, bevor Sie die Kette starten:
Jeder Schritt entspricht einem Slash-Befehl in Claude Code. Führen Sie sie der Reihe nach aus — jeder Schritt baut auf den Artefakten des vorherigen auf.
Die Vision ist das einzige Artefakt, das Sie selbst schreiben. Alles Weitere wird daraus generiert.
Für dieses Tutorial liegt die Vision bereits unter docs/vision.md bereit — öffnen Sie sie und lesen Sie sie, bevor Sie weitermachen. Sie ist die Quelle der Wahrheit für jeden folgenden Schritt. Halten Sie sie kurz — eine Seite reicht: das Problem, die Lösung, die Zielnutzer, die Ziele und die Nicht-Ziele.
Dieser Skill liest docs/vision.md und produziert einen strukturierten Anforderungskatalog in docs/requirements.md mit:
Prüfen Sie den Katalog, bevor Sie weitermachen — das ist Ihre letzte Gelegenheit, kostengünstig nachzusteuern. Jeder spätere Schritt baut auf dieser Liste auf.
Aus den Anforderungen identifiziert der Skill die Domänenentitäten und erzeugt ein Mermaid-ER-Diagramm in docs/architecture/entity-model.md mit Entitäten und Attributen samt Typen, Beziehungen und Kardinalitäten sowie Validierungsregeln (Pflichtfelder, Längen, Eindeutigkeit).
Für die Book Library erwartet Sie etwa Folgendes:
Die Entität AppUser (id, username, password_hash, role) gehört zum Starterprojekt und muss nicht im Entitätsmodell auftauchen — behandeln Sie sie als externe Grenze.
Der Skill erzeugt aus den Anforderungen ein PlantUML-Use-Case-Diagramm unter docs/architecture/use-case-diagram.puml. Es zeigt die beiden Akteure (Member, Librarian) und die Use Cases, an denen sie beteiligt sind:
UC-001Katalog durchsuchenUC-002Buch ausleihenUC-003Buch zurückgebenUC-004Aktive Ausleihen ansehen (Librarian)UC-005Katalog verwalten (Librarian)Nutzen Sie das Diagramm zur Abdeckungsprüfung: Jede Anforderung sollte mindestens einem Use Case zugeordnet sein, und jeder Use Case sollte auf eine Anforderung zurückführbar sein.
Wählen Sie den Use Case, der die anderen freischaltet, zuerst. Für die Book Library ist das UC-001 Katalog durchsuchen — er hat keine Vorbedingungen, gibt dem Mitglied sofort etwas zu tun und liefert die Datenstrukturen, die UC-002 braucht.
Der Skill schreibt docs/use_cases/UC-001-search-catalog.md mit Akteuren und Stakeholdern, Vor- und Nachbedingungen, dem Hauptablauf als nummerierte Schritte, Alternativabläufen und Akzeptanzkriterien.
Der Skill liest das Entitätsmodell und die Use-Case-Spezifikation und erzeugt ein versioniertes Flyway-Skript unter src/main/resources/db/migration/. Da das Starterprojekt bereits V001__create_app_user.sql enthält, produziert der Skill eine neue Version (z. B. V002__create_member_book_loan.sql) für die fehlenden Tabellen mit:
Führen Sie nach diesem Schritt einmal ./mvnw compile aus — das startet ein Testcontainers-Postgres, wendet die Migration an und regeneriert das jOOQ-Metamodell, sodass der nächste Schritt typsichere Referenzen auf Ihre neuen Tabellen hat.
Hier zahlt sich die Kette aus. Der Skill liest die Use-Case-Spezifikation, das Entitätsmodell und die generierten jOOQ-Klassen und erzeugt:
BookRepository) im domain-PaketSearchCatalogView) im ui-Paket, an MainLayout angebundenStarten Sie die App über TestApplication aus Ihrer IDE und klicken Sie durch den Ablauf. Sie sollten eine Suchanfrage eingeben können, die Filterung des Grids sehen und die Ergebnisse so sortiert vorfinden, wie es die Spezifikation verlangt.
Der Skill erstellt einen UI-Unit-Test unter src/test/java/.../SearchCatalogViewTest.java, der AbstractBrowserlessTest erweitert. Er testet die View ohne Browser, indem er den Vaadin-Komponentenbaum direkt steuert: zur View navigieren, Suchfeld und Grid finden, eine Anfrage eintippen, prüfen dass das Grid die erwarteten Zeilen zeigt und die Alternativabläufe der Spezifikation abdecken.
Ausführen mit ./mvnw test. Diese Tests sind schnell — unter einer Sekunde pro Test — und bilden die innere Feedback-Schleife beim Iterieren an der View.
Der letzte Skill erzeugt einen Playwright + Mopo E2E-Test unter src/test/java/.../SearchCatalogIT.java, der PlaywrightIT erweitert. Er bootet die komplette Spring-Boot-App auf einem zufälligen Port und steuert einen echten Browser durch den Use Case: App mit frischer Datenbank starten, Katalogseite öffnen, Suchanfrage eintippen und prüfen, dass die sichtbaren Zeilen der Spezifikation entsprechen.
Ausführen mit ./mvnw verify zum Starten der Integrationstests. Das ist Ihre äussere Feedback-Schleife — langsamer als die Browserless-Tests, beweist aber, dass JavaScript, CSS, Routing und Datenbank zusammenspielen.
Nach dem vollständigen Durchlauf für UC-001 haben Sie eine dokumentierte Vision und einen Anforderungskatalog, ein Entitätsmodell und ein Use-Case-Diagramm für die ganze App sowie eine Spezifikation, eine Migration, eine Implementierung und zwei Testebenen für den ersten Use Case.
Für einen neuen Use Case benötigen Sie nur die Schritte 5, 7, 8, 9 — Anforderungen, Entitätsmodell und Diagramm decken die ganze App ab und müssen nicht neu erzeugt werden. Use Cases mit neuen Tabellen oder Spalten lösen zusätzlich Schritt 6 mit einer neuen V003__...-Migration aus.
Workshops und massgeschneiderte Einführungen des AI Unified Process für Ihr Team und Ihren Stack. Vereinbaren Sie einen Termin, um zu besprechen, wie AIUP zu Ihrem Projekt passt.