diff --git a/.gitignore b/.gitignore
index 234a2cd..4e2c998 100644
--- a/.gitignore
+++ b/.gitignore
@@ -15,12 +15,15 @@
 **/.DS_Store
 **/logs
 
-# ignore adhoc test code
-**/adhoc
-
 # gitlab ci
 .cache
 
 # vim auto backup file
 *~
 !OWNERS
+
+# corpus files
+data
+**/*.corpus.json
+**/*.gob
+**/stopwords.txt
diff --git a/README.md b/README.md
index cda77f8..51f7a1b 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,16 @@
 # chatbot
 A fast responsive chatter bot written in Go.
 
-Docs will be written soon.
+* cli
+  * train
+
+    train conversations into corpus format, `.gob` files.
+
+  * ask
+
+    a client tool to chat
+
+    * `-v` verbose mode
+    * `-c` the trained corpus file
 
 Thanks to [ChatterBot](https://github.com/gunthercox/ChatterBot).