[Agent-Fehler] Ordner im Projekt-Root statt WORKING/TOOLS/ angelegt

[ogerly]

Problem

Agenten legen Ordner im Projekt-Root an, anstatt den bereits vorhandenen Workspace-Ordner WORKING/TOOLS/ zu nutzen.

Konkreter Fall (PAX Festival 2026):

• Commit 22a4a27 (2026-04-16): Agent erstellt tools/ direkt im Projekt-Root mit Python-Skripten und Excel-Dateien
• Commit 77f3f53 (2026-04-17): Zweiter Agent (GitHub Copilot) verschiebt weitere Dateien nach tools/ — anstatt den Fehler zu korrigieren, verstetigt er ihn

Dabei existierte WORKING/TOOLS/ bereits (mit .gitkeep), war aber von keinem der Agenten konsultiert worden.

Ursache

Das AAMS-Framework definiert in AGENTS.md:

Mandatory Agent Behaviour: On Every Session Start — Read READ-AGENT.md, Read WORKING/MEMORY/ltm-index.md

Beide Agenten haben die Workspace-Struktur (WORKING/) nicht ausreichend geprüft, bevor sie neue Ordner angelegt haben. Es fehlt eine explizite Regel, die besagt:

Vor dem Anlegen eines neuen Ordners im Root muss geprüft werden, ob ein passender Ordner unter WORKING/ bereits existiert.

Lösungsvorschlag

In AGENTS.md unter Mandatory Agent Behaviour eine zusätzliche Regel ergänzen:

`markdown

Before Creating Any New Directory

• NEVER create utility/tool/script folders in the project root
• Check WORKING/ structure first — WORKING/TOOLS/ is the designated location for helper scripts, templates, and dev utilities
• Only create root-level folders if they serve a direct production purpose (e.g., src/, public/, dist/)
  `

Zusätzlich: In READ-AGENT.md die Ordnerstruktur mit einem kurzen Kommentar zu jedem WORKING/-Unterordner dokumentieren, damit Agenten beim Lesen direkt verstehen, was wohin gehört.

Betroffene Commits

• 22a4a27 — tools/ erstellt im Root (erster Agent)
• 77f3f53 — Datei nach tools/ verschoben (zweiter Agent, Fehler verewigt)

Labels

bug, agent-behaviour, AAMS