initial commit

_bmad/wds/workflows/0-project-setup/workflow.md

@@ -0,0 +1,105 @@
+---
+name: project-setup
+description: Project onboarding - determine project type, complexity, tech stack, and route to correct phase
+web_bundle: true
+---
+
+# Phase 0: Project Setup
+
+**The starting point for every WDS project.**
+
+
+## Purpose
+
+Phase 0 ensures you start on the right path. Before diving into design work, we need to understand:
+
+1. **What is WDS?** - So you know what you're getting
+2. **What type of project?** - New product vs existing product
+3. **How complex?** - Landing page vs web application
+4. **What tech?** - Framework and component library choices
+5. **What's the right workflow?** - Route to the correct phase with right config
+
+---
+
+## Why This Matters
+
+**The #1 mistake**: Starting Phase 1 with an existing codebase.
+
+- **Phase 1-7** = Building something NEW (Greenfield)
+- **Phase 8** = Improving something EXISTING (Brownfield, Product Evolution)
+
+Wrong path = wasted work. Phase 0 prevents this.
+
+---
+
+## The Flow
+
+```
+Phase 0: Project Setup
+    │
+    ├─→ Step 01: Welcome
+    │       ├─→ "What is WDS?" (quick intro)
+    │       └─→ "Greenfield or Brownfield?"
+    │
+    └─→ Step 02: Configuration
+            ├─→ Project name
+            ├─→ Product complexity (landing/website/app)
+            ├─→ Tech stack (optional)
+            ├─→ Component library (optional)
+            ├─→ Brief level (complete/simplified)
+            ├─→ Strategic analysis (full/simplified/skip)
+            ├─→ Create folder structure
+            └─→ Generate project outline
+                    │
+                    ├─→ Greenfield → Phase 1 (→ Phase 2 if full analysis)
+                    └─→ Brownfield → Phase 8
+```
+
+---
+
+## Steps
+
+| Step | Name | Purpose |
+|------|------|---------|
+| 01 | [Welcome & Orientation](steps/step-01-welcome.md) | Introduce WDS, determine greenfield vs brownfield |
+| 02 | [Configuration & Structure](steps/step-02-structure.md) | Configure project, create folders, generate outline |
+
+---
+
+## Entry Point
+
+**Start here**: `steps/step-01-welcome.md`
+
+---
+
+## When to Use Phase 0
+
+- First time using WDS
+- Starting a new project
+- Joining an existing project
+- Unsure which workflow to use
+
+---
+
+## When to Skip Phase 0
+
+- Project outline already exists (`.wds-project-outline.yaml`)
+- You know exactly which phase you need
+- Continuing work on established WDS project
+
+---
+
+**Phase 0 takes 3-5 minutes. It saves hours of wrong-path work.**
+
+---
+
+## Configuration Options
+
+| Option | Values | Impact |
+|--------|--------|--------|
+| Project Type | greenfield / brownfield | Determines Phase 1-7 (greenfield) vs Phase 8 (brownfield) |
+| Complexity | simple / standard / complex | Which phases are enabled |
+| Tech Stack | react / vue / wordpress / etc. | Delivery format guidance |
+| Component Library | shadcn / tailwind / custom | Skip or enable Phase 5 |
+| Brief Level | complete / simplified | Depth of Phase 1 |
+| Strategic Analysis | full / simplified / skip | Full Trigger Map or simplified in brief |