feat: copilot-update Schritt 4c – fehlende 3-Zielgruppen-Docs anlegen

docs/ADMIN.md

@@ -123,6 +123,7 @@ git copilot-update
 | 3 | VS Code Prompt-Dateien aktualisieren | `~/.vscode-server/.../prompts/` |
 | 4a | `.git/hooks/pre-commit` aktualisieren | nur wenn Repo vorhanden |
 | 4b | `.github/copilot-instructions.md` Framework-Sektion aktualisieren | Projekt-Teil (ab `---`) bleibt unberührt |
+| 4c | Fehlende `docs/USER.md`, `docs/ADMIN.md`, `docs/MAINTAINER.md` anlegen | nur wenn `docs/` vorhanden + Datei fehlt; überschreibt nie |
 
 > **Wichtig:** Die `.github/copilot-instructions.md` besteht aus zwei Teilen:
 > - **Framework-Sektion** (vor `---`): Session-Protokoll, Verbotene Aktionen → wird bei jedem Update überschrieben

history/prompts/2026-06-03_pre-commit-check6-session-pflicht_session.md

@@ -378,3 +378,51 @@ git copilot-update
 #   === Done ===
 ```
 
+### Prompt 17
+„schau dir mal das repo rd13_tile_server ganau an und schau nach ob auch wirklich alles nach dem git copilot-update funktioniert hat. Ich habe das gefühl da fehlen sachen..."
+
+### Antwort 17
+Analyse rd13_tile_server:
+```
+ls /mnt/services-data/rd13_tile_server/.github/
+# → copilot-instructions.md  (vorhanden, Jun 3 10:02 ✓)
+
+ls /mnt/services-data/rd13_tile_server/.git/hooks/
+# → post-commit (no-op ✓)  pre-commit (9705 bytes, Jun 3 10:02 ✓)
+
+ls /mnt/services-data/rd13_tile_server/docs/
+# → api-endpoints.md  homeassistant-config.md  mediawiki-config.php  nextcloud-config.md
+# → USER.md FEHLT  ADMIN.md FEHLT  MAINTAINER.md FEHLT  ✗
+
+ls /mnt/services-data/rd13_tile_server/.copilot-no-tests 2>/dev/null
+# → FEHLT  ✗  (Check 1 würde bei Code-Commits blocken)
+
+grep -n "TODO" /mnt/services-data/rd13_tile_server/.github/copilot-instructions.md
+# → Projekt-Sektion leer (alle TODO-Platzhalter) – erwartet, noch nicht ausgefüllt
+```
+
+**Gefundene Probleme:**
+1. `docs/USER.md`, `docs/ADMIN.md`, `docs/MAINTAINER.md` fehlen → Check 2+3 würde blocken
+2. `.copilot-no-tests` fehlt → Check 1 würde bei Code-Commits blocken
+3. `copilot-update` erstellt fehlende Docs nicht (Lücke im Script)
+
+**Fixes:**
+```
+# 1. Docs + opt-out im rd13_tile_server direkt anlegen:
+cp git-templates/docs/USER.md /mnt/services-data/rd13_tile_server/docs/
+cp git-templates/docs/ADMIN.md /mnt/services-data/rd13_tile_server/docs/
+cp git-templates/docs/MAINTAINER.md /mnt/services-data/rd13_tile_server/docs/
+touch /mnt/services-data/rd13_tile_server/.copilot-no-tests
+```
+
+Syntax-Check:
+```
+sh -n scripts/copilot-update.sh   → sh: OK
+fish -n scripts/copilot-update.fish → fish: OK
+```
+
+`scripts/copilot-update.sh` und `scripts/copilot-update.fish` um Schritt 4c erweitert:
+- Nach 4b: Wenn `docs/` vorhanden und `USER.md`/`ADMIN.md`/`MAINTAINER.md` fehlen → Templates anlegen
+- Vorhandene Dateien werden nie überschrieben
+`docs/ADMIN.md` Schritttabelle um Schritt 4c ergänzt.
+

history/summary/PROJECT_CONTEXT.md

@@ -8,7 +8,7 @@
 
 ## Aktueller Projektstatus
 
-**Letzte Aktualisierung:** 2026-06-03 – copilot-update.sh/.fish Syntax-Fix + git copilot-update verifiziert OK
+**Letzte Aktualisierung:** 2026-06-03 – copilot-update Schritt 4c: fehlende 3-Zielgruppen-Docs auto-anlegen
 **Phase:** Produktion / stabil – wird bei Bedarf erweitert
 
 ---

scripts/copilot-update.fish

@@ -158,6 +158,21 @@ else
     echo "  ─ .github/copilot-instructions.md nicht vorhanden, übersprungen"
 end
 
+# ── 4c. Fehlende 3-Zielgruppen-Docs anlegen (nur wenn noch nicht vorhanden) ──
+if test -d $REPO_ROOT/docs
+    set DOCS_CREATED 0
+    for doc in USER.md ADMIN.md MAINTAINER.md
+        if not test -f $REPO_ROOT/docs/$doc; and test -f $GIT_TEMPLATE_DIR/docs/$doc
+            cp $GIT_TEMPLATE_DIR/docs/$doc $REPO_ROOT/docs/$doc
+            echo "  ✓ docs/$doc angelegt (Template)"
+            set DOCS_CREATED (math $DOCS_CREATED + 1)
+        end
+    end
+    if test $DOCS_CREATED -eq 0
+        echo "  ─ docs/ 3-Zielgruppen-Docs bereits vorhanden"
+    end
+end
+
 echo ""
 echo "=== Done ==="
 echo "Tipp: 'git copilot-update' jederzeit ausführen um Templates aktuell zu halten."

scripts/copilot-update.sh

@@ -162,6 +162,22 @@ else
     echo "  ─ .github/copilot-instructions.md nicht vorhanden, übersprungen"
 fi
 
+# ── 4c. Fehlende 3-Zielgruppen-Docs anlegen (nur wenn noch nicht vorhanden) ──
+# Überschreibt nie vorhandene Dateien – nur initial anlegen
+if [ -d "$REPO_ROOT/docs" ]; then
+    DOCS_CREATED=0
+    for doc in USER.md ADMIN.md MAINTAINER.md; do
+        if [ ! -f "$REPO_ROOT/docs/$doc" ] && [ -f "$GIT_TEMPLATE_DIR/docs/$doc" ]; then
+            cp "$GIT_TEMPLATE_DIR/docs/$doc" "$REPO_ROOT/docs/$doc"
+            echo "  ✓ docs/$doc angelegt (Template)"
+            DOCS_CREATED=$((DOCS_CREATED + 1))
+        fi
+    done
+    if [ "$DOCS_CREATED" -eq 0 ]; then
+        echo "  ─ docs/ 3-Zielgruppen-Docs bereits vorhanden"
+    fi
+fi
+
 echo ""
 echo "=== Done ==="
 echo "Tipp: 'git copilot-update' jederzeit ausführen um Templates aktuell zu halten."