whats-new

The whats-new skill is an automated release note generator designed to bridge the gap between technical git history and user-facing App Store updates. By identifying the two most recent version bump commits in the main repository branch, the agent isolates the delta of changes since the previous release. It effectively parses commit messages and, where necessary, inspects diffs to distinguish between trivial internal refactors, infrastructure modifications, and tangible user-facing features or bug fixes.

This utility is intended for software developers and release managers who want to maintain high-quality, friendly release notes without manual document tracking. It automatically categorizes development efforts into New Features, Improvements, and Bug Fixes, ensuring that technical jargon is stripped away in favor of concise, audience-appropriate language. The tool produces output formatted specifically for standard App Store guidelines, providing a ready-to-use version summary.

• Automatically identifies previous archive points via git log pattern matching.

• Filters out noise such as CI/build configurations, developer tooling, and non-visible refactoring.

• Groups changes into structured categories for readability.

• Formats output for immediate use in App Store release submission fields.

• Supports optional version number override through command-line arguments.

• Designed for standard git-flow workflows using descriptive commit messages.

• Operates best when the repository follows a consistent 'Bump version' commit convention.

• Aimed at producing 3 to 8 concise, non-technical bullet points for optimal user engagement.

• Constraints: Requires shell environment access to execute git commands and assumes standard POSIX compliance for grep and log utilities.

• Users should review the generated notes for tone and accuracy before publishing to the App Store Connect dashboard.