update README

Author: vdz

README.md

@@ -1,8 +1,83 @@
 ### Hexlet tests and linter status:
 [![Actions Status](https://github.com/vdzshnik001/python-project-49/actions/workflows/hexlet-check.yml/badge.svg)](https://github.com/vdzshnik001/python-project-49/actions)
-[brain-ever](https://asciinema.org/a/avoNamJdvwgjFOQLcmBiRqJOS)
-[brain-calc](https://asciinema.org/a/AYruD6OIG0CBHtTbhYb9OisIf)
-[brain-calc2](https://asciinema.org/a/r8Hw8e7CLxCPSKtAwjVHUFBti)
-[brain-gcd](https://asciinema.org/a/prwyhhTVmkHHtos6hjeuPoxIT)
-[brain-progression](https://asciinema.org/a/p3MHCOqgK9du3SJNuYlEAlUYf)
-[brain-prime](https://asciinema.org/a/YY1FQnzzk85OGBPHeFVq2nqRq)
+[![Maintainability](https://api.codeclimate.com/v1/badges/84bf161038a06bd52b1f/maintainability)](https://codeclimate.com/github/vdzshnik001/python-project-49/maintainability)
+
+## Demo links
+
+### make lint, make brain-games, make brain-even: https://asciinema.org/a/pwS7904IAkBWJbOyiUSkn3j4U
+### make brain-calc: https://asciinema.org/a/r8Hw8e7CLxCPSKtAwjVHUFBti
+### make brain-gcd: https://asciinema.org/a/prwyhhTVmkHHtos6hjeuPoxIT
+### make brain-progression: https://asciinema.org/a/p3MHCOqgK9du3SJNuYlEAlUYf
+### make brain-prime: https://asciinema.org/a/YY1FQnzzk85OGBPHeFVq2nqRq
+
+# Brain Games
+
+Hexlet tests and linter status:
+Actions Status Maintainability
+
+## Description
+Brain Games is a set of five console games built for educational purposes. Each game poses a challenge that requires basic arithmetic, logic, or number theory skills.
+
+## Minimum Requirements
+- Python 3.13+
+## Installation
+1. Clone the repository:
+   
+         git clone [email protected]:vdzshnik001/python-project-49.git
+
+3. Navigate to the project directory:
+
+       cd brain-games
+
+3. Install the dependencies using Poetry:
+
+       make install
+
+## Running the Games
+The project includes the following games:
+
+Brain Even
+
+Brain Calc
+
+Brain GCD
+
+Brain Progression
+
+Brain Prime
+
+## Launching a Game
+To launch a specific game, use the following commands:
+
+Brain Even:
+
+      make brain-even
+
+Brain Calc:
+
+      make brain-calc
+
+Brain GCD:
+      
+      make brain-gcd
+
+Brain Progression:
+
+      make brain-progression
+
+Brain Prime:
+
+      make brain-prime
+
+## Example Commands
+Build the project:
+
+      make build
+
+Install the package:
+
+      make install
+
+Lint the project:
+
+      make lint