release-spec

What this skill does

# 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:

```markdown
# 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 disclose all data collection
- Must be accessible and readable
- Can use privacy policy generator if needed

**Copyright**: © 2024 [Your Company Name]

---

## 2. App Store Assets

### 2.1 App Icon

**Requirements**:
- Size: 1024x1024 pixels
- Format: PNG (no transparency)
- Color space: sRGB or Display P3
- File size: < 1 MB

**Design Specifications** (from DESIGN_SYSTEM.md):
```
Based on your brand colors and design system:

Background: [Brand primary color or gradient]
Icon/Symbol: [From brand identity]
Style: [Flat, skeuomorphic, gradient - match design system]

Design Tips:
- Simple and recognizable at small sizes
- No words or detailed graphics
- Avoid transparencies and rounded corners (iOS adds automatically)
- Test at multiple sizes (iPhone, iPad, App Store)
```

**Creation**:
1. Design in Figma/Sketch/Illustrator at 1024x1024px
2. Export as PNG
3. Add to `Assets.xcassets/AppIcon.appiconset/`
4. Xcode will generate all required sizes automatically

**Tools**:
- [App Icon Generator](https://appicon.co) - Generate from 1024px source
- [IconKit](https://apps.apple.com/app/iconkit/id507135296) - Mac app for icon generation

### 2.2 Screenshots

**Required Sizes**:
- **iPhone 6.7" Display** (1290 x 2796 px) - iPhone 15 Pro Max - **REQUIRED**
- **iPhone 6.5" Display** (1242 x 2688 px) - iPhone 11 Pro Max - **Recommended**
- **iPad Pro 12.9" Display** (2048 x 2732 px) - If supporting iPad

**Quantity**: 3-10 screenshots per size (5 recommended)

**Screenshot Strategy** (from ASO optimization):

**Screenshot 1: Hero/Value Proposition**
```
Content: [Main screen showing primary feature]
Caption: "[Benefit-focused headline from ASO]"

Design:
- Show actual app UI (not marketing fluff)
- Highlight key benefit with overlay text
- Use brand colors for text
- Clear, large, readable text

Device Frame: Optional (makes it look polished)
```

**Screenshot 2: Key Feature #1**
```
Content: [Feature in action - from PRD P0 features]
Caption: "[Clear outcome or benefit]"

Example for task manager:
Show: Today view with tasks checked off
Caption: "Get things done. Stay organized."
```

**Screenshot 3: Key Feature #2**
```
Content: [Second most important feature]
Caption: "[Supporting benefit]"
```

**Screenshot 4: Key Feature #3 or Social Proof**
```
Content: [Third feature OR testimonial/rating visual]
Caption: "[Supporting benefit]" OR "Loved by users