Projekt-Glossar: Agent-Kontext-Paket

Stellt einem KI-Coding-Agenten die Fakten, Regeln, Grenzen und Beispiele bereit, die benötigt werden, um das Projekt-Glossar konsistent anzuwenden. Es legt Annahmegrenzen und beobachtbare Fehlerbelege fest und hält gleichzeitig umgebungsspezifische Limits konfigurierbar.

Paketstatus: Referenzkontext bereit zur menschlichen Überprüfung. Der Vertrag und die Testszenarien sind vollständig, es wird jedoch nicht behauptet, dass eine übernehmende Implementierung diese bestanden hat.

Entscheidung

Für das Projekt-Glossar wird eine versionskontrollierte Repository-Anweisung angenommen, die nach Pfad und Aufgabe abgegrenzt ist. Das Verhalten wird durch einen autoritativen Schreibpfad, typisierte Schnittstellen, expliziten Zustand und idempotente Nebenwirkungsbehandlung implementiert. Dieses Paket ist ein Referenzvertrag: Das übernehmende Team muss numerische Limits, Anbieter, Rechtsräume und operative Verantwortliche anhand von Belegen in der eigenen Umgebung auswählen.

Umfang

• Die Projekt-Glossar-Akteure, Eingaben, Ausgaben, Zustände, Richtlinien- oder Schema-Versionen und extern sichtbaren Ergebnisse, die durch diesen Implementierungsblock beschrieben werden.
• Primäre und alternative Schnittstellen, Hintergrundarbeiten, Caches, Integrationen, Support-Pfade und Belege, die dieselbe Grenze ausüben können.
• Übernahmespezifische Konfiguration, Rollout, Wiederherstellung und Verifikationsverantwortlichkeiten, die für eine sichere Anwendung der Referenz erforderlich sind.

Außerhalb dieses Blocks

• Die Wahl eines universellen Anbieters, Frameworks, Rechtsraums, numerischen Schwellenwerts, Aufbewahrungszeitraums oder Service-Level-Objectives für jeden Übernehmer.
• Die Behauptung, dass verpackte Szenarien gegen eine nachgelagerte Implementierung ausgeführt wurden oder dass diese Referenz rechtliche, Sicherheits- oder Barrierefreiheitszertifizierungen gewährt.

Vertrag

• Deklariere Anweisungspriorität, anwendbare Pfade, erforderliche Prüfungen, verbotene Änderungen und die erwarteten Belege bei der Übergabe.
• Leite Befehle, Versionen, Architektur und Dateistandorte aus Repository-Quellen ab, nicht aus Speicher oder einem benachbarten Projekt.
• Halte ausführbare Verifikationen getrennt von Prosa-Behauptungen und zeichne auf, wenn eine Prüfung nicht durchgeführt oder nicht abgeschlossen werden konnte.
• Fordere den Agenten auf, nicht zusammenhängende Änderungen zu bewahren und anzuhalten, wenn Anmeldeinformationen, zerstörerischer Umfang oder Produktbefugnis fehlen.
• Validieren Eingaben einmal an der Grenze und bewahre die normalisierte Darstellung, die von nachgelagerter Logik verwendet wird.
• Speichere den Geschäftstransition vor oder atomar mit einem Outbox-Datensatz; Verbraucher deduplizieren anhand einer dauerhaften Operationsidentität.
• Verleihe jedem Projektbegriff ein bevorzugtes Label, eine präzise Definition, Kontext, Nicht-Beispiele, Aliase, veraltete Namen, Eigentümer, wirksame Version und Links zu den Schemata oder Richtlinien, in denen er durchgesetzt wird.
• Erkenne widersprüchliche Bedeutungen über Produkt-, Engineering-, Analyse-, Support- und Rechtskontexte hinweg, löse sie explizit und überprüfe abhängige Dokumentationen bei einer Definitionsänderung.

Implementierungsleitfaden

• Liefere additive Speicher- und Schnittstellenänderungen zuerst aus, fülle sie beobachtbar nach, und stelle alte Pfade nach Kompatibilitätsnachweis ein.
• Modelle Projekt-Glossar-Eingaben, -Ausgaben, Akteure, Zustände, Invarianten, Nebenwirkungen und Belege, bevor Framework- oder Anbieterdetails ausgewählt werden.
• Speichere die anwendbare Projekt-Glossar-Vertrags- oder Richtlinienversion mit materiellem Zustand, damit Migrationen, Wiedergabe und Supportentscheidungen zuordenbar bleiben.
• Führe den Pfad hinter kontrolliertem Rollout ein, vergleiche erwartete und beobachtete Ergebnisse und halte eine getestete Wiederherstellungsroute, bis Übernahmebelege vollständig sind.

Fehlerbehandlung und Schutzmaßnahmen

• Widersprüchlicher oder veralteter Kontext wird als Blocker mit genauen Quellen angezeigt; der Agent erfindet keinen Tiebreaker, der das Projektverhalten ändert.
• Ungültiger oder widersprüchlicher Projekt-Glossar-Zustand wird abgelehnt oder isoliert; die Implementierung schätzt niemals einen Wert, der Befugnisse erweitert oder Effekte dupliziert.
• Wiederholungen sind begrenzt und verwenden dauerhafte Identität; nach Erschöpfung erreicht die Arbeit einen überprüfbaren Endzustand mit verantwortlichem Eigentümer.

Verifikation und Betrieb

• Simuliere Abhängigkeitsfehler vor und nach der Persistenz und beweise, dass Wiederholungen auf ein extern sichtbares Ergebnis konvergieren.
• Überwache Projekt-Glossar-Erfolg, Ablehnung, Validierungsfehler, Abhängigkeitsfehler, Wiederholungsermüdung und Wiederherstellung nach Vertragsversion ohne sensible Nutzlastdimensionen.
• Führe gepaarte positive und negative Fixtures nach Richtlinien-, Schema-, Abhängigkeits-, Migrations- oder Grenzänderungen erneut aus und bewahre die resultierenden Belege.

Übernahmeannahmen

• Namen und Werte im Beispiel sind ein konkretes Fixture, keine universellen Standardwerte; Übernehmer ersetzen sie durch dokumentierte Belege und Eigentümerschaft.
• Das übernehmende System kann authentifizierte Identität, dauerhafte Operationen- oder Datensatzversionen, begrenzte Telemetrie und einen kontrollierten Änderungsweg bereitstellen.

Die ausführbar wirkenden Beispiele in diesem Paket sind Fixtures und Akzeptanzverträge. Führe den Sammlungsvalidator aus, um Struktur und Metadaten zu prüfen, übersetze und führe dann die Szenarien im Ziel-Repository aus, bevor Implementierungsbelege aufgezeichnet werden.