diff --git a/README.md b/README.md
new file mode 100644
index 0000000..c2eccc3
--- /dev/null
+++ b/README.md
@@ -0,0 +1,17 @@
+## Example of usage php attributes
+
+Небольшая попытка использовать аттрибуты php в реальной задаче. 
+
+Задача: выводить случайную шутку в консоль при вызове команды. Аттрибутом задать кэширование.
+
+### Requirements
+
+- `php` 8.0.0 и выше
+
+### Execution
+
+Для запуска нужно выполнить команду
+
+```shell
+$ php cli.php joke
+```