Specifying #query public API prior to implementation