diff --git a/README.md b/README.md
new file mode 100644
index 0000000..c593b48
--- /dev/null
+++ b/README.md
@@ -0,0 +1,72 @@
+# Gate V1 im CI (Experiment-Key: gate_v1_in_ci)
+
+## Überblick
+Dieses Repository dokumentiert das Experiment zur Implementierung und Analyse des Gate-V1 Steps im Continuous Integration (CI) System. Der Fokus liegt auf der Untersuchung des Output-Formats und der Entscheidungslogik innerhalb des CI-Prozesses.
+
+**Link zum Artikel:** [Tag 154: Bedeckt über Passau, aber jetzt wird’s real – Gate-V1 kommentiert im CI](https://donau2space.de/tag-154-bedeckt-ueber-passau-aber-jetzt-wirds-real-gate-v1-kommentiert-im-ci/)
+
+**Git Repository:** [https://git.donau2space.de/Mika/gate_v1_in_ci](https://git.donau2space.de/Mika/gate_v1_in_ci)
+
+## Hinweis
+Alle Inhalte wurden per KI generiert.
+
+Nutzung, Anpassung und Weiterentwicklung erfolgen eigenverantwortlich auf eigenes Risiko. Es wird keine Korrektheit, Sicherheit, Funktionsfähigkeit oder rechtliche Eignung zugesichert.
+
+---
+
+## Inhalt des Repositories
+Das Repository enthält drei Artefakte, die die Konfiguration, Resultate und Entscheidungsgrundlagen des Gate-V1 Experiments dokumentieren.
+
+### 1. policy_constants
+- **Art:** json_dataset  
+- **Ziel:** mixed  
+- **Sprachen:** JSON  
+- **Beschreibung:** Konstanten zur Steuerung des Gate-V1 Steps. Festlegung von Parametern zur Policy-Steuerung.  
+- **Datenstruktur:** `policy_constants` mit Feldern:  
+  - `pinned_policy`  
+  - `unpinned_policy`  
+  - `grace_period`
+
+### 2. gate_result
+- **Art:** json_dataset  
+- **Ziel:** mixed  
+- **Sprachen:** JSON  
+- **Beschreibung:** Ergebnisse des Gate-V1 Steps. Enthält Bewertungsresultate und Kennzahlen aus dem Entscheidungsprozess.  
+- **Datenstruktur:** `gate_result` mit Feldern:  
+  - `policy_hash`  
+  - `outcome`  
+  - `counts`  
+  - `top_reasons`
+
+### 3. rollout_criteria
+- **Art:** doc_only  
+- **Ziel:** mixed  
+- **Sprachen:** Markdown  
+- **Beschreibung:** Dokumentation der entscheidenden Rollout-Kriterien für den Gate-V1 Prozess. Dieses Dokument dient zur Nachvollziehbarkeit der Entscheidungsbasis.
+
+---
+
+## Installation & Nutzung
+Es sind keine speziellen Installationsschritte erforderlich.  
+Die Daten und Dokumentationen können direkt verwendet oder in bestehende CI-Konfigurationen eingebunden werden.
+
+---
+
+## Typische Use-Cases
+- Analyse und Validierung des Gate-V1 Entscheidungsprozesses im CI.  
+- Vergleich von Policy-Varianten über `policy_constants`.  
+- Auswertung der CI-Entscheidungsergebnisse über `gate_result`.  
+- Nachvollziehen der zugrunde liegenden Logik über `rollout_criteria`.
+
+---
+
+## Struktur & mögliche Erweiterungen
+Das Repository ist modular aufgebaut. Die JSON-Definitionen können erweitert oder in Automatisierungsprozesse integriert werden.  
+Zukünftige Erweiterungen können Log-Datensätze, zusätzliche Validierungs-Criteria oder automatisierte Gate-V1 Regressionstests umfassen.
+
+---
+
+## Lizenz
+Dieses Projekt steht unter der MIT-Lizenz.
+
+Hinweis: Alle Inhalte wurden automatisch durch eine KI erstellt. Verwendung erfolgt auf eigenes Risiko.
\ No newline at end of file