/implementation-guide

name: implementation-guide
description: Generates detailed implementation guide with pseudo-code and step-by-step development instructions. Creates IMPLEMENTATION_GUIDE.md from PRD, Architecture, and UX specs. Use when creating development roadmap.
allowed-tools: [Read, Write, Glob, Grep, AskUserQuestion]
last_verified: 2026-07-16
review_by: 2027-06-22
os_version: iOS 27 / macOS 27

Implementation Guide Skill

Generate detailed implementation guide with pseudo-code and step-by-step instructions for iOS/macOS app development.

Metadata

• **Name**: implementation-guide
• **Version**: 1.0.0
• **Role**: Senior iOS/macOS Developer
• **Author**: ProductAgent Team

When This Skill Activates

This skill activates when the user says:

• "generate implementation guide"
• "create development guide"
• "write implementation steps"
• "generate code guide"
• "create developer guide from specs"

Description

You are a Senior iOS/macOS Developer AI agent with expertise in Swift, SwiftUI, SwiftData, and modern iOS development patterns. Your job is to transform product requirements, architecture, and UX specifications into a comprehensive, step-by-step implementation guide that enables any competent iOS developer to build the app confidently.

Prerequisites

Before activating this skill, ensure: 1. PRD exists (from prd-generator skill) with all features defined 2. ARCHITECTURE.md exists (from architecture-spec skill) with tech stack and structure 3. UX_SPEC.md exists (from ux-spec skill) with wireframes and interactions 4. DESIGN_SYSTEM.md exists with colors, typography, components

Input Sources

Read and extract information from:

1. **docs/PRD.md**

• All features and user stories
• Acceptance criteria
• Success metrics
• Timeline estimates

2. **docs/ARCHITECTURE.md**

• Architecture pattern (MVVM, Clean, TCA)
• Technology stack decisions
• Data models and relationships
• Module structure
• Networking layer design

3. **docs/UX_SPEC.md**

• All screens and wireframes
• User flows
• Interactions and gestures
• States (empty, loading, error)

4. **docs/DESIGN_SYSTEM.md**

• Colors, typography, spacing
• Component styles
• Animation timings
• Design tokens

5. **User clarifications** (ask if needed):

• Xcode version / minimum iOS version preferences
• Any existing codebase to integrate with
• CI/CD preferences (Xcode Cloud, GitHub Actions, Fastlane)

Output

Generate: **docs/IMPLEMENTATION_GUIDE.md**

Structure (comprehensive, ~3000-5000 lines):

# Implementation Guide: [App Name]

**Version**: 1.0.0
**Last Updated**: [Date]
**Platform**: iOS [Version]+
**Language**: Swift 5.9+
**Framework**: SwiftUI
**Xcode**: 15.0+

---

## 0. Quick Start

For the impatient developer:

```bash
# 1. Clone or create new Xcode project
# Template: iOS App (SwiftUI)
# Name: [AppName]
# Organization ID: com.yourcompany.appname
# Language: Swift
# Storage: SwiftData
# Include Tests: Yes

# 2. Set minimum deployment target
# Project Settings → General → Minimum Deployments: iOS 26.0 (or iOS 17+ for broader reach)

# 3. Add dependencies via SPM (if any)
# File → Add Package Dependencies → [URLs from ARCHITECTURE.md]

# 4. Create folder structure (see Section 2)

# 5. Follow implementation phases (Section 3)

# 6. Run tests frequently
xcodebuild test -scheme [AppName]

# 7. Launch and iterate

**Estimated Timeline**: [X] weeks for MVP (from PRD) **Estimated LOC**: ~[Y] lines of Swift code **Files to Create**: ~[Z] .swift files

---

1. Project Setup

1.1 Create Xcode Project

1. Open Xcode 15+ 2. File → New → Project 3. Choose template: **iOS → App** 4. Configuration:

• **Product Name**: [AppName]
• **Team**: [Your team or Personal Team]
• **Organization Identifier**: com.yourcompany.appname
• **Bundle Identifier**: [Auto-generated]
• **Interface**: SwiftUI
• **Language**: Swift
• **Storage**: SwiftData [or Core Data based on ARCHITECTURE]
• **Include Tests**: ✅ Yes
• **Create Git repository**: ✅ Optional but recommended

5. Click Create

1.2 Project Configuration

**File**: Select project in Navigator → General tab

**Deployment Info**:

• **Minimum Deployments**: iOS 26.0 [adjust based on ARCHITECTURE — iOS 17+ still supported for broader reach]
• **Supported Destinations**: iPhone (✅), iPad (based on requirements)
• **Device Orientation**:
• Portrait (✅ Required)
• Landscape Left (based on requirements)
• Landscape Right (based on requirements)

**App Icons & Launch Screen**:

• **App Icon**: Add 1024x1024 icon to Assets.xcassets/AppIcon
• **Launch Screen**: Use default or customize LaunchScreen.storyboard

**Signing & Capabilities**:

• **Team**: Select your development team
• **Signing Certificate**: Automatically manage signing (recommended)
• **Capabilities**: Add as needed:
• Push Notifications (if required)
• iCloud (if using CloudKit sync)
• Background Modes (if needed)

1.3 Add Dependencies (if any)

**From ARCHITECTURE.md**, add these packages:

**Example** (adjust based on actual ARCHITECTURE):

File → Add Package Dependencies

[If networking library needed]
1. Alamofire: https://github.com/Alamofire/Alamofire
   Version: 5.9.0+

[If image loading needed]
2. Kingfisher: https://github.com/onevcat/Kingfisher
   Version: 7.10.0+

[Add only packages specified in ARCHITECTURE.md]

**Important**: Minimize third-party dependencies. Use native frameworks when possible.

1.4 Configure SwiftData

**File**: [AppName]App.swift

import SwiftUI
import SwiftData

@main
struct AppNameApp: App {
    // Define the data model container
    var sharedModelContainer: ModelContainer = {
        let schema = Schema([
            // List all @Model classes here
            User.self,
            Item.self,
            // Add all data models from ARCHITECTURE.md
        ])

        let modelConfiguration = ModelConfiguration(
            schema: schema,
            isStored