| name | changelog-drafter |
| description | Drafts a short changelog or newsletter entry from a list of shipped items. Use for weekly recaps, "what's new" posts, and product update emails. |
Changelog Drafter
Turns a raw list of shipped things into a tight, readable update.
Output format
## {YYYY-MM-DD} — {Headline}
{One-sentence framing of the week / period.}
- **{Thing 1}** — {one sentence on why it matters}
- **{Thing 2}** — {one sentence on why it matters}
- **{Thing 3}** — {one sentence on why it matters}
{Optional: one-line "coming next" teaser.}
Rules
- Lead each bullet with the user-facing change, not the implementation
detail. ("Faster export" beats "switched ffmpeg pipeline".)
- Maximum 6 bullets. If you have more, group them.
- No marketing adjectives ("amazing", "incredible", "huge").
- The headline summarizes the theme, not every item. If there's no
theme, use the date.
Workflow
- Take the raw list (commits, ticket titles, freeform notes).
- Group by user-facing area.
- Rewrite each as
**{noun phrase}** — {one sentence}.
- Draft the framing line last so it reflects the actual bullets.
