🏕️ Field-Report
Im Rahmen eines Echtzeit-Einsatzes durch Antigravity (und Claude Opus) am Projekt PAX Festival kam es zu einer kritischen Überschreitung der Projektstruktur.
Eine Pipeline für die Datengenerierung (excel-to-json.py) wurde in der Vergangenheit umstrukturiert und vom Root-Verzeichnis (/tools/) in den logistischen Agent-Arbeitsbereich (/WORKING/TOOLS/) verschoben.
Ein KI-Agent (diesem Report zugrunde gelegt) führte das Tool unmodifiziert aus, ohne dessen statisch verankerten Pfad-Hierarchien an die neue Position anzupassen. Die Ausführung verschmutzte den AAMS-Namespace fälschlicherweise mit Applikations-Duplikaten.
🐛 Bug-Report
Ursache: Architektur-Bug im betroffenen Python-Werkzeug. Das Root-Verzeichnis war via hartcodierter Relation iterativ verknüpft:
ROOT = Path(__file__).resolve().parent.parent
Durch den Umzug in den tieferen Ordner /WORKING/TOOLS/ löste dieser hardcodierte Pointer fälschlicherweise das Agent-Memory Verzeichnis /WORKING/ als Wurzelverzeichnis der Front-End-Applikation auf.
Resultat: Das Python-Tool speicherte alle JSON-Exporte nicht in den Verzeichnissen der Live-App (/public/data & /src/assets/), sondern kreierte diese Struktur komplett neu innerhalb des Agenten-Arbeitsordners (/WORKING/public/...). Live-Daten wurden somit von der Vue-Frontend Applikation entkoppelt und das AAMS-System fragmentiert.
💡 Refactor Vorschlag (Regelwerk)
Eine isolierte Ausführung umstrukturierter interner Systeme durch Agenten gefährdet die Integrität (Modell: "Tool Decay"). Die Fehlervermeidung erfordert zwingend eine Modernisierung im Framework-Kontext:
-
Pre-Flight Inspection (Agent Protocol)
Alle autonomen Agenten müssen zwingend instruiert werden, interne Executables vor der Ausführung zu validieren. Bei Fund eines relativen Verknüpfungspfads (../, .parent) muss die Systemintegrität auf Richtigkeit geprüft und erst nach Validierung ausgeführt oder das Skript gepatched werden.
-
Self-Healing Root Anchors (Code Standard)
AAMS-kompatible Tools dürfen keine fragilen Offset-Relative Paths verwenden. Skripte müssen dynamisch zur Root-Erkennung kalibriert werden (z. B. durch rekursives Suchen einer package.json, .git oder expliziter Konfig).
-
Integritäts-Tools ("AAMS Doctor")
Einbindung eines Standard-Skripts zur regelmäßigen Verifizierung (validate_tools.py), das verwaiste Pfade, ungültige Tool-Verknüpfungen und inkonsistente Verzeichnisse systematisch scannt und warnt.
Dieses Issue wurde durch direkten Befehl automatisch von einem autonomen Agenten eskaliert.
🏕️ Field-Report
Im Rahmen eines Echtzeit-Einsatzes durch Antigravity (und Claude Opus) am Projekt PAX Festival kam es zu einer kritischen Überschreitung der Projektstruktur.
Eine Pipeline für die Datengenerierung (
excel-to-json.py) wurde in der Vergangenheit umstrukturiert und vom Root-Verzeichnis (/tools/) in den logistischen Agent-Arbeitsbereich (/WORKING/TOOLS/) verschoben.Ein KI-Agent (diesem Report zugrunde gelegt) führte das Tool unmodifiziert aus, ohne dessen statisch verankerten Pfad-Hierarchien an die neue Position anzupassen. Die Ausführung verschmutzte den AAMS-Namespace fälschlicherweise mit Applikations-Duplikaten.
🐛 Bug-Report
Ursache: Architektur-Bug im betroffenen Python-Werkzeug. Das Root-Verzeichnis war via hartcodierter Relation iterativ verknüpft:
ROOT = Path(__file__).resolve().parent.parentDurch den Umzug in den tieferen Ordner
/WORKING/TOOLS/löste dieser hardcodierte Pointer fälschlicherweise das Agent-Memory Verzeichnis/WORKING/als Wurzelverzeichnis der Front-End-Applikation auf.Resultat: Das Python-Tool speicherte alle JSON-Exporte nicht in den Verzeichnissen der Live-App (
/public/data&/src/assets/), sondern kreierte diese Struktur komplett neu innerhalb des Agenten-Arbeitsordners (/WORKING/public/...). Live-Daten wurden somit von der Vue-Frontend Applikation entkoppelt und das AAMS-System fragmentiert.💡 Refactor Vorschlag (Regelwerk)
Eine isolierte Ausführung umstrukturierter interner Systeme durch Agenten gefährdet die Integrität (Modell: "Tool Decay"). Die Fehlervermeidung erfordert zwingend eine Modernisierung im Framework-Kontext:
Pre-Flight Inspection (Agent Protocol)
Alle autonomen Agenten müssen zwingend instruiert werden, interne Executables vor der Ausführung zu validieren. Bei Fund eines relativen Verknüpfungspfads (
../,.parent) muss die Systemintegrität auf Richtigkeit geprüft und erst nach Validierung ausgeführt oder das Skript gepatched werden.Self-Healing Root Anchors (Code Standard)
AAMS-kompatible Tools dürfen keine fragilen Offset-Relative Paths verwenden. Skripte müssen dynamisch zur Root-Erkennung kalibriert werden (z. B. durch rekursives Suchen einer
package.json,.gitoder expliziter Konfig).Integritäts-Tools ("AAMS Doctor")
Einbindung eines Standard-Skripts zur regelmäßigen Verifizierung (
validate_tools.py), das verwaiste Pfade, ungültige Tool-Verknüpfungen und inkonsistente Verzeichnisse systematisch scannt und warnt.Dieses Issue wurde durch direkten Befehl automatisch von einem autonomen Agenten eskaliert.