diff --git a/README.md b/README.md
new file mode 100644
index 0000000..d01d4d3
--- /dev/null
+++ b/README.md
@@ -0,0 +1,30 @@
+Google Assistant用 準備室レポートアプリ
+---------------------------------------
+準備室のおんどとりの取得状況とマシン室の状態を
+調べて報告します。
+もとは firebase用にnode.jsで書いていましたが、python で書き直しました。
+OK Google, 準備室レポートにつないで, で接続します。
+
+おんどとり
+=========
+ondotori()
+おんどとり付属ソフトの出力するログファイル ComLog.txtを毎日 8:00にcgi
+ファイルと同じ場所にタスクスケジューラで転送して、これを解析しています。
+基本的には、ログを上から見ていって一度でも成功していたらそのセンサーは
+成功と判断しています。
+
+マシン室状況
+============
+machine()
+指定された日のマシン室の状況を準備室cgiの
+ https://ist.ksc.kwansei.ac.jp/~tutimura/cgi-bin/lab
+の内容をスクレイピングして報告しています。
+スクレイピングはbs4ではなく lxmlを使って泥臭くやっています。
+
+マシンのログ
+============
+log()
+準備室cgiでは一週間ごとにしかとれないため、ログは直接 accesslogを
+解析しています。 *それならマシン室状況もそうしてしまうべきかも..._*
+日曜日は除外とか、それなりに面倒くさいので、抜本的なログ解析にしてしまう
+かどうか少し悩み中。