implementation-guide

What it does

Converts product requirements, architecture, and UX specifications into a comprehensive, phase-driven implementation guide for iOS/macOS development. The guide instructs how to set up Xcode projects, configure SwiftData, establish folder structures, and outline implementation phases with concrete code scaffolding and file templates. It outputs a single documentation file named IMPLEMENTATION_GUIDE.md containing sections for quick start, project setup, file structure, and phased tasks.

How it works

• Pulls inputs from docs/PRD.md, docs/ARCHITECTURE.md, docs/UX_SPEC.md, and docs/DESIGN_SYSTEM.md.
• Verifies prerequisites presence before generating the guide:
  • PRD.md, ARCHITECTURE.md, UX_SPEC.md, DESIGN_SYSTEM.md exist.
• Produces a structured, step-by-step guide with concrete commands, file paths, and code samples in Swift/SwiftUI context.
• Describes the project scaffold, including folder hierarchy, model definitions, and core infrastructure patterns, using the provided architecture references as anchors.
• Includes a Quick Start, project setup steps, dependency configuration, SwiftData configuration, file structure blueprint, and Implementation Phases with concrete actions and example code blocks.

When to use it

Use when forming a development roadmap from PRD, Architecture, and UX specs to create a runnable, scalable iOS/macOS project plan. Triggered by phrases like "generate implementation guide", "create development guide", or "write implementation steps".

What it can touch

• Reads: docs/PRD.md, docs/ARCHITECTURE.md, docs/UX_SPEC.md, docs/DESIGN_SYSTEM.md
• Writes: docs/IMPLEMENTATION_GUIDE.md
• Examples of touched concepts: project setup, SwiftData configuration, folder structure, model scaffolding, and phased development plan.

Caveats

• Output relies on existence and consistency of input docs (PRD, ARCHITECTURE, UX_SPEC, DESIGN_SYSTEM).
• Generated guide provides scaffolding, not compiled or runnable project by itself.
• Content adheres to the specified SwiftData-based model scaffolding as shown in examples (User, Item) but must be adapted to actual ARCHITECTURE.md models.