/release-spec

name: release-spec
description: Generates App Store release documentation including submission guide, assets, privacy compliance, and marketing strategy. Creates RELEASE_SPEC.md for app launch. Use when preparing for App Store submission.
allowed-tools: [Read, Write, Glob, Grep, AskUserQuestion]
last_verified: 2026-07-16
review_by: 2027-06-22
os_version: iOS 27 / macOS 27

Release Specification Skill

Generate comprehensive App Store release and deployment documentation for iOS/macOS apps.

Metadata

• **Name**: release-spec
• **Version**: 1.0.0
• **Role**: Release Manager
• **Author**: ProductAgent Team

When This Skill Activates

This skill activates when the user says:

• "generate release spec"
• "create App Store submission guide"
• "write deployment documentation"
• "generate release documentation"
• "create App Store preparation guide"

Description

You are a Release Manager AI agent specializing in iOS/macOS app releases and App Store submissions. Your job is to transform all previous specifications (PRD, Architecture, UX, Implementation, Testing, ASO) into a comprehensive release specification that guides the user through every step of preparing, submitting, and launching their app on the App Store.

Prerequisites

Before activating this skill, ensure: 1. ASO optimization exists (from product-agent orchestration) with App Store metadata 2. ARCHITECTURE and IMPLEMENTATION_GUIDE exist with technical details 3. TEST_SPEC exists with quality checklist 4. All previous specifications are complete and approved

Input Sources

Read and extract information from:

1. **Product development plan** (product-plan-*.md)

• ASO optimization section (app name, subtitle, keywords, description, screenshots)
• Positioning and brand personality
• Target market

2. **docs/ARCHITECTURE.md**

• Tech stack and dependencies
• Build configuration
• Privacy requirements

3. **docs/IMPLEMENTATION_GUIDE.md**

• Project configuration details
• Dependencies
• Version numbering

4. **docs/TEST_SPEC.md**

• Pre-submission checklist
• Quality gates
• Beta testing plan

Output

Generate: **docs/RELEASE_SPEC.md**

Structure:

# Release Specification: [App Name]

**Version**: 1.0.0
**Last Updated**: [Date]
**Release Manager**: Release Manager AI
**Platform**: iOS [Version]+
**Target Release Date**: [Date]

---

## 0. Quick Start Checklist

For the impatient release manager:

**Week -2: Preparation**
- [ ] All development complete (from IMPLEMENTATION_GUIDE)
- [ ] All tests passing (from TEST_SPEC)
- [ ] App Store assets prepared (see Section 2)
- [ ] Privacy manifest added
- [ ] TestFlight beta started

**Week -1: Beta Testing**
- [ ] Beta testers recruited (20-50 people)
- [ ] Feedback collected and addressed
- [ ] No P0 bugs reported in last 3 days
- [ ] Crash-free rate > 99.5%

**Day of Submission**:
- [ ] Final build archived
- [ ] App validated in Xcode (no errors)
- [ ] App Store Connect metadata filled
- [ ] Submit for review
- [ ] Monitor review status daily

**Post-Submission**:
- [ ] App approved (24-48 hours typically)
- [ ] Choose release date or release immediately
- [ ] Monitor crash reports and reviews
- [ ] Respond to user reviews within 24-48 hours

---

## 1. App Store Metadata

All metadata is pre-filled from ASO optimization. Verify and copy to App Store Connect.

### 1.1 Basic Information

**App Name**: [From ASO optimization]
- Character limit: 30 characters
- Must be unique on App Store
- Can include keywords for ASO

**Subtitle**: [From ASO optimization]
- Character limit: 30 characters
- Summarizes app in one line
- Appears below app name in search results

**Primary Category**: [Choose most relevant]
- Productivity
- Business
- Lifestyle
- Finance
- Health & Fitness
- Social Networking
- Photo & Video
- Entertainment
- Utilities
- Education
- [Other - see full list in App Store Connect]

**Secondary Category**: [Optional]
- Choose if app fits multiple categories
- Increases discoverability

**Content Rating**:
- [ ] 4+ (No objectionable content)
- [ ] 9+ (Infrequent/mild content)
- [ ] 12+ (Frequent/intense content)
- [ ] 17+ (Frequent/intense mature content)

**Pricing**:
- [Free] (recommended for MVP launch)
- [Paid] - Price Tier: [Select tier, e.g., $0.99, $2.99, $4.99]
- [Freemium] - Free with In-App Purchases

### 1.2 Description

**Promotional Text** (170 characters, updateable without app review):

[Hook from ASO optimization - first 170 characters]

**Full Description** (4000 characters max):

[Complete description from ASO optimization]

[Paste the full ASO-optimized description here]

Features: • [Feature 1 from PRD - user benefit focused] • [Feature 2 from PRD] • [Feature 3 from PRD] • [Feature 4 from PRD]

[Social proof section if available]

[Call to action]

**What's New** (Version 1.0.0):

🎉 Initial Release!

Introducing [App Name]! [One-line value proposition]

Key Features: • [Feature 1] • [Feature 2] • [Feature 3]

We'd love to hear your feedback! Rate us and let us know how we can improve.

### 1.3 Keywords

**Keyword Field** (100 characters, comma-separated, no spaces):

[High-priority keywords from ASO optimization, comma-separated, exactly 100 chars] Example: productivity,task,manager,organize,notes,planner,calendar,todo,reminder

**Keyword Strategy**:
- Use high-priority keywords from ASO optimization
- No spaces (use commas only)
- Don't repeat app name (automatically indexed)
- Don't use competitor names
- Use both singular and plural if room

### 1.4 Support Information

**Support URL**: https://[yourwebsite].com/support
- Must be live and functional
- Include FAQ, contact form, or email
- Respond to inquiries within 24-48 hours

**Marketing URL**: https://[yourwebsite].com
- Landing page for the app
- Can include features, screenshots, testimonials
- Optional but recommended

**Privacy Policy URL**: https://[yourwebsite].com/privacy
- **REQUIRED** for all apps
- Must