Update README

* with paths to interesting files
* with instructions on running the specs