README improvements for spec and dropping TODOs. Added <dependency> section to the spec and made explicit error cases.