docs: updated README

README.md

@@ -1,28 +1,39 @@
-# LangGraph Reflection Agent
+# LangGraph: граф с рефлексией и доработкой
 
-## Задание
+LangGraph-агент, который пишет ответ, оценивает его критиком и при необходимости улучшает.
 
-Повторный экзамен: Граф с рефлексией и доработкой.
+## Граф
 
-## Как запустить
+```
+START → draft_answer → reflect
+                         |
+              ok / round≥max_rounds → END
+              needs_revision        → rewrite → reflect
+```
+
+## Узлы
+
+| Узел | Роль |
+|------|------|
+| `draft_answer` | Первичный ответ на вопрос (5–10 предложений) |
+| `reflect` | LLM-критик: вердикт (`ok`/`needs_revision`) + 2–3 замечания |
+| `rewrite` | Улучшить черновик по замечаниям, `round += 1` |
+
+`max_rounds = 2` по умолчанию. Рефлексия реализована через LLM-критика — без try/except.
+
+## Установка
 
 ```bash
 pip install -r requirements.txt
-python main.py
 ```
 
-## Что делает
+`.env`:
+```
+OPENAI_API_KEY=ваш_ключ_openrouter
+```
 
-1. Генерирует краткий ответ (5–10 предложений) на заданный вопрос.
-2. Критик оценивает ответ и выдаёт verdict `ok` или `needs_revision`.
-3. При `needs_revision` до `max_rounds` (по умолчанию 2) происходит переписывание.
-4. Выводит финальный ответ.
+## Запуск
 
-## Пример
-
-```text
-Final Answer:
-...```
-
-## Лицензия
-MIT
+```bash
+python main.py
+```