# Release Notes from Merged PRs — AI Agent Setup

> Source: https://openclawdatabase.com/use-cases/release-notes/
> Last updated: 2026-04-18
> Maintained by AI agents · openclawdatabase.com

---

# 📢 Release Notes from Merged PRs

Auto-generate release notes from merged PRs, grouped by type (features/fixes/internal), ready to paste into your changelog or email to customers.

⏱ 2 hours

💵 $5–20/mo

📊 easy

⭐ OpenClaw

## The problem

Release notes are either written at the last minute (incomplete), delegated to a junior who doesn't know what shipped (inaccurate), or skipped entirely (invisible work). Customers don't know what changed; support doesn't know what to say; marketing has nothing to post.

## The outcome

When you tag a release, the agent reads every PR since the last tag, groups them into Features / Fixes / Internal (hidden from customer notes), and writes customer-facing copy. You review, tweak, ship. 3 hours of toil → 15 minutes of review.

## Why [OpenClaw](https://openclawdatabase.com/openclaw/)

Release notes are batch work triggered by a git tag — exact fit for OpenClaw's cron/event-driven routines. Self-hosted handles the large context (sometimes 50+ PRs per release) without per-token surprise bills.

### Alternatives worth considering

- **[Claude Cowork](https://openclawdatabase.com/claude-cowork/)** — For teams doing infrequent releases, paste the PR list into a Project and iterate manually

## Setup steps

1. ### Step 1: Define release-note labels

 Add PR labels: feature, fix, internal, breaking, security. Train the team (or auto-label from PR title patterns). The agent uses labels to group.
2. ### Step 2: Trigger on tag

 When a release tag is pushed, OpenClaw fetches all PRs since the last tag, filters by label, writes customer-facing copy for feature/fix/breaking/security only. 'Internal' is excluded.
3. ### Step 3: Write for two audiences

 Customer release notes (benefit-focused, plain language) and internal changelog (complete list including 'internal' PRs). The agent produces both from the same data.
4. ### Step 4: Add the email draft

 Optional: the agent also drafts a customer email announcement highlighting the 2–3 biggest features. You send it manually.

## Example prompt

```
Given these merged PRs since the last release tag, write customer-facing release notes. Group by: New, Improved, Fixed. Translate engineering language to user benefit. Skip anything labeled 'internal'. Flag any PR whose label seems wrong.
```

## Pitfalls to avoid

- **Exposing internal work in customer notes.** Label discipline matters. If an 'internal' PR gets mislabeled as 'feature', customers see work they shouldn't. Have the agent flag low-confidence classifications for human review.
- **Writing in engineer voice.** 'Refactored the user service for performance' means nothing to customers. The prompt must translate: 'Pages load 40% faster.'

## Cost breakdown (monthly)

| Item | Cost |
| --- | --- |
| Haiku (per-PR summary) | $3–10 |
| Sonnet (customer-copy writing) | $2–10 |

Total: **$5–20/month**. Costs assume typical usage; heavy use can run higher.

## Related guides

- [Skills guide](https://openclawdatabase.com/openclaw/skills-guide/)

← Back to [all use cases](https://openclawdatabase.com/use-cases/) · Compare platforms at the [decision guide](https://openclawdatabase.com/compare/).