asc-whats-new-writer

1# asc What's New Writer
2 
3Generate engaging, localized release notes from flexible input. Optionally pair with promotional text updates.
4 
5## Preconditions
6 
7- Metadata pulled locally into canonical files via `asc metadata pull --app "APP_ID" --version "1.2.3" --dir "./metadata"`. OR: user provides keywords manually.
8- Auth configured for upload (`asc auth login` or `ASC_*` env vars).
9- The **primary locale** is `en-US` unless the user specifies otherwise.
10 
11## Before You Start
12 
131. Read `references/release_notes_guidelines.md` for tone, structure, and examples.
142. Identify the **latest version directory** under `metadata/version/` (highest semver). Use this for all metadata reads.
153. Enumerate **existing locales** by listing the JSON files in that version directory.
16 
17## Phase 1: Gather Input
18 
19Accept one of three input modes (auto-detect):
20 
21### Git Log
22 
23Parse commits since the last tag:
24 
25```bash
26# Find latest tag
27git describe --tags --abbrev=0
28 
29# List commits since that tag
30git log $(git describe --tags --abbrev=0)..HEAD --oneline --no-merges
31```
32 
33Filter out noise: merge commits, dependency bumps, CI changes, formatting-only commits. Extract user-facing changes.
34 
35### Bullet Points
36 
37User provides rough bullets like:
38- "improved search"
39- "fixed crash on launch"
40- "added sleep timer"
41 
42### Free Text
43 
44User describes changes conversationally:
45> "We made search faster, fixed that annoying crash when you open the app, and added a sleep timer feature"
46…