asc What's New Writer

Generate engaging, localized release notes from flexible input. Optionally pair with promotional text updates.

Preconditions

• Metadata pulled locally into canonical files via asc metadata pull --app "APP_ID" --version "1.2.3" --dir "./metadata". OR: user provides keywords manually.
• Auth configured for upload (asc auth login or ASC_* env vars).
• The primary locale is en-US unless the user specifies otherwise.

Before You Start

1. Read references/release_notes_guidelines.md for tone, structure, and examples.
2. Identify the latest version directory under metadata/version/ (highest semver). Use this for all metadata reads.
3. Enumerate existing locales by listing the JSON files in that version directory.

Phase 1: Gather Input

Accept one of three input modes (auto-detect):

Git Log

Parse commits since the last tag:

# Find latest tag
git describe --tags --abbrev=0

# List commits since that tag
git log $(git describe --tags --abbrev=0)..HEAD --oneline --no-merges

Filter out noise: merge commits, dependency bumps, CI changes, formatting-only commits. Extract user-facing changes.

Bullet Points

User provides rough bullets like:

• "improved search"
• "fixed crash on launch"
• "added sleep timer"

Free Text

User describes changes conversationally:

"We made search faster, fixed that annoying crash when you open the app, and added a sleep timer feature"

The skill extracts and structures the changes from the text.

No Input Provided

Prompt the user: "What changed in this release? You can paste git log output, bullet points, or just describe the changes."

Phase 2: Draft Notes (Primary Locale)

Step 1: Classify Changes

Group changes into sections per the guidelines:

• New, new features or capabilities
• Improved, enhancements to existing features
• Fixed, bug fixes users would notice

Omit empty sections. If all changes are fixes, only show "Fixed."