update-store-release-notes

---
name: update-store-release-notes
description: Update and localize FeedFlow release notes when the user provides platform-specific changelog copy. Use for Android Google Play, iOS App Store, macOS App Store, and Windows Microsoft Store release-note updates, including requests to translate notes for every configured store locale.
---

# Update FeedFlow Store Release Notes

Use the user-provided copy as the source of truth. Preserve platform-specific wording; do not force one platform's copy onto another.

## Workflow

1. Inspect the target artifacts, locale set, and current working-tree status before editing.
2. Replace the English source and translate it for every configured target locale. Do not invent feature claims or omit user-supplied bullets.
3. Keep the writing short, user-facing, and benefit-led. Preserve bullet formatting when supplied.
4. Validate the exact artifact format and limits. Run `git diff --check`. Run the smallest relevant build or validation only when the changed artifact requires it.

Respect a user request to translate store copy even if general project localization guidance normally delegates translations.

## Android: Google Play

- Write production notes to `androidApp/src/googlePlay/play/release-notes/<locale>/production.txt`.
- `en-US/production.txt` is the English source. Every existing locale directory is a target; create `production.txt` in empty locale directories.
- Keep each note at or below 500 characters, counted with Python `len()` on the UTF-8 text (`wc -m` counts bytes in the C locale).
- Do not edit `alpha.txt` unless the user explicitly requests alpha-track notes.
- Return Android notes in chat as one XML-like block per locale when requested. Use the exact folder name as the tag, keep `en-US` first, then list the remaining configured locales in alphabetical order:

  ```text
  <en-US>
  • English release note
  </en-US>
  <bg>
  • Bulgarian release note
  </bg>
  ```

## iOS and macOS: App Store Connect

- Treat iOS and macOS as separate products: accept and maintain separate platform copy.
- The committed source is `assets/storecopy/app-store-release-notes.json` (`ios`/`macos` → locale → bullet array); update it first, then push each locale's bullets joined with `\n` as `whatsNew`.
- Inspect App Store Connect first to discover the version and its actual localization set. Use `asc` to pull the relevant version localizations, update each locale's `whatsNew`, then pull/validate again to confirm the remote result.
- Use `en-US` as the source locale and translate only into locales exposed for that specific product/version. Do not create an App Store task for a locale App Store Connect does not support.
- Use the platform's field limits reported by `asc`; shorten translations as needed while retaining all material points.
- Never upload or submit a build as part of a text-only release-note request unless the user explicitly asks.

## Windows: Microsoft Store

- Update `assets/storecopy/microsoft-store-release-notes.json`.
- Keep the top-level `notes` object. Each locale value is an array of non-empty bullet strings; `pcenter` joins the array with CRLF, which is what the Store renders as line breaks.
- Match every Partner Center listing locale. A Store locale missing from this file is a **hard failure** at publish time rather than an empty changelog in that language; a locale present here that the Store does not have is only a warning. Matching is case-insensitive. Discover the live set with `pcenter locales list` rather than assuming a static list.
- Validate the JSON before finishing, for example with `jq empty assets/storecopy/microsoft-store-release-notes.json`.
- **This skill's output is the file, nothing more.** Writing it is the whole job — the release workflow reads it at release time. Do not publish or commit the Microsoft Store submission unless the user explicitly asks.

## Final Report

State the platforms and locale count updated, list any unavailable or unsupported locales, and report the validations actually run.

• SKILL.md 4 KB
• agents/openai.yaml 1 KB