---
title: Write release notes users can read
description: Turn what shipped into user-facing notes and an updated changelog that does not read like a git log.
url: https://openplanr.dev/docs/prompts/write-release-notes
updated: 2026-10-06
related:
  - https://openplanr.dev/docs/prompts/choose-next-version.md
  - https://openplanr.dev/docs/prompts/diagram-the-flow.md
  - https://openplanr.dev/docs/prompts/prepare-landing-sequence.md
---

# Write release notes users can read

Turn what shipped into user-facing notes and an updated changelog that does not read like a git log.

## Prompt

Claude Code:

```text
/release Write user-facing release notes for everything since the last tag and update the changelog.
```

If /release runs another command, use /planr:release.

Codex:

```text
$release Write user-facing release notes for everything since the last tag and update the changelog.
```

With the OpenPlanr plugin for Codex, use $planr:release.

Cursor:

```text
@planr-release Write user-facing release notes for everything since the last tag and update the changelog.
```

Cursor applies the planr-release rule when you mention it in chat.

Parts to fill in, shown with their example text:

- The release window: everything since the last tag

## Why this works

Release classifies each change by one question: does a user have to do, know, or expect something different now? The notes lead with what users can do, describe fixes by the symptom users saw, and leave internal work out.

## Make it stick

[OpenPlanr Release](https://openplanr.dev/docs/skills/release.md)