release-notes

Release Notes Generator transforms technical inputs, such as JIRA or Linear tickets, PRDs, Git logs, or internal changelogs, into polished, user-facing release notes and changelogs. When source files are provided it reads them first; when a product URL is mentioned it can use web search to understand the product and its audience. The goal is clear, engaging summaries that lead with user benefit rather than implementation detail, suitable for announcing product updates or summarizing what shipped.

The process begins by gathering raw material and extracting, for each change, what changed, who it affects, and why it matters. Changes are then sorted into standard categories: New Features for entirely new capabilities, Improvements for enhancements to existing features, Bug Fixes for resolved issues, Breaking Changes for anything requiring user action such as migrations or API changes, and Deprecations for features being sunset. Each entry is written to lead with the user benefit, use plain language free of jargon, internal codenames, and ticket numbers, and stay to one to three sentences. Worked example transformations show how a technical note, such as implementing a Redis caching layer for dashboard endpoints, becomes a benefit-focused line about dashboards loading up to three times faster, or how a fixed race condition becomes a plain statement that orders no longer fail during high-traffic periods.

Output follows a consistent structure headed by product name and version or date, with a section per category and an explicit action-required callout for breaking changes. Screenshots or visuals are included when the user supplies them. Tone is tuned to the product's voice: professional for B2B, friendly for consumer products, and developer-focused for APIs. The result is saved as a Markdown document by default and can be converted to HTML or another format on request. The overall effect is to turn scattered, engineering-oriented records into a single readable narrative that communicates value to end users while still flagging anything that requires action on their part.