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

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/)