# Release Notes Customers Will Read, Drafted for You Source: https://maito.app/workflows/write-release-notes-customers-will-read When you tag a release, Maito reads what shipped and drafts plain customer release notes, flagging changes that could surprise users. Turn the engineering changelog into plain notes for customers. [Product](https://maito.app/workflows/team/product) · [Software](https://maito.app/workflows/industry/software) · When something happens · Updated October 19, 2026 Works with - Slack - Email ## How do you write release notes customers will read? To write release notes customers will read, set a Loop in Maito that starts when you tag a release. It reads the merged pull requests since the last tag, picks the changes worth telling customers about, writes them in plain words, and flags changes that could surprise people. You get a draft in Slack. ## How it's done today Release notes are a list of ticket titles. ## What Maito does 1. Read what shipped 2. Pick what users notice 3. Write short plain notes ## Example Loop run: Release v2.31 tagged · 23 merged PRs **Maito** (4:12 PM): **Draft release notes, v2.31** 23 PRs merged; 4 are worth telling customers about. • **Connect your data step in onboarding.** New accounts now import data in the first session, so reports are never empty. • **Bulk reassign.** Change the owner of up to 100 projects at once from the project list. • **Faster search.** Results now show in under a second for workspaces with 10,000+ items. • **CSV export column order changed.** Columns now follow the order on screen. **The catch:** the last one was titled "refactor export" in the PR, but it changes CSV column order. Anyone with a script that reads columns by position will break. I'd call it out as a change, not a fix. Approve or tell me what to change. **Leo** (4:25 PM): Approved. Move the CSV change to the top and say what to do about it. **Maito** (4:27 PM): Moved it first, with a line on reading columns by name instead of position. Final version attached: release-notes-v2.31.pdf. Nothing has been sent to customers. ## How to set it up When something happens Write release notes customers will read Ask your agent “When we tag a new release in the web app repo, read what shipped since the last tag and draft customer release notes. Post the draft in #product for Leo to approve. Don't publish anything.” ## What it won't do It writes from pull requests and their descriptions. It does not know your marketing plans or which announcements need approval. ## Questions ### Does it publish the notes? No. It posts a draft in Slack for you to edit and publish. ### How does it differ from the engineering changelog? It leaves out internal work and rewrites the rest for customers, in the tone you set. ### Does it warn about changes that affect customers? Yes. For example a changed default or export format is called out in the draft. ## More product workflows - [Answer "what happens if we change X?" Know what a change would touch before you put it on the roadmap. Product · When you ask Works with Slack, Email.](https://maito.app/workflows/answer-what-happens-if-we-change-x) - [Write a spec with the edge cases Turn a feature idea into a spec that includes the cases the code already handles. Product · When you ask Works with Notion, Confluence.](https://maito.app/workflows/write-a-spec-with-the-edge-cases) - [Build a quick prototype See an idea working on a branch before committing the team to it. Product · When you ask Works with Slack, Email.](https://maito.app/workflows/build-a-quick-prototype) - [Group user feedback into themes See what users ask for most, with counts and quotes. Product · On a schedule Works with Intercom, Pylon, Granola, Fireflies, SurveyMonkey.](https://maito.app/workflows/group-user-feedback-into-themes) - [Investigate a drop in a metric When sign-ups or activation drop, get a first answer on why. Product · When you ask Works with Amplitude, Mixpanel, Datadog, Sentry.](https://maito.app/workflows/investigate-a-drop-in-a-metric) - [Prep for a customer interview Know the customer's usage and history before the interview. Product · When you ask Works with Amplitude, Mixpanel, Intercom, Pylon, HubSpot, Salesforce.](https://maito.app/workflows/prep-for-a-customer-interview) [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-release-notes-customers-will-read)[Book a demo](mailto:support@maito.app?subject=Maito%20demo)