From 6a9840c8da08946b0080c15e68a69ad1eb74f7c6 Mon Sep 17 00:00:00 2001
From: Anton Vakhrushev <anwinged@ya.ru>
Date: Fri, 9 Jan 2026 11:30:15 +0300
Subject: [PATCH] add readme and agents.md

---
 AGENTS.md |  9 +++++++++
 README.md | 32 ++++++++++++++++++++++++++++++++
 2 files changed, 41 insertions(+)
 create mode 100644 AGENTS.md
 create mode 100644 README.md

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