diff --git a/docs/module/Shelly-Modul/README.md b/docs/module/Shelly-Modul/README.md
new file mode 100644
index 0000000..23bcc35
--- /dev/null
+++ b/docs/module/Shelly-Modul/README.md
@@ -0,0 +1,31 @@
+# Shelly Modul
+
+> Status: Diskussionsentwurf. Übernimmt `Shelly_Parser_MQTT` möglichst
+> unverändert und ohne EMS-Abhängigkeit.
+
+Das Modul lauscht auf MQTT und legt pro erkanntem Gerät weiterhin einen Ordner
+mit Online-Status, Typ, Inputs, Outputs und Temperatur an.
+
+## Dynamische Variablen
+
+| Ident-Muster | Typ / Zugriff | Beschreibung |
+| --- | --- | --- |
+| `<Geraet>_online` | Boolean / Anzeige | Online-Meldung. |
+| `<Geraet>_type` | String / Anzeige | Erkannter Gerätetyp. |
+| `<Geraet>_input_n` | Boolean / Anzeige | Dynamisch erkannter Eingang. |
+| `<Geraet>_output_n` | Boolean / bedienbar | Ausgang über vorhandenen Action Handler. |
+| `<Geraet>_temperature` | Float / Anzeige | Erkannte Temperatur. |
+
+## Properties
+
+| Ident | Typ | Standard / Beschreibung |
+| --- | --- | --- |
+| `Debug` | Boolean | `false`; bestehendes Debug-Logging. |
+
+## Verhalten und offene Punkte
+
+- MQTT-Abonnements, Geräteordner, technische Idents und der interne Action
+  Handler bleiben erhalten.
+- In diesem Schritt keine Geräte- oder Datenpunktauswahl und keine neue
+  Objektstruktur einführen.
+- Beim Praxistest klären, ob der bestehende Debug-Schalter ausreicht.