whiteport-design-studio 0.2.2 → 0.3.0

package/docs/{learn-wds/module-02-installation-setup/lesson-03-git-cloning/02-full-lesson.md → learn/module-02-installation-setup/lesson-03-git-cloning.md}

@@ -1,4 +1,6 @@
-# Lesson 03: Git Repository Cloning
+# Module 02: Installation & Setup
+
+## Lesson 3: Git Repository Cloning
 
 **Clone your project to your computer**
 
@@ -42,7 +44,7 @@ cd ~/Projects
 1. Go to your repository on GitHub
 2. Click green **"Code"** button
 3. Make sure **"HTTPS"** selected
-4. Click copy icon (📋)
+4. Click copy icon
 
 **Your URL:** `https://github.com/your-username/your-project.git`
 
@@ -92,20 +94,19 @@ git clone https://github.com/john-designer/dog-walker-app.git
 
 ## Troubleshooting
 
-**Issue:** "Git command not found" → Let IDE install when prompted  
-**Issue:** "Permission denied" → Sign into GitHub in IDE  
+**Issue:** "Git command not found" → Let IDE install when prompted
+**Issue:** "Permission denied" → Sign into GitHub in IDE
 **Issue:** Clone fails → Check URL copied correctly
 
 ---
 
 ## What's Next?
 
-Project cloned! Now initialize WDS and meet Mimir.
+Project cloned! Now install WDS and start designing.
 
-**[Continue to Lesson 04: WDS Project Initialization →](../lesson-04-wds-initialization/02-full-lesson.md)**
+**[Continue to Lesson 04: WDS Project Initialization →](lesson-04-wds-initialization.md)**
 
 ---
 
-*Part of Module 02: Installation & Setup*  
-*[← Back to Module Overview](../module-02-overview.md)*
-
+*Part of Module 02: Installation & Setup*
+*[← Back to Module Overview](module-02-overview.md)*

package/docs/learn/module-02-installation-setup/lesson-04-wds-initialization.md

@@ -0,0 +1,133 @@
+# Module 02: Installation & Setup
+
+## Lesson 4: WDS Project Initialization
+
+**Install WDS and activate your first agent**
+
+---
+
+## What You'll Do
+
+- Install WDS via the CLI installer
+- Understand the folder structure
+- Activate an agent and start working
+
+**Time:** 10-15 minutes
+
+---
+
+## Step 1: Install WDS
+
+Navigate to your project folder in the terminal:
+
+```bash
+cd ~/Projects/your-project-name  # Mac/Linux
+cd C:\Projects\your-project-name # Windows
+```
+
+Run the installer:
+
+```bash
+npx whiteport-design-studio install
+```
+
+The installer will guide you through:
+- **Project type** — What kind of product you're designing
+- **Experience level** — Beginner, Intermediate, or Expert
+- **IDE configuration** — Sets up your AI IDE automatically
+
+**✅ Checkpoint:** Installer completes, `_bmad/wds/` folder appears in your project
+
+---
+
+## Step 2: Understand the Structure
+
+After installation, your project has:
+
+```
+your-project/
+├── _bmad/wds/               ← WDS system files
+│   ├── agents/              ← Agent files (.md)
+│   │   ├── saga-analyst.md
+│   │   ├── freya-ux.md
+│   ├── workflows/           ← Phase workflows
+│   ├── data/                ← Standards, frameworks
+│   ├── gems/                ← Reusable prompt components
+│   ├── templates/           ← Document templates
+│   └── config.yaml          ← Your project configuration
+├── _wds-learn/              ← Learning material (optional)
+├── docs/                    ← Design output (created by agents)
+│   ├── A-Product-Brief/
+│   ├── B-Trigger-Map/
+│   ├── C-UX-Scenarios/
+│   ├── D-Design-System/
+│   ├── E-PRD/
+│   └── _progress/
+└── .claude/instructions.md  ← IDE configuration
+```
+
+**Key insight:** `_bmad/wds/` contains the methodology. `docs/` is where your design work lives.
+
+---
+
+## Step 3: Activate an Agent
+
+WDS has three specialized agents:
+
+| Agent | What they do | When to use |
+|-------|-------------|-------------|
+| **Saga** | Business & Product Analyst | Product Brief, Trigger Mapping |
+| **Freya** | UX/UI Designer | Scenarios, UX Design, Visual Design |
+
+### Start with Saga
+
+For a new project, start with Saga to create your Product Brief:
+
+Tell your AI IDE:
+
+```
+Read and activate the agent in _bmad/wds/agents/saga-analyst.md
+```
+
+Saga will:
+- Introduce herself
+- Scan your project for existing WDS work
+- Guide you to the right starting point
+
+**✅ Checkpoint:** Saga responds and welcomes you!
+
+---
+
+## Troubleshooting
+
+**Issue:** `npx` command not found → Install Node.js from <https://nodejs.org>
+**Issue:** Installer fails → Make sure you're in your project folder
+**Issue:** Agent file not found → Check `_bmad/wds/agents/` folder exists
+
+---
+
+## Congratulations!
+
+You've completed Module 02: Installation & Setup!
+
+**What you accomplished:**
+- ✅ GitHub account & repository
+- ✅ IDE installed
+- ✅ Project cloned
+- ✅ WDS installed
+- ✅ Agent activated
+
+**You're ready to design with WDS!**
+
+---
+
+## What's Next?
+
+- **[Module 03: Alignment & Signoff](../module-03-alignment-signoff/module-03-overview.md)**
+- **[WDS Training Course](../00-course-overview/00-course-overview.md)**
+- **Ask Saga:** "What should I do next?"
+
+---
+
+*Part of Module 02: Installation & Setup*
+*[← Back to Module Overview](module-02-overview.md)*

package/docs/learn/module-02-installation-setup/module-02-overview.md

@@ -0,0 +1,59 @@
+# Module 02: Installation & Setup
+
+**From zero to WDS-ready - complete beginner friendly**
+
+---
+
+## Overview
+
+This module takes you from having nothing to being fully set up with WDS, even if you've never used GitHub or an IDE before.
+
+**Time:** 45-60 minutes total
+**Difficulty:** Beginner
+**Prerequisites:** Computer + Internet + Email
+
+---
+
+## Lessons
+
+### [Lesson 01: Git Setup](lesson-01-git-setup.md)
+**15-20 minutes** | Create GitHub account and repository
+
+### [Lesson 02: IDE Installation](lesson-02-ide-installation.md)
+**10 minutes** | Install Cursor or VS Code
+
+### [Lesson 03: Git Repository Cloning](lesson-03-git-cloning.md)
+**10 minutes** | Clone your project to your computer
+
+### [Lesson 04: WDS Project Initialization](lesson-04-wds-initialization.md)
+**10-15 minutes** | Install WDS, activate your first agent
+
+---
+
+## Quick Start
+
+**Want the fastest path?**
+
+Follow the combined checklist: [Tutorial: Quick Checklist →](tutorial-02.md)
+
+**Want detailed explanations?**
+
+Follow the lessons: [Start with Lesson 01 →](lesson-01-git-setup.md)
+
+---
+
+## After This Module
+
+- ✅ GitHub account and repository
+- ✅ IDE installed and configured
+- ✅ Project cloned to your computer
+- ✅ WDS installed in project
+- ✅ Docs folder structure created
+- ✅ Agent activated and ready
+
+**Next:** [Module 03: Alignment & Signoff](../module-03-alignment-signoff/module-03-overview.md)
+
+---
+
+*Part of the WDS Course: From Designer to Linchpin*
+*[← Back to Course Overview](../00-course-overview/00-course-overview.md)*

package/docs/learn/module-02-installation-setup/tutorial-02.md

@@ -0,0 +1,158 @@
+# Module 02: Installation & Setup — Quick Checklist
+
+**The fastest path from zero to WDS-ready**
+
+**⏱️ 45-60 minutes total**
+
+Just the action items. For detailed explanations, see the individual lessons.
+
+---
+
+## Lesson 01: Git Setup (15-20 min)
+
+*[Full lesson →](lesson-01-git-setup.md)*
+
+### Create GitHub Account
+
+- [ ] Go to **<https://github.com>**
+- [ ] Click **"Sign up"**
+- [ ] Enter email, password, username (professional: `yourname-designer`)
+- [ ] Verify email
+- [ ] ✅ Log in successful
+
+### Choose Your Scenario
+
+- [ ] **A:** Starting new project → Continue below
+- [ ] **B:** Joining existing → Skip to "Join Existing"
+- [ ] **C:** Just learning → Skip to Lesson 02 below
+
+### Create New Repository
+
+- [ ] Click profile icon → **"Your repositories"** → **"New"**
+
+**Decide: Single or Separate?**
+
+- [ ] **Single repo:** `my-project` (specs + code together, small teams)
+- [ ] **Separate repo:** `my-project-specs` (specs only, corporate/many devs)
+
+**Repository Settings:**
+
+- [ ] Name: `_____________` (lowercase-with-hyphens)
+- [ ] Description: One-liner about project
+- [ ] Public or Private
+- [ ] ☑️ Check "Initialize with README"
+- [ ] Click **"Create repository"**
+- [ ] ✅ Repository created
+
+### Join Existing Repository
+
+- [ ] Ask owner for access (see [full lesson](lesson-01-git-setup.md) for email template)
+- [ ] Accept invitation from email
+- [ ] Check repo structure
+- [ ] ✅ Access granted
+
+---
+
+## Lesson 02: IDE Installation (10 min)
+
+*[Full lesson →](lesson-02-ide-installation.md)*
+
+### Choose IDE
+
+- [ ] **Cursor** (recommended) → <https://cursor.sh>
+- [ ] **VS Code** (alternative) → <https://code.visualstudio.com>
+
+### Install
+
+- [ ] Download installer
+- [ ] **Windows:** Run `.exe`, click through
+- [ ] **Mac:** Drag to Applications, open
+- [ ] **Linux:** Follow distro instructions
+
+### First Launch
+
+- [ ] Choose theme (Light/Dark)
+- [ ] Sign in with GitHub → Yes!
+- [ ] Install recommended extensions → Yes
+- [ ] ✅ IDE open
+
+### Verify Terminal
+
+- [ ] Press **Ctrl+`** (Win/Linux) or **Cmd+`** (Mac)
+- [ ] ✅ Terminal panel appears
+
+---
+
+## Lesson 03: Git Repository Cloning (10 min)
+
+*[Full lesson →](lesson-03-git-cloning.md)*
+
+### Create Projects Folder
+
+In terminal (**Ctrl+`** or **Cmd+`**):
+
+```bash
+# Windows
+mkdir C:\Projects
+cd C:\Projects
+
+# Mac/Linux
+mkdir ~/Projects
+cd ~/Projects
+```
+
+- [ ] ✅ Projects folder created
+
+### Clone Your Repository
+
+- [ ] Go to your repo on GitHub → Click **"Code"** → Copy URL
+- [ ] In terminal: `git clone [paste-url]`
+- [ ] (If prompted: Install Git → Click "Install")
+- [ ] ✅ "done" message
+
+### Open Project in IDE
+
+- [ ] **File** → **Open Folder**
+- [ ] Select your project folder
+- [ ] ✅ Project in sidebar
+
+---
+
+## Lesson 04: WDS Initialization (10-15 min)
+
+*[Full lesson →](lesson-04-wds-initialization.md)*
+
+### Install WDS
+
+In terminal (in YOUR project folder):
+
+```bash
+cd ~/Projects/your-project-name  # or cd C:\Projects\your-project-name
+npx whiteport-design-studio install
+```
+
+- [ ] Follow the installer prompts (project type, experience level, IDE)
+- [ ] ✅ `_bmad/wds/` folder appears in your project
+
+### Activate an Agent
+
+- [ ] Tell your AI IDE: `Read and activate the agent in _bmad/wds/agents/saga-analyst.md`
+- [ ] ✅ Saga responds and welcomes you!
+
+---
+
+## Complete!
+
+- ✅ GitHub account & repository
+- ✅ IDE installed
+- ✅ Project cloned
+- ✅ WDS installed
+- ✅ Agent activated
+
+**Next:** [Module 03: Alignment & Signoff](../module-03-alignment-signoff/module-03-overview.md)
+
+---
+
+[← Back to Module Overview](module-02-overview.md)
+
+*Part of Module 02: Installation & Setup*

package/docs/{learn-wds → learn}/module-03-alignment-signoff/lesson-01-understanding-alignment.md

@@ -1,4 +1,6 @@
-# Lesson 1: Understanding Alignment
+# Module 03: Alignment & Signoff
+
+## Lesson 1: Understanding Alignment
 
 **Why alignment matters before starting work - and why understanding comes first**
 
@@ -132,7 +134,7 @@ Before you can create an alignment document, you need to understand what success
 - You have full autonomy
 - You don't need stakeholder approval
 
-**Go directly to:** [Module 04: Create Project Brief](../module-04-project-brief/tutorial-04.md)
+**Go directly to:** [Module 04: Product Brief](../module-04-product-brief/module-04-overview.md)
 
 ---
 
@@ -173,3 +175,5 @@ Before you can create an alignment document, you need to understand what success
 
 [← Back to Module Overview](module-03-overview.md)
 
+
+*Part of Module 03: Alignment & Signoff*

package/docs/{learn-wds → learn}/module-03-alignment-signoff/lesson-02-creating-alignment-document.md

@@ -1,4 +1,6 @@
-# Lesson 2: Creating Your Alignment Document
+# Module 03: Alignment & Signoff
+
+## Lesson 2: Creating Your Alignment Document
 
 **The 10 sections that ensure everyone understands and agrees - AFTER you've done discovery**
 
@@ -287,3 +289,5 @@ Work through these sections **in whatever order makes sense** for your thinking:
 
 [← Back to Module Overview](module-03-overview.md)
 
+
+*Part of Module 03: Alignment & Signoff*

package/docs/{learn-wds → learn}/module-03-alignment-signoff/lesson-03-negotiation-acceptance.md

@@ -1,4 +1,6 @@
-# Lesson 3: Negotiation & Acceptance
+# Module 03: Alignment & Signoff
+
+## Lesson 3: Negotiation & Acceptance
 
 **Getting everyone on the same page**
 
@@ -109,7 +111,9 @@
 
 ---
 
-**Next:** [Lesson 4: Securing Commitment →](lesson-04-securing-commitment.md)
+**Next:** [Lesson 4: Securing Commitment →](lesson-04-external-contracts.md)
 
 [← Back to Module Overview](module-03-overview.md)
 
+
+*Part of Module 03: Alignment & Signoff*

package/docs/{learn-wds → learn}/module-03-alignment-signoff/lesson-04-external-contracts.md

@@ -1,4 +1,6 @@
-# Lesson 4: External Contracts
+# Module 03: Alignment & Signoff
+
+## Lesson 4: External Contracts
 
 **Formalizing alignment with external contracts**
 
@@ -183,9 +185,9 @@
 - ✅ Alignment achieved
 - ✅ Commitment secured
 - ✅ Legal protection in place
-- ✅ Ready to proceed to Project Brief
+- ✅ Ready to proceed to Product Brief
 
-**Next:** [Module 04: Create Project Brief](../module-04-project-brief/tutorial-04.md)
+**Next:** [Module 04: Product Brief](../module-04-product-brief/module-04-overview.md)
 
 ---
 
@@ -199,3 +201,5 @@
 
 [← Back to Module Overview](module-03-overview.md)
 
+
+*Part of Module 03: Alignment & Signoff*

package/docs/{learn-wds → learn}/module-03-alignment-signoff/lesson-05-internal-signoff.md

@@ -1,4 +1,6 @@
-# Lesson 5: Internal Signoff Documents
+# Module 03: Alignment & Signoff
+
+## Lesson 5: Internal Signoff Documents
 
 **Formalizing alignment for internal company projects**
 
@@ -171,9 +173,9 @@
 - ✅ Internal alignment achieved
 - ✅ Budget/resources committed
 - ✅ Stakeholders on board
-- ✅ Ready to proceed to Project Brief
+- ✅ Ready to proceed to Product Brief
 
-**Next:** [Module 04: Create Project Brief](../module-04-project-brief/tutorial-04.md)
+**Next:** [Module 04: Product Brief](../module-04-product-brief/module-04-overview.md)
 
 ---
 
@@ -187,3 +189,5 @@
 
 [← Back to Module Overview](module-03-overview.md) | [Previous: Lesson 4: External Contracts →](lesson-04-external-contracts.md)
 
+
+*Part of Module 03: Alignment & Signoff*

package/docs/{learn-wds → learn}/module-03-alignment-signoff/module-03-overview.md

@@ -126,7 +126,7 @@ Step-by-step hands-on guide to creating your alignment document and securing sig
 6. **Get acceptance** - Accept: They say yes to the pitch
 7. **Generate signoff** - Contract: Create short, clear contract based on accepted pitch
 8. **Sign** - Both parties sign
-9. **Proceed to Project Brief** - Brief: Use pitch and contract as the backbone
+9. **Proceed to Product Brief** - Brief: Use pitch and contract as the backbone
 
 **Key:** Pitch and contract become the foundation for your project brief - not throwaway documents.
 
@@ -143,7 +143,7 @@ By the end of this module, you will:
 - ✅ Know how to create a compelling alignment document based on real understanding
 - ✅ Be able to negotiate and iterate until acceptance
 - ✅ Generate appropriate external contracts or internal signoff documents
-- ✅ Know when to skip this module and go straight to Project Brief
+- ✅ Know when to skip this module and go straight to Product Brief
 
 ---
 
@@ -154,7 +154,7 @@ By the end of this module, you will:
 - You have full autonomy
 - You don't need stakeholder approval
 
-**Go directly to:** [Module 04: Create Project Brief](../module-04-project-brief/tutorial-04.md)
+**Go directly to:** [Module 04: Product Brief](../module-04-product-brief/module-04-overview.md)
 
 ---
 
@@ -164,7 +164,7 @@ By the end of this module, you will:
 
 ---
 
-[← Back to Course Overview](../00-course-overview.md) | [Next: Module 04: Create Project Brief →](../module-04-project-brief/tutorial-04.md)
+[← Back to Course Overview](../00-course-overview/00-course-overview.md) | [Next: Module 04: Product Brief →](../module-04-product-brief/module-04-overview.md)
 
 *Part of the WDS Course: From Designer to Linchpin*
 

package/docs/{learn-wds → learn}/module-03-alignment-signoff/tutorial-03.md

@@ -53,7 +53,7 @@ This tutorial walks you through the professional process of understanding what y
 - **Consultant proposing to client** → Discovery will help you understand their business needs
 - **Business hiring suppliers** → Discovery will help you clarify what you're buying
 - **Manager/employee seeking approval** → Discovery will help you understand stakeholder priorities
-- **Doing it yourself** → Skip this tutorial, go to Module 04: Create Project Brief
+- **Doing it yourself** → Skip this tutorial, go to Module 04: Create Product Brief
 
 **Your scenario:** [Write your scenario here]
 
@@ -278,7 +278,7 @@ The Strategic Professional emphasizes: "Long contracts are hard to understand, a
 - ✅ Foundation established
 - ✅ Pitch and contract ready to become backbone of project brief
 
-**The connection:** The pitch and contract aren't throwaway documents. When you move to Module 04 to create your Project Brief, these documents become the foundation. The brief builds on the alignment and legal framework you've established.
+**The connection:** The pitch and contract aren't throwaway documents. When you move to Module 04 to create your Product Brief, these documents become the foundation. The brief builds on the alignment and legal framework you've established.
 
 **Workflow complete:**
 1. ✅ Listen - Discovery meeting
@@ -290,7 +290,7 @@ The Strategic Professional emphasizes: "Long contracts are hard to understand, a
 7. ✅ Sign - Both parties committed
 8. ➡️ **Next:** Brief - Use pitch and contract as backbone
 
-**Next:** [Module 04: Create Project Brief](../module-04-project-brief/tutorial-04.md)
+**Next:** [Module 04: Product Brief](../module-04-product-brief/module-04-overview.md)
 
 ---
 
@@ -303,7 +303,7 @@ You've completed this tutorial when:
 - ✅ Alignment document shared in presentation meeting
 - ✅ Stakeholders have accepted (everyone aligned)
 - ✅ Signoff document generated and ready for signature
-- ✅ Ready to proceed to Project Brief
+- ✅ Ready to proceed to Product Brief
 
 ---
 
@@ -334,11 +334,11 @@ A: Variable - discovery meeting (30-60 min), document creation (30-60 min), pres
 
 ## Next Steps
 
-**[Continue to Module 04: Create Project Brief →](../module-04-project-brief/tutorial-04.md)**
+**[Continue to Module 04: Product Brief →](../module-04-product-brief/module-04-overview.md)**
 
 ---
 
-[← Back to Module Overview](module-03-overview.md) | [Back to Course Overview](../00-course-overview.md)
+[← Back to Module Overview](module-03-overview.md) | [Back to Course Overview](../00-course-overview/00-course-overview.md)
 
-*Part of the WDS Course: From Designer to Linchpin*
+*Part of Module 03: Alignment & Signoff*
 

package/docs/{learn-wds → learn}/module-04-product-brief/lesson-01-chaos-problem.md

@@ -191,3 +191,5 @@ In the next lesson, we'll explore the 5 strategic questions that every Product B
 ---
 
 [← Back to Module Overview](module-04-overview.md)
+
+*Part of Module 04: Product Brief*

package/docs/{learn-wds → learn}/module-04-product-brief/lesson-02-five-questions.md

@@ -362,3 +362,5 @@ In the next lesson, we'll look at what a Product Brief actually looks like - the
 ---
 
 [← Back to Lesson 1](lesson-01-chaos-problem.md) | [Back to Module Overview](module-04-overview.md)
+
+*Part of Module 04: Product Brief*

package/docs/{learn-wds → learn}/module-04-product-brief/lesson-03-document-structure.md

@@ -27,7 +27,7 @@ It's a 2-3 page strategic document that answers the 5 critical questions clearly
 Here's what a Product Brief looks like:
 
 ```markdown
-# Project Brief: [Project Name]
+# Product Brief: [Project Name]
 
 ## Vision
 
@@ -386,3 +386,5 @@ In the next lesson, we'll explore how WDS makes creating this document fast thro
 ---
 
 [← Back to Lesson 2](lesson-02-five-questions.md) | [Back to Module Overview](module-04-overview.md)
+
+*Part of Module 04: Product Brief*

package/docs/{learn-wds → learn}/module-04-product-brief/lesson-04-wds-advantage.md

@@ -173,9 +173,9 @@ You see the document building in real-time:
 
 **How it works:**
 
-**SMART Goal Validation:**
+**Applying the SMART Model:**
 - You: "We want to increase engagement"
-- Saga: "Let's make that measurable - by how much and by when?"
+- Saga: "Let's make that measurable using SMART - by how much and by when?"
 - You: "40% increase in daily active users within 3 months"
 - Saga: "Perfect - that's specific, measurable, and time-bound"
 
@@ -400,3 +400,5 @@ In the next lesson, we'll explore how teams actually use the Product Brief throu
 ---
 
 [← Back to Lesson 3](lesson-03-document-structure.md) | [Back to Module Overview](module-04-overview.md)
+
+*Part of Module 04: Product Brief*

package/docs/{learn-wds → learn}/module-04-product-brief/lesson-05-using-brief.md

@@ -489,3 +489,5 @@ In the final lesson, we'll explore the additional strategic documents you can cr
 ---
 
 [← Back to Lesson 4](lesson-04-wds-advantage.md) | [Back to Module Overview](module-04-overview.md)
+
+*Part of Module 04: Product Brief*

package/docs/{learn-wds → learn}/module-04-product-brief/lesson-06-additional-documents.md

@@ -630,7 +630,7 @@ You now understand:
 - Make it your single source of truth
 
 **4. Continue to Module 05**
-- [Module 05: Trigger Mapping](../module-05-trigger-mapping/module-05-overview.md)
+- [Module 05: Platform Requirements](../module-05-platform-requirements/module-05-platform-requirements-overview.md)
 - Understanding user psychology
 - Connecting business goals to user needs
 
@@ -643,3 +643,5 @@ You now understand:
 [← Back to Lesson 5](lesson-05-using-brief.md) | [Back to Module Overview](module-04-overview.md)
 
 *Congratulations on completing Module 04! You now have the foundation to create strategic clarity for any project.*
+
+*Part of Module 04: Product Brief*