diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..14f5ac2
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,10 @@
+*~
+*.o
+*.a
+*.so
+*.gch
+*.exe
+Makefile
+/bin
+/build
+/lib
diff --git a/README b/README
new file mode 100644
index 0000000..b9d0d59
--- /dev/null
+++ b/README
@@ -0,0 +1,36 @@
+sofort: portable software project template
+------------------------------------------
+
+build system
+------------
+* the project is conceived as a library with
+  an accompanying front-end utility.
+* the configure script is fast and skinny,
+  yet comprehensive.
+* unified logic for native and cross builds.
+* unified logic for in-tree and out-of-tree builds.
+
+driver
+------
+* the provided argv parser and usage screen generator
+  is powerful, flexible, and thread-safe; moreover,
+  it allows for a program driver that is entirely
+  independent of the chosen skin.
+
+skins
+-----
+* one benefit of the above design is that it allows the
+  front-end utility to have several distinct skins at
+  virtually no effort.
+
+modularity
+----------
+* the distinct driver and unit context, in combination
+  with the thread-safe argv parser, render the front-end
+  utility's inclusion in a multi-call binary trivial.
+
+extras
+------
+* the template provides the skeleton of an application
+  that may accept one or more files for its input, then
+  operate on each input file individually.