api: some update.
move spec design to hackpad.