From 75e7b1a3f525263a942e0f208f9904bb614aa8ed Mon Sep 17 00:00:00 2001
From: root <abdurazzoqov057@gmail.com>
Date: Tue, 14 Jul 2026 09:14:53 +0500
Subject: [PATCH] docs: expand README with project structure and setup

---
 README.md | 28 +++++++++++++++++++++++++++-
 1 file changed, 27 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 8ce8bdc..c2a21a2 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,29 @@
 # Free-Development
 
-Проекты в рамке беслпатной разработки на форуме Lolz.live
\ No newline at end of file
+Проекты в рамках бесплатной разработки на форуме [Lolz.live](https://lolz.live).
+
+Этот репозиторий является монорепозиторием, объединяющим все инструменты и скрипты, разработанные бесплатно для участников форума. Каждый проект подключён как git-подмодуль и хранится в отдельном репозитории.
+
+## Проекты
+
+| Проект | Описание |
+|--------|----------|
+| [Free-Telegram-Finder](./Free-Telegram-Finder) | Асинхронный Python-скрипт, сканирующий страницы с анкетами, извлекающий Telegram-ссылки и проверяющий свободные юзернеймы |
+
+## Клонирование
+
+Для клонирования репозитория вместе со всеми подмодулями:
+
+```bash
+git clone --recurse-submodules https://git.sakamoto.best/Lolz/Free-Development
+```
+
+Если репозиторий уже склонирован без подмодулей:
+
+```bash
+git submodule update --init --recursive
+```
+
+## Лицензия
+
+Распространяется под лицензией [MIT](./LICENSE). © 2026 Lolz.
\ No newline at end of file