asv-format-validator/AGENTS.md

ASV-Format-Validator

Projektüberblick

• Java-/Maven-Projekt zur Validierung segmentorientierter Dateien gegen eine fachliche ASV-Spezifikation.
• Bestehenden Projektstand respektieren und darauf aufbauen.
• Keine Neuarchitektur.

Technik

• Java 21
• Maven
• Log4j2
• kein Spring Boot

Architektur- und Arbeitsregeln

• Nur kleine, kontrollierte Änderungen.
• Pro Arbeitsschritt genau eine kleine fachliche Regel oder eine eng abgegrenzte Stabilisierung.
• Kein Parser-Umbau ohne ausdrückliche Anweisung.
• Keine EDIFACT-Neuinterpretation auf Verdacht.
• Keine neue Validator-Hierarchie auf Verdacht.
• Keine Refactorings auf Verdacht.
• Bereits vorhandene Regeln und Tests dürfen nicht semantisch verbogen werden.
• Bestehende Funktionalität darf nicht verschlechtert werden.

Parser-Leitplanken

• Aktuelle Parser-Annahmen respektieren.
• Keine zusätzliche Zerlegung von Feldwerten, außer ein bestehender Test und der aktuelle Projektstand erzwingen eine eng begrenzte lokale Korrektur.
• Keine allgemeine Normalisierung einführen, wenn nur ein lokaler Sonderfall benötigt wird.

Code-Stil

• Technische Bezeichner auf Englisch.
• Kommentare, JavaDoc und benutzernahe Fehlermeldungen auf Deutsch.
• Vollständigen, kompilierbaren Code liefern.
• Änderungen minimal halten.

Test- und Qualitätsregeln

• Nach jeder Änderung vollständig testen.
• Standardbefehl: mvn clean test
• Wenn Tests fehlschlagen:
  • zuerst alle fehlgeschlagenen Tests gemeinsam analysieren
  • gemeinsame Ursachen clustern
  • dann alle zugehörigen Fehler in einem sauberen Durchgang beheben
  • keine Fehler-für-Fehler-Mini-Iterationen
• Wenn neue Tests ergänzt werden:
  • Testdaten fachlich isoliert halten
  • keine unnötigen Zusatzfehler provozieren

Änderungsschwerpunkte

• Bevorzugt bestehende Klassen gezielt ergänzen.
• Neue Klassen nur, wenn technisch wirklich nötig und klein.
• Für Validator-Schritte bevorzugt im bestehenden DefaultStructureValidator ergänzen, solange kein ausdrücklicher Architekturwechsel gefordert ist.

Ausgabeerwartung

• Zuerst den ausgeführten Maven-Befehl nennen.
• Danach kurzes Testergebnis.
• Danach kurze Liste der geänderten Dateien.
• Danach vollständigen Code aller tatsächlich geänderten Dateien.
• Keine langen Erklärungen.