Housekeeping

- readme updates
- rough architecture diagram