Skip to main content

Cursor prompts for changelog drafting

Use these prompts when drafting the monthly changelog from repo activity. They filter noise and produce structured output you can turn into the final MDX. Rule of thumb: Most commits are internal. Your job is to surface the ~10% that materially affect users (developers and solution architects). Answer “Why should I care?” not “What did engineers do?”.

Step 1 — Get commit or merge data

Obtain commit/merge data for the month from your repos (e.g. git log --since YYYY-MM-01 --until YYYY-MM-31 --format="%h|%ad|%s" or your GitHub PR list). Format as hash|date|subject if possible. Paste in chunks if the list is large (e.g. 100–200 lines per paste). Prefer merges if your PR titles are good.

Phase 1 — Classify by user impact

Paste the commit/merge list (one repo at a time) and run this prompt.
Repeat for each repo (product, bifrost, docs). Merge the JSON outputs mentally or in a doc so you have one combined classification for the month.

Phase 2 — Map to our sections and suggest title/description

We ship one changelog per month. Our section list is fixed. Use the classified items from Phase 1 and run:

Phase 3 — Convert to MDX

We use MDX with a consistent structure. No emojis in headers. Sections are ### Section name.
Copy the output into the correct year file (e.g. for March 2026, edit changelog/2026.mdx and add a new ## March 2026 section with the overview and product-area sections). Fix any links or details. Cross-check the Reference section in _process.md for API versions and Line releases so dates and names are correct.

Phase 4 — Strategic layer (optional)

Use this when you want to emphasize certain changes for positioning (website, customer email, investor update).

Summary

Then run Review and Publish from _process.md.