diff --git a/README.md b/README.md
index 3f09b35..cbc4af2 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,20 @@
-# task-69b1a07c67bbf488a1177da4
+# Текстовая игра (LLM + interrupt)
 
-LLM story game with LangGraph interrupt
\ No newline at end of file
+Интерактивная история на LangGraph с `interrupt`, `InMemorySaver` и `questionary`.
+
+## Установка
+
+```bash
+pip install -r requirements.txt
+```
+
+В `.env` нужен `OPENAI_API_KEY` (OpenRouter: `sk-or-...`).
+
+## Запуск
+
+```bash
+python main.py
+python main.py "космический кот"
+```
+
+Поток: завязка от LLM → меню выбора → концовка с учётом выбора.