Iterate on readme

Just some proposed clarifications to the documentation for the agent branch. Please see [the full README in the branch view](https://github.com/soundcloud/glimpse/blob/iterate-on-readme/README.md) for changes to diagrams. @xla @grobie — let me know what you think.