Changelog, optional user-facing "What's new"

Changelog generation is off by default. Read this skill only when the app's agent-native.config.ts enables changelog.enabled; otherwise do not create pending entries for ordinary app changes.

Every template app keeps a CHANGELOG.md of the 100 most recent user-facing release sections and a changelog/ folder of dated entry files for the complete history. The top-level file links to that folder for older updates at the end of the file. The in-app command menu (Cmd+K → "What's new") and settings page read both surfaces together, so folder-backed history remains visible without making the top-level file grow forever.

Package release histories follow the same compact shape: the 100 newest package release sections stay in the root CHANGELOG.md, while older sections live in changelog/archive/CHANGELOG.md. The package archive is nested so it cannot be mistaken for a new app entry by the Vite changelog loader.

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.

Do not add entries for refactors, internal tooling, tests, dependency bumps, or anything invisible to the end user. The changelog is product notes, not a commit log, write it the way you'd describe the change to a customer.

How to add an entry

From the app directory (the template you changed):

agent-native changelog add "Recordings can be trimmed before sharing" --type added
agent-native changelog add "Faster transcript search" --type improved
agent-native changelog add "Fixed a crash when opening an empty folder" --type fixed