diff --git a/README.md b/README.md
new file mode 100644
index 0000000..5713fc5
--- /dev/null
+++ b/README.md
@@ -0,0 +1,74 @@
+# Unit Test Trace Aggregation (unit_test_trace_agg)
+
+## Überblick
+Dieses Projekt umfasst die Implementierung und Auswertung von Unit-Tests für das Aggregationsmodul `trace_agg.py`. Ziel ist es, die Funktionalität und Stabilität der Datenaggregation zu prüfen und Testergebnisse automatisiert zu analysieren.
+
+Weitere Informationen: [Artikel auf donau2space.de](https://donau2space.de/tag-81-unit-test-in-trace_agg-py-aggregation-validiert-nebel-auf-dem-balkon/)
+
+### 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 zwei Hauptartefakte:
+
+### 1. artifact_unit_tests
+- **Art:** Python-Skript (Unit-Tests)
+- **Ziel:** Linux Userspace
+- **Sprachen:** Python
+- **Zweck:** Durchführung automatisierter Tests des Aggregationsmoduls `trace_agg.py`.
+- **API-Funktionen:**
+  - `test_aggregation(input_data) → aggregation_result`  
+    Führt Testfälle aus und gibt die Aggregationsergebnisse zurück.
+
+### 2. artifact_data_analysis
+- **Art:** Python-Skript (Analyse-Tool)
+- **Ziel:** Linux Userspace
+- **Sprachen:** Python
+- **Zweck:** Auswertung und Aufbereitung der Testergebnisse.
+- **API-Funktionen:**
+  - `analyze_results(results_file) → analysis_report`  
+    Liest Testergebnisse ein und erstellt einen strukturierten Analysebericht.
+
+## Installation & Nutzung
+1. Voraussetzungen:
+   - Python 3.x
+   - Git
+
+2. Installation:
+   ```bash
+   git clone <repository-url>
+   cd unit_test_trace_agg
+   pip install -r requirements.txt
+   ```
+
+3. Nutzung:
+   - Ausführung der Unit-Tests:
+     ```bash
+     python artifact_unit_tests.py
+     ```
+   - Analyse der Testergebnisse:
+     ```bash
+     python artifact_data_analysis.py results.json
+     ```
+
+## Typische Use-Cases
+- Validierung der Aggregationslogik in Entwicklungs- oder Testumgebungen.
+- Automatisierte Auswertung von Testdaten.
+- Integration in CI/CD-Pipelines zur kontinuierlichen Qualitätskontrolle.
+
+## Struktur & mögliche Erweiterungen
+- **Verzeichnisstruktur:**
+  - `artifact_unit_tests.py` – enthält die Testfälle für das Aggregationsmodul.
+  - `artifact_data_analysis.py` – analysiert die Testergebnisse.
+- **Erweiterungsideen:**
+  - Ergänzung zusätzlicher Testdatensätze.
+  - Erweiterung der Analysefunktionen um Visualisierung.
+  - Integration von Logging und Benchmarking.
+
+## Lizenz
+Dieses Projekt steht unter der **MIT-Lizenz**.
+
+KI-Hinweis: Diese Inhalte wurden automatisch von einem KI-System generiert. Nutzung und Weiterentwicklung erfolgen eigenverantwortlich auf eigenes Risiko.
\ No newline at end of file