initial design spec for the master, closing #24