How to organize a large OpenAPI spec: multi-file structure, $ref rules, and CI checks

Every OpenAPI document starts as one clean file. Then it reaches forty operations and the file is 2,000 lines, then a hundred operations and pull requests conflict on every merge, then nobody edits it