Tell a product's users what they can now do or see, one period at a time.
Open: the period heading, then the New items
Structure: period heading, newest period first; each New item is a 2–6 word title and one sentence of at most 20 words; Improved and Fixed are bullets of at most 12 words each; one link per item to where the change lives
End: the last Fixed line; no sign-off or summary
Required: write for the product's users: what they can now do or see · second person, present tense, active voice · the product's own words for its features · New, Improved and Fixed kept apart; Fixed says how it works now · true when shipped and still true · merge changes about one outcome into one item
Avoid: internal names users never see: agents, tools, models, people, branches, PR or issue numbers · process: how it was built, tests, refactors, CI, deploys · internal work with no visible change, and changes reverted in the same period · hype words, exclamation marks and em dashes · an entry for a period with nothing users can see · "bug fixes and improvements" or "we added"
Human review: price, limit or plan change · data or privacy change · removed feature · security fix