Appendix C — Migration playbook
Status: placeholder. Ships in v1.0.0.
Adopting these patterns on a brand-new project is straightforward. Retrofitting them onto a live codebase without burning out the contributor pool is the actual hard problem. This appendix lays out a tested order of operations:
- Tier 1 first, all in one PR — it’s mechanical and breaks nothing.
- Wire
deterministic-depsin advisory mode for at least one release cycle so the team sees what enforcement would block before it blocks. - Promote to enforce mode only after the noise level is zero or single-digit.
- Add Tier 3 release machinery as a separate workstream, on a separate branch, behind a feature flag in the release workflow.