Aufgabenmatrix für KI-Agenten

Diese Matrix bestimmt vor einer Änderung, welche Quellen verbindlich sind, wo ein Agent arbeiten darf und welche Abnahme den Auftrag abschließt.

Menschenregel und Maschinenvertrag zusammen prüfen

JSON Schema v1 definiert die Pflichtfelder. Der oben verlinkte Versionsvertrag ist zugleich das gültige vollständige Beispiel.

Gültig

{
  "product": "dbxapp",
  "version": "4.5.3",
  "contract": "ai-task-boundaries",
  "tasks": { "system_module_source": { ... } }
}

Version, Priorität, Ablauf, Aufgaben und Change-Log-Vertrag sind vorhanden.

Ungültig

{
  "product": "dbxapp",
  "tasks": { "system_module_source": {
    "forbidden": []
  } }
}

Version, Vertragsname, Ablauf und verbindliche Schutzgrenzen fehlen.

Validator: php dbx/modules/dbxDocs/tests/dbxDocsAiContract_test.php prüft Schema, Versionsgleichheit, Pflichtaufgaben und verbotene Direktzugriffe. Ein Fehler blockiert die Dokumentationsabnahme.

Aufgabe zuerst klassifizieren

Aufgabe	Pflichtquellen	Erlaubter Scope	Verboten	Mindestabnahme
Menü / Kundeninhalt	AGENTS.md, betroffene Installation, Menütemplate	Nur die benannte Installation	Produktquelle, Versionsänderung, Updatepaket	Desktop, Mobil, aktive Zustände, Links
System- oder Modulcode	AGENTS.md, Modulhandbuch, Architektur, betroffene DD/FD	Entwicklungsquelle und vorgesehenes Modul	Kundendaten, parallele Framework-Lösung	Syntax, Modulvertrag, relevante Tests, SelfTest
Design	Design-KI, Designvertrag, bestehende Tokens und Templates	Ausgewähltes Design oder freigegebenes Bundle	Inline-Sonderwege, Core-Kopien, fremde Designs	Hell/Dunkel, responsive, Fokus, Kontrast
CMS / Dokumentation	Dokumentationsstandard, Zielgruppenseite, kanonische Quelle	CMS-Inhalt und Dokumentationsinstallation	Doppelte Quellen, unversionierte Aussagen, lokale Pfade	Metadaten, TOC, interne Links, Suche, HTTP 200
Datenmodell	dbxDB/DD/FD, Modulhandbuch, vorhandener DD-Sync-Pfad	Vollständige DD/FD und kontrollierte DD→DB-Synchronisierung	PDO, mysqli, SQLite3 oder native Treiber in Produkt-, Modul-, KI-, Migrations-, Testhilfs- und Werkzeugcode; unbestätigte Datenübernahme	dbxDB/DD-Vertrag, Sync, Roundtrip, Rückrollbarkeit
Release / Update	Updatevertrag, VERSION, Manifest, Release Notes	Erst nach vollständiger Freigabe	Vorzeitiges Abdaten, myX, Dokumentation als Produktupdate	Update von Vorversion, Integrität, Rollback, SelfTest

Verbindlicher Agentenablauf

Klassifizieren: Kundeninhalt, Systemquelle, Dokumentation oder Release bestimmen.
Quellen lesen: Alle Pflichtquellen der Zeile vollständig lesen.
Scope festhalten: Zielpfade und ausdrücklich ausgeschlossene Bereiche nennen.
Ändern: Bestehende Verträge und Framework-Komponenten wiederverwenden.
Prüfen: Mindestabnahme plus risikobasierte Regressionstests ausführen.
Protokollieren: Nach Erfolg genau einen Change-Log-Eintrag für den logischen Block schreiben; Vorschau, Fehler und Rollback nicht protokollieren.
Berichten: Ergebnis, Tests, bekannte Grenzen und das gespeicherte change_log-JSON ausweisen.

Vorrang und Gültigkeit

Explizite Benutzeranweisungen haben Vorrang. Danach gelten installationsnahe AGENTS.md-Regeln, anschließend der Aufgabenvertrag und die fachlichen Handbücher. Der JSON-Vertrag trägt dieselbe Version wie die öffentlich verfügbare dbxapp-Version.