Added initial version of API design specification

Not yet complete, first doc für review purposes. Future design specs shall be pretty similar.
It's fine to document this, but please note that we want to step away from this remote-object style. IIRC it's only actually used for watchers, and it *should* be implemented as a plain old argument like everything else is.