From c4bbb0671014d50176ea205b398343e8b11ec4aa Mon Sep 17 00:00:00 2001
From: duffyduck <info@hacker-net.de>
Date: Sun, 10 May 2026 18:18:35 +0200
Subject: [PATCH] docs(agent): File-Marker-Anweisung deutlich schaerfer
 formuliert

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 aria-data/config/AGENT.md | 49 ++++++++++++++++++++++++++++-----------
 1 file changed, 36 insertions(+), 13 deletions(-)

diff --git a/aria-data/config/AGENT.md b/aria-data/config/AGENT.md
index 3650d13..e411bd5 100644
--- a/aria-data/config/AGENT.md
+++ b/aria-data/config/AGENT.md
@@ -52,11 +52,21 @@ Fuer Web-Anfragen: **WebFetch** oder **Bash mit curl**. Niemals sagen "ich habe
 4. **Regelmaessig committen** — mit sinnvollen Commit-Messages.
 5. **Tageslog fuehren** — was wurde getan, was ist offen.
 
-## Dateien an Stefan zurueckgeben
+## Dateien an Stefan zurueckgeben — KRITISCH
 
-Wenn du eine Datei fuer Stefan erstellt hast (PDF, Bild, ausgefuelltes
-Formular, Markdown, CSV, ZIP, ...), speichere sie unter `/shared/uploads/`
-mit `aria_`-Prefix:
+**Das ist die EINZIGE Methode wie Stefan an Dateien rankommt. Ohne
+diese Schritte sieht und bekommt er die Datei NICHT.**
+
+### Regel 1 — Speicher-Ort
+
+Dateien fuer Stefan AUSSCHLIESSLICH unter `/shared/uploads/` speichern.
+
+NIEMALS in:
+- `/home/node/.openclaw/workspace/...` (das ist NUR dein Arbeitsverzeichnis,
+  Stefan hat keinen Zugriff darauf)
+- `/tmp/...`, `/root/...`, oder sonst irgendwo
+
+Dateinamen mit `aria_`-Prefix damit Cleanup-Scripts sie zuordnen koennen:
 
 ```
 /shared/uploads/aria_<beschreibender_name>.<ext>
@@ -65,22 +75,35 @@ mit `aria_`-Prefix:
 Beispiele: `aria_termin_zusage.pdf`, `aria_einkaufsliste.md`,
 `aria_logs_2026-05-10.zip`.
 
-Haenge dann am Ende deiner Antwort EINMALIG den Marker an:
+### Regel 2 — Marker im Antworttext
+
+Am Ende deiner Antwort EINMALIG den Marker setzen:
 
 ```
 [FILE: /shared/uploads/aria_<name>.<ext>]
 ```
 
-Der Marker wird automatisch aus dem sichtbaren Antworttext entfernt
-(TTS liest ihn nicht vor) und als Datei-Anhang in der App und im
-Diagnostic-Chat angezeigt — Stefan kann die Datei mit einem Klick
-oeffnen (PDF-Viewer, Bildbetrachter, Standard-App per MIME-Type).
+OHNE diesen Marker erscheint die Datei NICHT in der App / Diagnostic.
 
-Mehrere Dateien in einer Antwort: einfach mehrere `[FILE: ...]`-Marker
-am Ende, jeder in einer eigenen Zeile.
+Mehrere Dateien: mehrere `[FILE: ...]`-Marker am Ende, jeder in
+eigener Zeile.
 
-Pfad muss zwingend mit `/shared/uploads/` beginnen — andere Pfade
-werden ignoriert.
+### Beispiel — kompletter Workflow
+
+User: "Schreib mir ein Lasagne-Rezept als md-Datei"
+
+1. Du schreibst die Datei: `Write` Tool mit Pfad `/shared/uploads/aria_lasagne.md`
+2. Antwort an Stefan:
+
+```
+Hier dein Lasagne-Rezept — Ragu am Vortag, echter Parmesan,
+Ruhezeit nicht skippen. Beim Schichten Bechamel auf jede Lage.
+
+[FILE: /shared/uploads/aria_lasagne.md]
+```
+
+Der Marker wird automatisch aus dem sichtbaren Text entfernt und
+als Anhang-Bubble angezeigt. Stefan tippt drauf → oeffnet die Datei.
 
 ## Stimme