diff --git a/README.md b/README.md
new file mode 100644
index 0000000..82f98bb
--- /dev/null
+++ b/README.md
@@ -0,0 +1,19 @@
+# home-assistant
+
+Sammlung von Zusatzkomponenten, Custom Cards und Konfigurationen rund um
+die private Home-Assistant-Instanz. Jeder Unterordner ist ein eigenständiges
+Stück Funktionalität mit eigener Installationsanleitung in der jeweiligen
+README.
+
+## Inhalt
+
+| Ordner | Beschreibung |
+|---|---|
+| [`verbraucher-rangliste/`](./verbraucher-rangliste) | Custom Lovelace-Karte „Power Ranking Card“: zeigt alle Verbraucher (Watt/kW-Entities) absteigend nach aktueller Leistung als animierte Rangliste an. Aktuell im Einsatz auf dem Dashboard `lovelace` → View „Energie“. |
+
+## Konventionen
+
+- Jede Komponente liegt in einem eigenen Unterordner.
+- Jeder Unterordner enthält eine `README.md` mit Installations- und
+  Konfigurationsanleitung.
+- Änderungen werden direkt auf `main` gepflegt.