diff --git a/README.md b/README.md
index e69de29..094e26d 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,12 @@
+# Advent of Code 2025
+
+Personal solutions for [Advent of Code 2025](https://adventofcode.com/2025)
+using Golang.
+
+## Running
+
+General pattern to run the code is using **stdin** to pass the data file:
+
+```sh
+go run ./cmd/day1 < ./cmd/day1/input.txt
+```