using (s/def ::my-spec ..) - is not a hard requirement. Everytime your keys are not about namespaces in your application - i think it’s better to qualify by another namespace like (s/def :swagger.employee-schema/employee ..)