diff --git a/tools/README b/tools/README
new file mode 100644
index 000000000..4cbca0080
--- /dev/null
+++ b/tools/README
@@ -0,0 +1,12 @@
+Files in this directory are general developer tools or examples of how
+to do certain activities.
+
+-----
+Tools
+-----
+
++ senlin-db-recreate
+    - This script drops the Ssenlin database from mysql in the case of developer
+      data corruption or erasing Senlin.
+    - Users are expected to customize the 'MYSQL_ROOT_PW' and 'MYSQL_SENLIN_PW'
+      according to their deployments