Implementation Planning Skill

Create comprehensive implementation plans for any software project.

When to Use

• User asks to build an app, feature, or project
• User wants a plan before coding
• User asks "how would you build X"
• User mentions a problem that needs a solution

Clarifying Questions

If platform OR stack OR new/existing is not mentioned, ask before planning:

• What platform? (iOS, web, Android, CLI, API)
• New project or existing codebase?
• Any stack preferences or constraints?
• Timeline or complexity level?

Plan Levels

Quick (5 min)

• Overview + main files + key steps
• For simple features or prototypes
• Skip risks, API tables, and detailed testing

Detailed (15+ min)

• Full architecture + all files + testing + deployment
• For production apps or complex features
• Includes: Dependencies, API design, testing, risks

ALWAYS ask before generating: "Quick plan or detailed plan?"

Implementation Plan Template

Level 1: Quick Plan

# [Project] - Quick Plan

## What
[One sentence]

## Stack
- Frontend: [X]
- Backend: [X]
- Data: [X]

## Files
- [file1.swift]: [purpose]
- [file2.swift]: [purpose]

## Steps
1. [Step 1]
2. [Step 2]
3. [Step 3]

Level 2: Detailed Plan

# [Project Name] Implementation Plan

## Overview
[1-2 sentence description]

## Architecture
- Frontend: [framework/libraries]
- Backend: [if needed]
- Data: [storage]

## Files to Create

### Core
1. **App.swift** - Entry point
2. **MainView.swift** - Root view
3. **Model.swift** - Data models

### Features
4. **FeatureXView.swift** - UI
5. **FeatureXModel.swift** - Logic

## Step-by-Step

### Phase 1: Foundation
**Step 1: Setup**
- What: Create project, add deps
- Code: [snippet]

**Step 2: Models**
- What: Define data structures
- Code: [snippet]

### Phase 2: Core Features

### Phase 3: Polish

## Dependencies
| Package | Version | Purpose |
|---------|---------|---------|
| [name] | [v] | [why] |

## API Design (if backend)
| Endpoint | Method | Params | Response |
|----------|--------|--------|----------|
| /users | GET | - | User[] |

## Testing Strategy
- Unit: [what to test]
- Integration: [what to test]

## Risks & Mitigations
| Risk | Likelihood | Impact | Mitigation |
|------|------------|--------|------------|
| [X] | Low | High | [Y] |

## Running

[command]

## Next Steps
1. [Immediate action]
2. [After that]

## Plan Principles

1. **Ask level first** — ALWAYS ask "Quick plan or detailed plan?"
2. **Architecture before files** — Know the stack
3. **Files drive steps** — List files, then implement in order
4. **Dependencies first** — What must exist before X
5. **Code snippets, not dumps** — Show minimal working snippets for critical paths (e.g., key model, one core view), not full implementations
6. **Be specific** — Not "UI" but "LoginView with email/password fields"
7. **Include paths** — Sources/App/LoginView.swift

## Decision Criteria

Choose stack based on:
- **Mobile**: SwiftUI (iOS), Jetpack Compose (Android)
- **Web**: React, Vue, or server-side Swift
- **Backend**: Vapor, FastAPI, Express
- **Database**: SQLite (local), PostgreSQL (prod), Firebase (quick)

**If user just says "app" with no platform: ASK — do NOT assume mobile or web.**

If user context is iOS/macOS-heavy, you MAY suggest SwiftUI/Vapor/SQLite first, but still ASK before committing.

## Refinement Requests

- If user says "expand [phase]" → regenerate that phase in full detail
- If user says "redo with [X]" → re-emit only affected sections
- If user says "more details" → upgrade to Detailed plan

## Example Output (Quick Plan)

User: "Build me a todo app for iOS"

Todo App - Quick Plan

What

A simple iOS todo list app with add, complete, and delete features.

Stack

• Frontend: SwiftUI
• Backend: None (local storage)
• Data: UserDefaults

Files

• TodoApp.swift: App entry point
• ContentView.swift: Main list view
• Todo.swift: Data model
• TodoStore.swift: State management

Steps

1. Create SwiftUI project with XcodeGen
2. Define Todo model (id, title, isCompleted)
3. Build ContentView with List and TextField
4. Add/remove/toggle todo functionality
5. Persist to UserDefaults