final draft of specs
server and reference bot