kortix-release
Kortix Release
How a clean, accurate production release happens. Two halves: what version (the
bump philosophy) and how (notes derived from the real staging candidate, then
promote → deploy → verify). The release notes you write become the GitHub Release, which is
exactly what the public /changelog page renders — so they must reflect what
actually shipped, nothing invented, nothing missed.
Pairs with kortix-voice (how the notes read). The version source of truth is the
root VERSION file; vX.Y.Z tags are immutable and map 1:1 to a commit + image.
0. Golden rule — prod ships ONLY from staging
The only normal way to change prod is: get the release candidate onto
staging, then run Promote to Production (staging → reviewed release PR →
prod). Never git push …:prod, never open a manual PR into prod, never
cherry-pick onto prod.