docs: add moonarch-doctor and shorthand aliases to README and CLAUDE.md

CLAUDE.md

@@ -38,6 +38,17 @@ Waybar wird über `moonarch-waybar` gestartet (nicht direkt). Der Wrapper merged
 - Benötigt `jq` (in PKGBUILD als Dependency)
 - System-Config muss valides JSON sein (kein JSONC)
 
+## System Health Check (moonarch-doctor / moondoc)
+
+Diagnose-Script das den Systemzustand gegen moonarch-Defaults prüft:
+- Pakete (official.txt + aur.txt installiert? Orphans?)
+- System-Services (NetworkManager, bluetooth, greetd, ufw, auto-cpufreq, etc.)
+- User-Services (kanshi, stasis, cliphist-text, cliphist-image)
+- Config-Dateien (SHA256-Vergleich deployed vs. moonarch-Default)
+- Helper-Scripts + Symlinks (moonup, moondoc)
+- System-Config (UFW, Pacman/Paru Repos, Default Shell)
+- Verzeichnisse + Permissions
+
 ## Konventionen
 
 - Paketlisten sind einfache Textdateien, ein Paket pro Zeile, Kommentare mit `#`

README.md

@@ -86,13 +86,23 @@ The script will:
 ### Update
 
 ```bash
-moonarch-update
+moonup   # or: moonarch-update
 ```
 
 Interactive updater that upgrades system and AUR packages, reconciles package lists
 against what's installed, and cleans orphaned packages. Config deployment happens
 automatically via the moonarch-git package on `paru -Syu`.
 
+### Health Check
+
+```bash
+moondoc   # or: moonarch-doctor
+```
+
+Diagnostic tool that verifies the system state against moonarch defaults: services,
+configs, packages, helper scripts, firewall, shell and directory permissions. Reports
+pass/fail/warn per check with a summary at the end.
+
 ## Project Structure
 
 ```
@@ -107,7 +117,8 @@ scripts/
   lib.sh                        Shared helpers sourced by all scripts
   post-install.sh               Main automation (packages, configs, themes, services)
   transform.sh                  Convert existing Arch+Wayland system to Moonarch
-  moonarch-update               Interactive updater (deployed to /usr/bin/ by package)
+  moonarch-update               Interactive updater (deployed to /usr/bin/ as moonup)
+  moonarch-doctor               System health checker (deployed to /usr/bin/ as moondoc)
 
 defaults/
   xdg/                          System-wide XDG configs (deployed to /etc/xdg/)