release-notes-generator

name	release-notes-generator
description	Generate human-readable release notes from commits, pull requests, tags, and changelog fragments. Use when preparing a release summary for users, customers, or internal teams.

Release Notes Generator

Overview

Generate human-readable release notes from commits, pull requests, tags, and changelog fragments.

Core Workflow

1. Gather the source material, existing conventions, templates, and destination format before drafting.
2. Extract the information that matters most for the intended audience and discard low-signal noise.
3. Structure the output so it matches repo, team, or domain expectations instead of starting from a blank generic outline.
4. Draft the artifact, then surface any missing facts or decisions that still need human input.

Deliver

• A ready-to-edit draft in the expected structure and tone.
• The main sections, decisions, or states the artifact should include.
• Open questions or missing facts that would improve the final output.

Guardrails

• Do not invent facts, metrics, approvals, or guarantees that are not supported by the inputs.
• Prefer existing repo or team conventions over generic formatting.
• Keep the output useful and specific rather than padded.
• Prefer repository evidence, command output, and nearby tests over vague intuition.