diff --git a/README.md b/README.md
index 4a30f35..7f18675 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,24 @@
-# task-69a86305c46fd26feae6bcaa
+# Human-in-the-Loop через middleware
 
-HITL via HumanInTheLoopMiddleware
\ No newline at end of file
+Агент на `create_agent` + `HumanInTheLoopMiddleware`: перед вызовом `get_weather` запрашивается подтверждение в терминале (`approve` / `reject`), возобновление через `Command(resume={"decisions": [...]})`.
+
+## Запуск
+
+```bash
+pip install -r requirements.txt
+# OPENAI_API_KEY и OPENROUTER_MODEL в .env
+python main.py
+```
+
+Пример:
+
+```
+Вы: Какая погода в Казани сегодня?
+--- Подтверждение ---
+Инструмент: get_weather
+Аргументы: {'city': 'Казань', 'date': 'сегодня'}
+a = approve, r = reject: a
+Агент: ...
+```
+
+Документация: [Human-in-the-loop — LangChain](https://docs.langchain.com/oss/python/langchain/human-in-the-loop)