ENGINEERING

Generate release notes from merged commits on tag

When you push a release tag, it gathers every merged commit since the previous tag, has an AI write clean, grouped release notes.

CategoryEngineering
Enginesim
Difficultyintermediate
Triggerevent
Steps5
Setup~15 min

How it runs

The automated pipeline, trigger to output.

  • TriggerRelease tag pushed (v*)GitHubGitHub
  • ActionDiff commits since previous tagGitHubGitHub
  • ActionDraft grouped release notes with AIOpenAI
  • ActionPublish notes to GitHub ReleaseGitHubGitHub
  • OutputAnnounce highlights in SlackSlack

What it does

On a new version tag, the workflow collects all commits merged since the last tag, summarizes them into human-readable release notes grouped by type (features, fixes, breaking changes), and publishes the result. It turns raw commit messages into notes a customer or teammate can actually read.

When to use it

When you cut releases by pushing semver tags and want consistent, well-organized release notes every time without writing them by hand. Ideal for teams using Conventional Commits or any reasonably structured commit history.

How it works

  1. 1A push of a tag matching your release pattern (such as v*) triggers the run.
  2. 2The workflow finds the previous tag and pulls the commit range between them from GitHub.
  3. 3An AI model reads the commit messages and PR titles and drafts notes grouped into Added, Fixed, Changed, and Breaking sections.
  4. 4It writes the generated notes to the GitHub Release body for that tag.
  5. 5It posts a short announcement with the highlights and a link to a release Slack channel.

Set it up

What you configure once, before turning it on.

  1. 1
    Connect GitHubRepos, issues, pull requests, actions.
  2. 2
    Connect OpenAIModels, embeddings, files.
  3. 3
    Connect SlackChannels, DMs, threads, mentions.
  4. 4
    Set each agent's modelWe leave models unset so you pick the tier — fast + cheap, or top-quality.
  5. 5
    Tune it to your dataEdit the prompts, filters, and field mappings so it matches how your team works.
  6. 6
    Test, then turn it onRun once against a sample, confirm the output, then enable the trigger.

Run this workflow in your colony.

14-day trial. No DevOps. No Sales call. Provisioned in under a minute.