Bekannte Einschränkungen: Agent-Kontext-Paket

Versorgt einen KI-Coding-Agenten mit Fakten, Regeln, Grenzen und Beispielen, die benötigt werden, um bekannte Einschränkungen konsistent anzuwenden. Es legt Übernahmegrenzen und beobachtbare Fehlernachweise fest und hält gleichzeitig umgebungsspezifische Limits konfigurierbar.

Paketstatus: Referenzkontext bereit für menschliche Ü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 bekannte Einschränkungen werden versionskontrollierte Repository-Anweisungen übernommen, die nach Pfad und Aufgabe abgegrenzt sind. 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 Grenzen, Anbieter, Rechtsordnungen und operative Verantwortliche anhand von Nachweisen in der eigenen Umgebung auswählen.

Umfang

• Die bekannten Einschränkungen betreffenden 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 Nachweise, die dieselbe Grenze ausüben können.
• Übernahmespezifische Konfiguration, Rollout, Wiederherstellung und Verifikationsverantwortlichkeiten, die benötigt werden, um die Referenz sicher anzuwenden.

Außerhalb dieses Blocks

• Die Wahl eines universellen Anbieters, Frameworks, einer Rechtsordnung, numerischer Schwellenwerte, Aufbewahrungsfristen oder Service-Level-Objectives für jeden Übernehmer.
• Die Behauptung, dass verpackte Szenarien gegen eine nachgelagerte Implementierung ausgeführt wurden oder dass diese Referenz eine rechtliche, sicherheitsrelevante oder barrierefreie Zertifizierung gewährt.

Vertrag

• Deklariere Anweisungspriorität, anwendbare Pfade, erforderliche Prüfungen, verbotene Änderungen und die erwarteten Nachweise bei Übergabe.
• Leite Befehle, Versionen, Architektur und Dateistandorte aus Repository-Quellen ab, nicht aus dem Speicher oder einem benachbarten Projekt.
• Halte ausführbare Verifikationen getrennt von Prosa-Behauptungen und zeichne auf, wenn eine Prüfung nicht ausgefü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 Sie Eingaben einmal an der Grenze und bewahren Sie die normalisierte Darstellung, die von nachgelagerter Logik verwendet wird.
• Speichere die geschäftliche Transition vor oder atomar mit einem Outbox-Datensatz; Verbraucher deduplizieren anhand einer dauerhaften Operationsidentität.
• Beschreibe jede Einschränkung mit betroffenem Umfang, Auslöser, Benutzerwirkung, Erkennung, sicherem Workaround, Eigentümer, Nachweis, Überprüfungsdatum und der Bedingung, die sie schließen würde.
• Mache wesentliche Einschränkungen in Planungs- und Übergabekontext sichtbar und verwandle niemals eine unbestätigte Annahme oder fehlenden Test in eine implizite Behauptung unterstützten Verhaltens.

Implementierungsleitfaden

• Liefere additive Speicher- und Schnittstellenänderungen zuerst, fülle sie beobachtbar nach, und stelle alte Pfade nach Kompatibilitätsnachweis ein.
• Modelle Eingaben, Ausgaben, Akteure, Zustände, Invarianten, Nebenwirkungen und Nachweise bekannter Einschränkungen, bevor Framework- oder Anbieterdetails ausgewählt werden.
• Speichere die anwendbare Version des Vertrags oder der Richtlinie bekannter Einschränkungen mit wesentlichem 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 Übernahme-Nachweise vollständig sind.

Fehlerbehandlung und Schutzmaßnahmen

• Konfliktierende oder veraltete Kontexte werden als Blocker mit genauen Quellen angezeigt; der Agent erfindet keinen Tiebreaker, der das Projektverhalten ändert.
• Ungültiger oder widersprüchlicher Zustand bekannter Einschränkungen 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 inspizierbaren Endzustand mit verantwortlichem Eigentümer.

Verifikation und Betrieb

• Injezieren Sie Abhängigkeitsfehler vor und nach der Persistenz und beweisen Sie, dass Wiederholungen auf ein einziges extern sichtbares Ergebnis konvergieren.
• Überwachen Sie Erfolg, Ablehnung, Validierungsfehler, Abhängigkeitsfehler, Wiederholungsermüdung und Wiederherstellung bekannter Einschränkungen nach Vertragsversion ohne sensible Nutzlastdimensionen.
• Führen Sie gepaarte positive und negative Fixtures nach Richtlinien-, Schema-, Abhängigkeits-, Migrations- oder Grenzänderungen erneut aus und bewahren Sie die resultierenden Nachweise.

Übernahmeannahmen

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

Die ausführbar aussehenden Beispiele in diesem Paket sind Fixtures und Akzeptanzverträge. Führen Sie den Sammlungsvalidator aus, um Struktur und Metadaten zu prüfen, übersetzen und führen Sie dann die Szenarien im Ziel-Repository aus, bevor Sie Implementierungsnachweise aufzeichnen.