diff --git a/README.md b/README.md
index 3392227..da4d91a 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,22 @@
 # 8. Самописный поисковый агент на основе deep agents from scratch
 
-Решение учебного задания.
+Самописный поисковый агент в стиле Deep Agents from scratch.
+
+## Возможности
+
+- планирует поисковый запрос;
+- вызывает инструмент `web_search`;
+- сохраняет виртуальные файлы в памяти агента;
+- выгружает виртуальные файлы в реальную файловую систему.
+
+## Запуск
+
+```bash
+python deep_search_agent.py "найди краткую справку про LangGraph"
+```
+
+## Тесты
+
+```bash
+python -m pytest
+```