схема изначально в xsd, пишется руками, да. потом конвертируется в json-schema и вставляется в yaml для asyncapi. а по нему генерится дока. и только потом код.
но это в идеальном мире. в реальности конечно же схема+код параллельно, а потом уже yaml и дока
т.е. дто вы по xsd/json не генерируете, да? получается что, условно, дважды пишете про одно и тоже поле, сначала в схеме, потом в коде, верно?