From c6d077bfbf36012c66cd34bf8c97af791212b858 Mon Sep 17 00:00:00 2001
From: hachem <im@hachem.wtf>
Date: Sat, 6 Dec 2025 17:24:53 +0100
Subject: [add]: README

---
 README.md | 40 ++++++++++++++++++++++++++++++++++++++--
 1 file changed, 38 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 5dabb22..8a84811 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,38 @@
-# aoc-2025
-Advent of code for 2025
+# Advent of Code - 2025
+yes, i started late.
+yes, i wrote it in x86_64 assembly.
+no, there is no absolutely no good reason for this.
+no, i'm not okay.
+
+### Why assembly?
+because i was really bored and i wanted more of an excuse to procrastinate.
+
+also: **aura**.
+
+## Building
+```sh
+$ make day[1-12]
+# example:
+$ make day1
+$ make day2
+```
+
+## Running
+```sh
+$ make run-day[1-12]
+# example:
+$ make run-day1
+$ make run-day2
+```
+or manually, after building
+
+```sh
+$ ./build/day[1-12]
+# example
+$ ./build/day1
+$ ./build/day2
+$ ./build/day3
+```
+
+## License
+[MIT](LICENSE), because you want this code, you need more help than permission.
-- 
cgit v1.3