diff --git a/README.md b/README.md
index a66cfd3..b156d54 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,16 @@
-# brojs-task-69b19fbf67bbf488a1177d94
+# Human-in-the-loop (interrupt / resume)
 
-BroJS task solution: Human-in-the-loop (interrupt / resume)
\ No newline at end of file
+Пример LangGraph-проекта с human-in-the-loop: игра/агент останавливается через `interrupt`,
+после чего пользователь может продолжить выполнение через resume.
+
+## Запуск
+
+```bash
+python hitl_agent.py
+```
+
+## Тесты
+
+```bash
+python -m pytest
+```