release-notes

1---2name: release-notes3description: Draft short release notes from a list of changes. Use when the user asks for changelogs, release notes, or a concise product update.4---5 6# Release Notes7 8Turn implementation details into user-facing release notes.9 10## Process11 121. Identify the user-facing outcome.132. Group related implementation details into one bullet.143. Avoid internal file names unless the user asks for engineering notes.154. Keep the tone factual and concise.16 17When the user provides a rough list of changes, run18`scripts/format-release-notes.ts` with `{ "changes": [...] }` to create a first19draft, then polish the wording for the user's audience. The TypeScript script20is function-style (`export default run(input, ctx)`) and demonstrates reading21`references/style-guide.md` from `ctx.files`.22 23## Output format24 25Use this structure:26 27```md28## Summary29 30- One to three bullets describing what changed.31 32## Notes33 34- Optional caveats, migration details, or follow-up work.35```36 37If the input is too vague, ask for the target audience and the release scope.38