# XCode-Claude-Workflow

A structured 8-phase workflow for building App Store-ready iOS/macOS applications using **Xcode + Claude Code**.

## What This Is

A methodology prompt ([PROMPT.md](PROMPT.md)) that guides Claude Code through transforming existing code — prototypes, web apps, partial implementations — into production-quality native Apple applications.

## How to Use

1. Clone this repo
2. Point Claude Code to your existing code folder
3. Paste or reference `PROMPT.md` as the task prompt
4. Follow the 8 phases: Audit → Architecture → Implementation → Persistence → Accessibility → Quality → App Store → Documentation

## Phases

| # | Phase | What Happens |
|---|-------|-------------|
| 0 | Codebase Intake | Read every file, produce audit report, confirm platform |
| 1 | Architecture | Propose pattern (MVVM/TCA), scaffold Xcode project |
| 2 | Core Features | Implement one feature at a time with tests |
| 3 | Data & Persistence | SwiftData, networking, error states |
| 4 | Accessibility | VoiceOver, Dynamic Type, localization |
| 5 | Performance | Instruments profiling, 70%+ test coverage |
| 6 | App Store Prep | Privacy manifest, icons, archive, metadata |
| 7 | Documentation | SETUP.md, CHANGELOG.md, ARCHITECTURE.md |

## Example

This workflow was used to build [SoliCards-iOS-iPadOS-MacOS](https://git.istratai.cloud/aj/SoliCards-iOS-iPadOS-MacOS) — a solitaire card game ported from JavaScript to native SwiftUI for iOS, iPadOS, and macOS.