From 2da8f5954e304e1b773d972982dc3285043dcc93 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=93=D0=BB=D0=B5=D0=B1=20=D0=9D=D0=B8=D0=BA=D0=B8=D1=88?=
 =?UTF-8?q?=D0=B8=D0=BD?= <glevelll@yandex.ru>
Date: Mon, 8 Jun 2026 14:29:30 +0000
Subject: [PATCH] docs: updated README

---
 README.md | 47 +++++++++++++++++++++++++++++------------------
 1 file changed, 29 insertions(+), 18 deletions(-)

diff --git a/README.md b/README.md
index b75359a..e4139e9 100644
--- a/README.md
+++ b/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
\ No newline at end of file
+```bash
+python main.py
+```