Master 2.2 - Codex / Claude Code Aufbauplan
Master 2 ist ein größerer Enterprise-Workspace mit 18 Modulen. Der AI-Aufbau fokussiert auf schrittweise Slices: Foundation, fachliche Kernmodule, Application Services, technische Adapter, Outbox/Saga/CQRS, Security/Observability und Betrieb.
Umfang: 18 Maven-Module, Projektbeschreibungen je Modul, mehrere Deep-Dive-Dokumente und zentrale Workspace-Übersicht.
Grundprinzip
- AI ist hier Pair-Engineer, nicht blindes Generatorwerkzeug.
- Jede Phase hat Ziel, kleine Dateimenge, Test oder Prüfnachweis und kurze Doku.
- Entwurfsmuster werden im Code mit
// PATTERN:und in../docs/design-patterns.mddokumentiert. - Markdown-Dateien bekommen immer auch eine HTML-Version.
- Planungs- und Weiterarbeitsnotizen werden nicht als Fachinhalt konsolidiert.
Phasenplan
0 - Workspace-Inventar und Dependency-Regeln
Phase-Ziel
AI liest pom.xml, PROJECTS.md, ../docs/maven-deep-dive.md und ../docs/design-patterns.md. Ergebnis: Build-Reihenfolge, erlaubte Abhängigkeiten und Modulverantwortung.
1 - Foundation und Shared Kernel
Phase-Ziel
Parent-POM, BOM/DependencyManagement, shared-kernel und gemeinsame Testhilfen erzeugen. Pattern: Shared Kernel, Value Object, Test Data Builder.
2 - Domain-Module mit echten Invarianten
Phase-Ziel
Order, Payment, Inventory, Customer und Catalog in getrennten Modulen aufbauen. AI soll zuerst öffentliche API der Domain schreiben, dann Tests, dann Implementierung.
3 - Application-Schicht und Ports
Phase-Ziel
Application Services, Command Handler, Ports und Transaktionsgrenzen ergänzen. AI darf hier orchestrieren, aber keine technischen Frameworkdetails in die Domain ziehen.
4 - Adapter-Schicht
Phase-Ziel
REST, Persistence, Messaging und Legacy-Adapter erzeugen. Jeder Adapter bekommt README.md/html mit Zweck, Ablauf, wichtigen Klassen und Pattern.
5 - Outbox, Saga und CQRS
Phase-Ziel
Outbox-Engine, Saga-Orchestration und Read Models phasenweise ergänzen. AI erstellt erst Sequenzbeschreibung, dann Interfaces, dann In-Memory-Demo, dann technische Adapter.
6 - Security, Observability und Runbooks
Phase-Ziel
Policies, Guards, Decorators, Audit, Metrics, Tracing und Runbook ergänzen. Querschnittsmuster immer im Code mit // PATTERN markieren.
7 - Build-Qualität und Dokumentation
Phase-Ziel
Architekturtests, Contract Tests, Lizenzbericht, HTML aus allen MD-Dateien, PDF und ZIP erzeugen. AI muss vor Abschluss Linkcheck und ZIP-Test melden.
Ablauf in der Praxis
| Schritt | Codex / Claude Code Aktion | Erwarteter Nachweis |
|---|---|---|
| Lesen | Repository, POMs, README, Projektbeschreibungen und Design Patterns analysieren | kurzer Plan mit betroffenen Dateien |
| Schneiden | eine kleine fachliche oder technische Slice auswählen | Modul- oder Package-Liste |
| Implementieren | Code, Tests und README gemeinsam ändern | mvn test oder nachvollziehbarer lokaler Hinweis |
| Prüfen | Pattern-Marker, Abhängigkeitsrichtung, Links und Lizenz prüfen | Prüfbericht / Konsolenausgabe |
| Dokumentieren | Markdown und HTML aktualisieren | MD + HTML im selben Bereich |
Prompt-Vorlagen
Codex-Phasenprompt
Du bist Codex im Repository. Arbeite phasenweise und ändere nur Dateien, die zur aktuellen Phase gehören. Vorgehen: 1) Lies README, PROJECTS und ../docs/design-patterns.md. 2) Erstelle einen kurzen Plan. 3) Implementiere eine kleine lauffähige Slice. 4) Markiere Entwurfsmuster im Code mit // PATTERN:. 5) Aktualisiere README.md und README.html. 6) Führe mvn test aus oder erkläre ehrlich, warum es lokal nicht möglich war.Claude-Code-Phasenprompt
Du bist Claude Code im Repository. Behandle das Projekt als Enterprise-Lernsystem. Refactore nicht breit, sondern arbeite in kleinen, nachvollziehbaren Phasen. Prüfe Modulabhängigkeiten, halte Domain frei von Frameworkdetails, schreibe kurze README-Abschnitte zu Zweck, Ablauf, Klassen und Pattern und fasse am Ende die geänderten Dateien zusammen.Review-Checkliste
- Baut die aktuelle Phase auf der vorherigen auf?
- Sind Modulabhängigkeiten weiterhin sauber?
- Sind Pattern im Code und in der Doku markiert?
- Gibt es README.md und README.html, wenn ein Bereich neu beschrieben wurde?
- Sind Tests, Linkcheck, Lizenzscan und ZIP-Test ehrlich dokumentiert?
Typische Fehler beim AI-Aufbau
- Zu viele Module in einem Prompt ändern.
- Framework-Code in Domain-Module ziehen.
- Pattern nur behaupten, aber nicht im Code markieren.
- README vergessen oder nur Markdown ohne HTML liefern.
- Tests überspringen und trotzdem Abschluss behaupten.