update README and add CLAUDE.md

Mark linux_apt-upgrade.yaml as work-in-progress in README, add dedicated section for it. Add CLAUDE.md with repo architecture guidance.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

README.md

@@ -6,6 +6,7 @@ Aktuell enthalten:
 
 * `docker_stack_inventory_scan.yaml`
 * `build_select_options.py`
+* `linux_apt-upgrade.yaml` *(in Arbeit)*
 * `.env.example`
 
 Der erste Flow scannt mehrere Docker-Hosts per SSH, sucht nach Docker-Compose-Stacks und schreibt daraus eine Dropdown-Liste in den Kestra KV-Store.
@@ -71,6 +72,14 @@ Diese Datei wird anschließend vom Kestra-Flow in den KV-Store geschrieben.
 
 ---
 
+### `linux_apt-upgrade.yaml` *(in Arbeit)*
+
+Kestra-Flow zum Ausführen von `apt update && apt upgrade` auf einem Linux-Server per SSH.
+
+> **Hinweis:** Dieser Flow befindet sich noch in der Entwicklung und ist noch nicht vollständig implementiert.
+
+---
+
 ### `.env.example`
 
 Beispiel-Datei für benötigte Umgebungsvariablen und Secrets.