diff --git a/README.md b/README.md
index a94bb82..e80c9c1 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,25 @@
-# brojs-task-69a86305c46fd26feae6bcaa
+# Human‑in‑the‑Loop через middleware
 
-BroJS task solution: Human-in-the-Loop через middleware
\ No newline at end of file
+## Что делает
+
+Пример работы LangChain агента, который при каждом вызове инструмента
+остановится и попросит пользователя подтвердить или отклонить действие.
+
+## Установка
+
+```bash
+pip install -r requirements.txt
+```
+
+## Запуск
+
+```bash
+python agent.py
+```
+
+В интерактивном режиме введите запрос, например:
+```
+Какая погода в Казани сегодня?
+```
+Агент покажет, какой инструмент будет запущен, и попросит `a` – approve
+или `r` – reject. После подтверждения агент вернет окончательный ответ.