# Changelog Generator From Merged Pull Requests

Source: https://maito.app/workflows/write-the-changelog

Twice a week Maito reads the pull requests merged since the last changelog and drafts notes grouped as new, improved and fixed, posted in Slack for review.

Twice a week, turn merged pull requests into a changelog people can read.

[Engineering](https://maito.app/workflows/team/engineering) · [Software](https://maito.app/workflows/industry/software) · On a schedule · Updated October 19, 2026

Works with

-   Slack
-   Email

## How do you write a changelog from merged pull requests?

To write a changelog from merged pull requests, set a Loop in Maito for the days you publish. It reads every pull request merged since the last changelog, drops internal changes, groups the rest as new, improved and fixed, and posts a draft in Slack. It flags changes that break existing users.

## How it's done today

Changelog is written in a rush before release, or not at all.

## What Maito does

1.  Read merged pull requests
2.  Group by user-visible change
3.  Write plain release notes

## Example

Loop run: Friday 10:00 AM · Changelog draft

**Maito** (10:00 AM):

Changelog draft for Oct 13 to Oct 16: 7 entries from 19 merged pull requests.

**New**  
• Export any dashboard as CSV (#871)  
• Saved filters on the Projects page (#866)

**Improved**  
• Search results load about twice as fast on large workspaces (#869)  
• Invoices now show the PO number (#873)

**Fixed**  
• Dates in the date picker use your own time zone (#903)  
• Two smaller fixes (#875, #879)

Left out: 12 internal changes.

**Catch:** #874 lowers the default API page size from 100 to 50. Anyone who doesn't set a page size will get half the rows. It's under Improved as a plain note, but it may need an email to developers.

Attached: changelog-oct-16.md. Leo, ok to publish?

**Leo** (10:20 AM):

move the page size change to the top and call it out as a change.

**Maito** (10:22 AM):

Moved to the top under a new Changed heading. Updated file attached.

## How to set it up

On a schedule Write the changelog

Ask your agent

“Every Tuesday and Friday at 10, read the pull requests merged since the last changelog and draft release notes in #product-updates. Customer-visible changes only, in plain language.”

## What it won't do

It works from pull request titles, descriptions and diffs, so a vague pull request gets a vague entry. It does not know which changes your customers care about most until you tell it.

## Questions

### How often does it run?

On the schedule you set, for example every Tuesday and Friday. You can also mention Maito any time to draft one on demand.

### Does it publish the changelog?

No. It posts a draft in Slack for you to edit. Publishing stays with your team.

### How does it decide what to leave out?

It skips internal work like refactors and test changes, and tells you how many it left out so you can ask for any back.

## More engineering workflows

-   [Turn a ticket into a tested pull request Hand over a well-scoped ticket and get back a pull request with tests. Engineering · When you ask Works with Linear, Jira.](https://maito.app/workflows/turn-a-ticket-into-a-tested-pull-request)
-   [Review a teammate's pull request Get a first review that catches bugs and missed cases before a person looks. Engineering · When something happens Works with Slack, Email.](https://maito.app/workflows/review-a-teammates-pull-request)
-   [Check a change for security problems Look at a change for injection, leaked secrets and missing permission checks. Engineering · When you ask Works with Slack, Email.](https://maito.app/workflows/check-a-change-for-security-problems)
-   [Nudge stale pull requests Pull requests waiting too long get a polite reminder to the right reviewer. Engineering · On a schedule Works with Slack, Email.](https://maito.app/workflows/nudge-stale-pull-requests)
-   [File a bug from a Slack thread When a bug comes up in chat, mention Maito and it gets filed once, with details and no duplicates. Engineering · When you ask Works with Linear, Jira.](https://maito.app/workflows/file-a-bug-from-a-slack-thread)
-   [Draft the incident postmortem Turn the incident channel and logs into a postmortem draft. Engineering · When you ask Works with Datadog, Sentry.](https://maito.app/workflows/draft-the-incident-postmortem)

[See all workflows](https://maito.app/workflows)

## Put your AI teammate to work.

Set it up in minutes. Start with this one, and let it earn the next one.

[Put Maito to work](https://maito.app/login?returnTo=%2Fworkflows%2Fwrite-the-changelog)[Book a demo](mailto:support@maito.app?subject=Maito%20demo)