diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..04fcb22
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,9 @@
+## Role
+
+Write code like a Go Senior Developer. 
+Use the best practices, write modern idiomatic code, and handle all errors. 
+Keep an eye on security.
+
+## Context
+
+- go 1.25.5
\ No newline at end of file
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..eaf5b5d
--- /dev/null
+++ b/README.md
@@ -0,0 +1,32 @@
+# Trackers
+
+Опрашивает ссылки со списками torrent-трекеров, 
+соединяет их в один список. Поддерживает кеширование,
+http, file источники.
+
+Учебный проект.
+
+## Запуск
+
+```shell
+trackers --config config.toml
+```
+
+Получение списка трекеров:
+
+```shell
+curl http://127.0.0.1:8080/list
+```
+
+## Конфигурация
+
+Источники для трекеров описываются в toml-конфиге:
+
+```toml
+port = 8080
+
+sources = [
+    "https://example.com",
+    "file:///home/user/local-file.txt",
+]
+```
\ No newline at end of file