diff --git a/README.md b/README.md
new file mode 100644
index 0000000..af8105d
--- /dev/null
+++ b/README.md
@@ -0,0 +1,27 @@
+life report
+===========
+
+Generate a report on various aspects of your life.
+
+## A template is provided.
+
+It lists some common sections, like:
+
+* health / diet
+* money
+* travels
+* studies
+* music
+* books
+* distractions
+* work / projects
+
+## Fill out what you want.
+
+Each section supports arrays of data, contained in the given HTML element:
+
+order | property | html el
+------| -------- | -------
+1 | summary | `p`
+2 | details | `ul`
+3 | rank | `ol`