SwiftUI + SwiftData MVP Planner

This skill enforces a structured, plan-first development workflow for SwiftUI applications using SwiftData and MVVM architecture. It guides AI agents to create detailed implementation plans, get user approval before coding, and maintain comprehensive documentation throughout development.

Instructions

1. Plan & Review Workflow

**Before starting any implementation work:**

1. **Create a detailed plan** at `.claude/tasks/TASK_NAME.md` that includes:

- Clear problem statement

- Proposed solution with reasoning

- Tasks broken down into implementable steps

- MVVM architecture considerations

- Platform-specific requirements (iOS/macOS)

- SwiftData model changes if needed

2. **Keep it MVP-focused**: Don't over-plan. Focus on the minimum viable solution that solves the user's need.

3. **Request approval**: After writing the plan, **ask the user to review it. Do NOT continue until they approve the plan.**

4. **Update during implementation**: As you work, update the plan with:

- Task completion status

- Detailed descriptions of changes made

- Deviations from original plan (with reasoning)

- Issues encountered and solutions

5. **Enable handover**: Document changes so thoroughly that another engineer could continue the work seamlessly.

2. Architecture Requirements

**Always use MVVM (Model-View-ViewModel) pattern:**

3. Project-Specific Context

**Tech Stack:**

**Key Files:**

**Platform Considerations:**

4. Common Commands

**Build:**

```bash

xcodebuild -scheme "Party Games" -destination "platform=iOS Simulator,name=iPhone 16" build

```

**Test:**

```bash

xcodebuild test -scheme "Party Games" -destination "platform=iOS Simulator,name=iPhone 16"

```

5. Development Standards

**SwiftData Usage:**

**Testing:**

**Code Style:**

Example Usage

**User:** "Add a favorites feature to items"

**Agent:**

1. Creates `.claude/tasks/add-favorites-feature.md` with:

- Plan: Add `isFavorite` Bool to Item model, create FavoriteItemsView, update ContentView with filter toggle

- Architecture: New ViewModel for favorites filtering, update Item model

- Tasks: (1) Update schema, (2) Create ViewModel, (3) Add UI toggle, (4) Write tests

2. Asks: "I've created a plan at `.claude/tasks/add-favorites-feature.md`. Please review it before I proceed with implementation."

3. **Waits for approval**

4. After approval, implements changes and updates the plan with detailed change descriptions

Constraints