Draft release notes from merged change titles

A set of release notes grouped as new, improved and fixed, with a list of items left out and why.

Choose one of three approaches. The steps for that option appear below.

Choose an option above. On a phone, swipe the tabs left or right to see all options →

Claude: groups titles, drafts notes, flags claims

One Claude chat groups the titles, drafts plain notes and flags claims to confirm. You check and decide.

  1. You

    Gather titles

  2. Claude

    Group, draft, flag

  3. You

    Check and decide

  1. Gather PR titles and ticket summaries

    Use: You

    Have ready: the merged PR titles and linked ticket summaries.

    Check

    Check every title has its ticket summary.

  2. Draft grouping, plain wording and claim flags

    Use: Claude

    In one chat, ask for grouping by user impact with a held-back list, plain wording citing tickets, then flags on lines an engineer must confirm.

    Details

    What to paste into the tool

    Task: Proposed grouping: grouped list plus held-back list. Here are merged PR titles with ticket summaries for version 2.4. Group them by user impact as new, improved, fixed. Put internal-only items on a separate held list with the reason. Every line keeps its ticket ID. Describe nothing that is not in the tickets. Task: Release notes draft. Rewrite each proposed group as release notes in plain user language. Each line ends with its ticket ID. Say nothing that is not in the ticket text. This is a draft for approval, not for publishing. Task: Confirmation list. Read the draft against the ticket text. Add an inline [confirm] marker on every line that asserts behaviour, scope or effect an engineer should verify, and list those claims separately.

  3. Check every line, then approve or hold

    Use: You

    Check the notes and the confirmation list against your tickets. Approve the notes or hold them and list the fixes.

    Check

    Check grouping and held items. Check each line against the ticket text and each flagged claim against what shipped. Approve the notes only when every line matches your tickets; otherwise hold the draft and list the fixes. Nothing is published: the draft stays in the chat until the product owner releases it.

Before you paste into any AI tool, remove any confidential information. Put it back at the end.

Tools in this workflow

Deciding between ChatGPT and Claude for this? See the comparison.

Final check

Every merged item is included, merged into another line, or listed as omitted with the reason.

Each line cites its ticket and describes nothing that is not in the tickets.

The product owner approves the wording and checks claims against what shipped; an engineer confirms or corrects each flagged claim.

Do not publish: in every path the product owner releases the notes.

Check the result against your original inputs. Approve it before sharing or acting.

What still needs checking
  • Notion agent wording sits under the Business plan and included credits may vary by plan and purchase arrangement.
  • No cited page names grouping changes by user impact or flagging engineering claims; those stages are unchecked in every path.

Share this page