diff --git a/README.md b/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..208a72b9a6b56e73fb3741157121e648ef77df49
--- /dev/null
+++ b/README.md
@@ -0,0 +1,39 @@
+# Игра Pacman
+
+
+### Описание
+
+**Pacman** — классическая игра, где игрок управляет жёлтым героем, перемещаясь по лабиринту, собирая точки и избегая столкновений с врагами. 
+Цель игры — собрать все точки на уровне, используя бонусы для временного перевоплощения хода игры.
+
+### Содержание
+
+1. [Паттерны](#tech)
+2. [Сайт с документацией](#tech)
+3. [Установка](#inst)
+
+### Используемые паттерны
+<a name="tech"></a>
+
++ Паттерн State. Cмена состояний игры 
++ Паттерн Composite. Делегирование отрисовки меню кнопкам
++ Паттерн Singletone. Загрузка шрифта, текстур, звука 
++ Паттерн Command. Разделение графического интерфейса и бизнес-логики
++ Паттерн Template Method. 
++ Паттерн Prototype. Клонирование сущностей 
++ Паттерн Memento. Сохранение и восстановление контекстов
++ Паттерн Builder. Создание лабиринта и контекста игры 
++ Паттерн Command. Игровые события могут редактировать контекст игры 
++ Паттерн Visitor. Взаимодействие пакмана с объектами 
++ Паттерн Observer. Наблюдатели следят за поеданием еды пакманом
+
+### Сайт с документацией 
+https://diasha745.github.io/docs/index.html
+
+### Установка проекта
+<a name="inst"></a>
+
+1. Скачать и установить [Git](https://git-scm.com/download/win)
+2. Склонировать проект: `git clone --recurse-submodules https://git.miem.hse.ru/blank792038/lab3.git`.
+
+*[Наверх](#top)*