H.5.5 Generated Interfaces

recommended
Reading progress2 helpful
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.