H.5.5 Generated Interfaces
recommendedReading progress2 helpful
Prerequisites0/2 complete
Articles read
Helpful reading is optional.
Article in preparation — showing conspect notes
Generated code creates a maintained dependency interface even when people do not edit its output.
- Name the source of truth and assign separate roles for input, generator, generated surface, and consumer migration.
- Define compatibility and deprecation at the generated interface, not only at the schema or generator implementation.
- Decide checked-in versus build-time generation through repository-content, bootstrap, IDE, hermeticity, and external-consumer needs.
- Validate deterministic generation and semantic differences; a large mechanical diff is evidence, not a review exemption.
- Stage generator upgrades across affected consumers with rollback and cleanup.