Add spec/README.md to describe role of specific test folders

To start, only documented spec/acceptance and
spec/acceptance/broker_api_compatibility, as these two folders have
caused confusion recently.