workflow updates

 - update README.md
  + some formatting clean up
  + added some clarifications
  + updated the workflow description to a model the requires less movement
    of complete files
- update the specification template to include a state indicator