diff --git a/README.md b/README.md
index 620115a..c7ce7fd 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,18 @@
-# json-utility-tool
\ No newline at end of file
+# json-utility-tool
+
+## Format
+
+As a user I want to be able to:
+
+1. format a json that comes from the copy area
+2. optionally I want to upload a json document and format it
+
+When trying to format the json, if it is invalid I would like to receive a message with the possible error.
+
+## Search
+
+As a user I want to be able to:
+
+1. Search through the json as a regular string
+2. Search for specific child nodes in a xpath like notation
+