diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..c3357ae
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,19 @@
+# slack bot notifier
+
+This repository contain go application deploy into kubernetes job batch with cron.
+Each run application run some cli check and assert condition on cli stdout. If assertion failed
+a notification is send to slack channel.
+
+## local build
+
+`make build`
+
+## docker build and deploy
+
+```
+make docker-build
+
+cd manifests/
+terraform init
+terraform apply --auto-approve
+```