release-spec

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]