App Store Release Notes

Create ready-to-paste App Store Connect "What's New" notes for a new release. The output must be compact, clear, user-facing, and based on real changes.

Workflow

1. Identify the comparison range.

   • If the user specifies a previous version, tag, branch, or commit, use it as the base.
   • If no previous version is specified, find the latest relevant git tag and use it as the base.
   • If the user specifies a target version, tag, branch, or commit, use it as the target.
   • If no target is specified, use the latest code, normally HEAD.
   • If no tags exist, compare against the earliest useful commit or summarize recent history, and state the assumption briefly before the notes.

2. Inspect git history and changed files.

   • Prefer commands like git tag --sort=-v:refname, git log --oneline <base>..<target>, git diff --stat <base>..<target>, and targeted git diff --name-only <base>..<target>.
   • Read relevant files or diffs when commit messages are too vague.
   • Look for app version files only when needed to confirm the release version.