diff --git a/README.md b/README.md
new file mode 100644
index 0000000..7bbc249
--- /dev/null
+++ b/README.md
@@ -0,0 +1,90 @@
+# 📈 CVibes V3.3 by Telgos – Pine Script Übersicht
+
+Dieses Skript ist eine erweiterte Indikator-Logik im Croc-Handelssystem, implementiert mit Pine Script® Version 5 für TradingView.  
+Ziel ist es, verschiedene Long-Setups wie Pearl Diver, Stephan Setup oder Ulti Rally anhand von Original-Lochstreifenindikatoren, Wolkenfarben, Candle-Farben und MSI-Werten zu erkennen und visuell wie analytisch darzustellen.
+
+> 📄 Version: **3.3**  
+> 👨‍💻 Autor: Telgos  
+> 🕊️ Lizenz: [Mozilla Public License 2.0](https://mozilla.org/MPL/2.0/)  
+> 💬 Stand: 2025-07-30
+
+## 🔧 Technische Grundlagen
+
+Das Skript verwendet:
+- Pine Script® V5
+- Externe Inputs aus Connector-Indikatoren (Wolke, Trend, Punkte, MSI)
+- Swing-Analyse auf Hoch/Tief zur Punktvalidierung
+- ATR-basierte Visualisierung von Labels
+- Dynamische SL/TP-Marken
+- Alerts für Screener / Automatisierung
+
+## 🧩 Eingabestruktur
+
+**Gruppe: Chart-Signale**
+- Cloud-, Red-Devil-, BB-Kombi-, Rocket-, Lollipop- und BGRL-Signale
+- Blauer Punkt Long/Short
+- MSI-Level (Day, Week 2, Week 5)
+
+**Gruppe: Lochstreifen**
+- Farben: Kerze, Trend, Setter, Welle, Wolke
+- Status (grün/rot)
+
+**Allgemeine Einstellungen**
+- Anzeigeoptionen für Labels
+- ATR-Multiplikator
+- Swing-Lookback-Wert
+
+## 📈 Strategien / Setups
+
+### 🟣 Pearl Diver / Oyster Farmer
+- Strikte Farbkombinationen aus Status, Trend, Wolke, Setter und Kerze
+- Swing-basierte Bestätigung der vorherigen AllRed/AllGreen-Bedingungen
+
+### 🟢 Stephan Setup
+- MSI-Level (alle negativ)
+- Zusatzbedingung (mind. ein aktives Zusatzsignal)
+- Setter rot + Trend schwarz + Wolke grün
+
+### 💠 Ulti Rally
+- Hellgrüner Punkt oberhalb der Wolke
+- Kein aktiver Bärenmarkt (Welle nicht rot)
+- Setter rot + Status rot + Kerze rot
+
+### ⬛ Black Green Rocket Long (BGRL)
+- Rein auf externes Signal basiert
+
+## 🔵 Blaue Punkt-Erkennung (Swing Validation)
+
+Validierung über:
+- Swing High/Low innerhalb des Lookback
+- Wolkenfarbe als Trend-Richtung
+- Signal wird als "erfüllt" markiert oder mit alternativen Labels:
+  - „Ein Hoch kommt noch“
+  - „Ein Tief kommt noch“
+  - „Hoch/Tief verpasst“
+
+## 🧠 Visualisierung
+
+- Farbige Labels direkt am Chart
+- SL/TP-Linien mit Preisangabe neben der letzten Kerze (Entry + minTick)
+- Shapes für Screener/Backtest (z. B. `plotshape(isPearlLong)`)
+
+## 🔔 Alerts
+
+Für folgende Bedingungen:
+- Pearl Diver / Oyster Farmer
+- Stephan Setup
+- Ulti Rally
+- BGRL
+- Blauer Punkt erfüllt
+
+## 🛡️ Hinweise
+
+- Das Skript nutzt ausschließlich visuelle Darstellung. Kein automatisierter Entry per `strategy.entry`.
+- Für Screener-/Bot-Zwecke sind die `alertcondition()`-Blöcke ideal vorbereitet.
+- Eine Backtest-Strategie müsste separat in einer Pine-Strategy-Datei umgesetzt werden.
+
+---
+
+> 🧠 *CVibes V3.3* steht exemplarisch für eine präzise, signalgetriebene Visualisierung im Croc-System.  
+> Kein Support – freie Anpassung durch den Nutzer erwünscht.
\ No newline at end of file