Changelog — user-facing "What's new"

Every template app keeps a CHANGELOG.md of user-facing changes that renders in-app via the command menu (Cmd+K → "What's new") and on the settings page. The flow mirrors changesets so it survives many agents working in parallel: each change drops a small pending entry file, the in-app surface reads pending files plus CHANGELOG.md, and a later release can roll those pending files into dated CHANGELOG.md sections.

When to add an entry

Add an entry whenever you ship something a user of that app would notice:

• a new capability or surface,
• a visible improvement (speed, layout, copy, defaults),
• a bug fix that affects behavior they'd see.