diff --git a/README.md b/README.md
new file mode 100644
index 0000000..2d9dc88
--- /dev/null
+++ b/README.md
@@ -0,0 +1,32 @@
+# xlxarkyktsmk
+
+Репозиторий-хранилище одного файла — списка DMR-контактов `Contact.csv` для загрузки в память абонентских радиостанций (CPS Anytone/TYT и совместимые) и для сверки с базой позывных XLX-рефлектора. Файл содержит соответствие «имя абонента → DMR ID» для локальной группы пользователей рефлектора; расшифровка самого имени репозитория из кода не определена (предположительно привязка к конкретному XLX/региону).
+
+## Стек
+- Данные: CSV с разделителем `;`, кодировка ASCII, переводы строк CRLF (формат импорта в CPS радиостанций).
+- Кода, скриптов и зависимостей в репозитории нет.
+
+## Структура
+- `Contact.csv` — список контактов. Шапка: `Contact Name;ID;ID Type;TS Override`. 158 записей.
+  - `Contact Name` — отображаемое имя абонента (латиницей, до 8 символов, как принято в CPS).
+  - `ID` — DMR ID. Присутствуют как «настоящие» ID из международной базы (2xxxxxx, 25xxxxx, 4600403, 5973777, 65xxxxx, 78xxxxx), так и локально выданные ID вида `103xxxx` и `77000xx`, которые выдаются собственной панелью регистрации XLX-рефлектора.
+  - `ID Type` — тип вызова; во всех записях `Private` (индивидуальный вызов), групповых вызовов/TG в файле нет.
+  - `TS Override` — принудительный слот; во всех записях `Disabled`.
+
+## Как запустить/установить
+Запускать нечего. Файл используется вручную:
+```sh
+git clone <url>/xlxarkyktsmk
+```
+далее `Contact.csv` импортируется в CPS радиостанции (раздел Digital Contact List / Talk Groups) или кладётся рядом с базой ID рефлектора.
+
+## Конфигурация
+Настроек нет. Единственный «параметр» — содержимое самого CSV.
+
+## Состояние
+Актуальный справочник, но фактически заброшен как репозиторий: один-единственный коммит `ogd` от 2025-05-18, всего 1 коммит. Обновления списка с тех пор не фиксировались.
+
+## Что не доделано
+- Полные дубликаты строк: `SOKOL;2500247;Private;Disabled` и `VLAD770;6550007;Private;Disabled` встречаются по два раза (156 уникальных строк из 158).
+- Одно имя используется для нескольких ID (например, `ICEBERG` — 2501655 и 1030172, `NAVIRUS` — 6555008 и 1030001, `SOKOL` — 5973777 и 2500247): в CPS это приведёт к неоднозначному отображению.
+- Нет описания происхождения списка, нет скрипта генерации из `dmrid.dat` рефлектора — файл поддерживается вручную.