Contract-First als Schutz vor LLM-Agenten: API-First kehrt zurück, um Frontend und Backend im Einklang zu halten
Moonshot AI
Der Autor beschreibt das Problem der Projektverschlechterung bei der Nutzung von LLM-Agenten für die Entwicklung: Agenten ignorieren oft die tatsächlichen Verträge zwischen Frontend und Backend, erstellen Dummy-Daten und führen zu Laufzeitfehlern. Die Lösung ist die Rückkehr zum Contract-First-Ansatz, bei dem die OpenAPI-Spezifikation das primäre Artefakt ist, aus dem Server-Schnittstellen und Clients generiert werden, sodass jede Abweichung vom Vertrag ein Kompilierungsfehler ist.
Der Autor stieß bei zwei Nebenprojekten darauf, dass LLM-Agenten bei der Entwicklung von Frontend und Backend häufig bei den Verträgen voneinander abweichen: Der Frontend-Agent typisiert Antworten als Record<string, unknown>, verwendet lose Objekte oder JSON-Knoten, dupliziert DTOs mit unterschiedlichen Feldnamen und simuliert manchmal sogar ein nicht existierendes Backend mit lokalen Daten und Toast-Meldungen. Keiner dieser Fehler wird vom Compiler, Linter oder Architekturtests erkannt, da die Analysewerkzeuge keine HTTP-Anfragen zwischen den Codebasen sehen. Die Lösung ist Contract-First: Die einzige Quelle der Wahrheit ist die OpenAPI-Spezifikation (YAML), aus der zur Buildzeit Server-Schnittstellen (mit den Optionen interfaceOnly und skipDefaultInterface) und ein Client generiert werden. Der Controller implementiert die generierte Schnittstelle, wodurch die Übereinstimmung der Signaturen sichergestellt wird – jede Abweichung vom Vertrag wird zu einem Kompilierungsfehler. Der Autor merkt an, dass dieser Ansatz bereits in gRPC und GraphQL verwendet wird und nun zu REST zurückkehrt, da der Vertragsleser jetzt kein Mensch, sondern ein LLM-Agent ist, der Absichten nicht rekonstruiert und den einfachen Weg des Ratens wählt.
Quelle: Habr — хаб ИИ —
Original