fix(#18): Dokumentation der reproduzierbaren Runner-Konfiguration

docs/runner-config.md

@@ -0,0 +1,47 @@
+# Codex-Bridge Runner-Konfiguration
+
+## Ziel
+
+Diese Dokumentation beschreibt eine reproduzierbare Konfiguration für den Codex-Bridge Runner, um wiederholte Blocker durch unterschiedliche Pfade und Read-only-Verhältnisse zu vermeiden.
+
+## Soll-Pfadmapping
+
+Das Pfadmapping zwischen dem Host-System und dem Runner-Container ist wie folgt definiert:
+
+- Host: `/home/openclaw/.openclaw/workspace/helpyourneighbour`
+- Container: `/Users/openclaw/workspace/helpyourneighbour`
+
+## Erforderliche Runner-Rechte
+
+Der Runner benötigt folgende Rechte:
+- Schreibzugriff auf das Repository
+- Berechtigung zum Pushen in den `main`-Branch
+
+## Preflight-Check
+
+Bevor ein Codex-Run gestartet wird, muss ein Smoke-Check durchgeführt werden:
+
+1. Prüfen, ob das Repository existiert.
+2. Prüfen, ob der Runner Schreibrechte hat.
+3. Testdatei erstellen und löschen (`touch test && rm test`).
+
+## Beispiel-Smoke-Check
+
+```bash
+#!/bin/bash
+set -e
+
+# Prüfe, ob das Repo existiert
+if [ ! -d ".git" ]; then
+  echo "Fehler: Kein Git-Repo gefunden."
+  exit 1
+fi
+
+# Prüfe Schreibrechte
+touch test && rm test || {
+  echo "Fehler: Keine Schreibrechte im Repository."
+  exit 1
+}
+
+echo "Preflight-Check erfolgreich"
+```