whiteport-design-studio 0.1.0

package/docs/learn-wds/module-01-why-wds-matters/module-01-overview.md

@@ -0,0 +1,109 @@
+# Module 01: Why WDS Matters
+
+**Learn how to be indispensable in the AI era**
+
+---
+
+## Module Overview
+
+This foundational module transforms how you think about your role as a designer in the AI era. You'll learn why mastering WDS makes you irreplaceable and how to become a linchpin designer - the person who makes things happen.
+
+**Time:** ~30 minutes (3 lessons × 10 min each)
+**Prerequisites:** None - this is where you start!
+
+---
+
+## What You'll Learn
+
+- Why designers are more valuable than ever in the AI era
+- The difference between factory work and linchpin work
+- What AI can and cannot do in design
+- The 5 dimensions of design thinking
+- How to become the gatekeeper between business and user needs
+- The paradigm shift: design becomes specification
+
+---
+
+## Lessons
+
+### [Lesson 1: The Problem We're Solving](lesson-01-the-problem.md)
+
+**Time:** 10 minutes
+
+Understanding the factory mindset and the AI era:
+
+- Why learning WDS matters
+- What you'll gain from this course
+- Factory mindset vs linchpin mindset
+- AI threat for cogs
+- AI opportunity for linchpin designers
+
+### [Lesson 2: Becoming a Linchpin Designer](lesson-02-the-solution.md)
+
+**Time:** 10 minutes
+
+The solution: WDS methodology:
+
+- What makes a linchpin designer
+- The designer's gift: user-centric creativity
+- The designer as gatekeeper
+- From cog to linchpin designer
+- The paradigm shift: design becomes specification
+
+### [Lesson 3: Your Transformation](lesson-03-the-path-forward.md)
+
+**Time:** 10 minutes
+
+From replaceable to indispensable:
+
+- The 5 dimensions of design thinking
+- Your transformation as a designer
+- Real-world case studies (Dog Week)
+- Module completion and next steps
+
+---
+
+## Key Concepts
+
+**Linchpin Designer:**
+
+- Walks into chaos and creates order
+- Invents solutions nobody expected
+- Bridges business, psychology, and technology
+- Delivers results when there's no roadmap
+
+**User-Centric Creativity:**
+
+- Understanding WHY users feel frustrated
+- Connecting business goals to human needs
+- Creating experiences that feel right
+- Making judgment calls that serve people
+- Being the gatekeeper for quality
+
+**The Paradigm Shift:**
+
+- The design becomes the specification
+- The specification becomes the product
+- The code is just the printout
+
+---
+
+## Learning Outcomes
+
+By the end of this module, you will:
+
+- ✅ Understand why designers are irreplaceable in the AI era
+- ✅ Know the difference between cog work and linchpin work
+- ✅ Recognize what AI can and cannot do
+- ✅ See how specifications replace prompting
+- ✅ Be motivated to master the WDS methodology
+
+---
+
+## Start Learning
+
+**[Begin with Lesson 1: The Problem →](lesson-01-the-problem.md)**
+
+---
+
+[← Back to Course Start](../00-start-here.md)

package/docs/learn-wds/module-02-installation-setup/lesson-01-git-setup/01-lesson.md

@@ -0,0 +1,124 @@
+# Lesson 01: Git Setup
+
+**Create GitHub account and project repository**
+
+---
+
+## What You'll Do
+
+- Create GitHub account
+- Choose professional username
+- Create or join repository
+- Understand repository structure
+
+**Time:** 15-20 minutes
+
+---
+
+## Part 1: Create GitHub Account
+
+### What is GitHub?
+
+Professional cloud storage + time machine for your project files. Every change is saved, you can go back to any version, work with others.
+
+### Step 1: Sign Up
+
+1. Go to **<https://github.com>**
+2. Click **"Sign up"**
+3. Enter email, password, username
+
+**Username Tips:**
+- Professional: `john-designer`, `sarahux`, `mike-creates`
+- You might share this with clients
+
+4. Verify email
+5. Log in
+
+**✅ Checkpoint:** You can log in to GitHub
+
+---
+
+## Part 2: Choose Your Scenario
+
+**Scenario A:** Starting new project → Continue to Part 3  
+**Scenario B:** Joining existing → Skip to Part 5  
+**Scenario C:** Just learning → Skip to [Lesson 02](../lesson-02-ide-installation/02-full-lesson.md)
+
+---
+
+## Part 3: Create Repository
+
+1. Click profile icon → **"Your repositories"** → **"New"**
+
+### Decide Repository Structure
+
+**IMPORTANT: Your naming choice determines your structure!**
+
+**Single Repository:**
+- Name: `my-project` (e.g., `dog-walker-app`)
+- Structure: Specs + code together
+- Use when: Small team, building yourself, simple communication
+
+**Separate Specifications Repository:**
+- Name: `my-project-specs` (e.g., `dog-walker-app-specs`)
+- Structure: Specs only, separate code repo
+- Use when: Corporate, many developers, clear handoff needed
+
+---
+
+## Part 4: Create Repository
+
+**Repository Settings:**
+- Name: `____________` (lowercase-with-hyphens)
+- Description: One-liner about project
+- Public (portfolio) or Private (client work)
+- ☑️ Check "Initialize with README"
+- Click **"Create repository"**
+
+**✅ Checkpoint:** Repository created
+
+---
+
+## Part 5: Join Existing Repository
+
+**Email template:**
+
+```
+Hi [Name],
+
+I'd like to contribute to [project-name] using WDS methodology. 
+Could you add me as a collaborator?
+
+My GitHub username: [your-username]
+
+Thank you!
+```
+
+**Then:**
+1. Accept invitation from email
+2. Check repo name (ends in `-specs`? Separate repo)
+3. Browse structure (has `docs/`? WDS already!)
+
+**✅ Checkpoint:** Access granted
+
+---
+
+## Troubleshooting
+
+**Issue:** Verification email missing → Check spam  
+**Issue:** Username taken → Try `yourname-designer-2`  
+**Issue:** Repository name taken → Add your username
+
+---
+
+## What's Next?
+
+GitHub account and repository ready! Now install your IDE.
+
+**[Continue to Lesson 02: IDE Installation →](../lesson-02-ide-installation/02-full-lesson.md)**
+
+---
+
+*Part of Module 02: Installation & Setup*  
+*[← Back to Module Overview](../module-02-overview.md)*
+

package/docs/learn-wds/module-02-installation-setup/lesson-01-git-setup/01-quick-checklist.md

@@ -0,0 +1,63 @@
+# Lesson 01: Git Setup - Quick Checklist
+
+**⏱️ 15-20 minutes**
+
+---
+
+## Part 1: Create GitHub Account
+
+- [ ] Go to **<https://github.com>**
+- [ ] Click **"Sign up"**
+- [ ] Enter email, password, username (professional: `yourname-designer`)
+- [ ] Verify email
+- [ ] ✅ Log in successful
+
+---
+
+## Part 2: Choose Your Scenario
+
+- [ ] **A:** Starting new project → Continue below
+- [ ] **B:** Joining existing → Skip to "Join Existing"  
+- [ ] **C:** Just learning → Skip to [Lesson 02](../lesson-02-ide-installation/01-quick-checklist.md)
+
+---
+
+## Part 3: 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
+
+---
+
+## Part 4: Join Existing Repository
+
+- [ ] Ask owner for access (see full lesson for email template)
+- [ ] Accept invitation from email
+- [ ] Check repo structure
+- [ ] ✅ Access granted
+
+---
+
+## Next Step
+
+✅ GitHub ready!
+
+**[→ Lesson 02: IDE Installation](../lesson-02-ide-installation/01-quick-checklist.md)**
+
+---
+
+**Need more detail?** See [full lesson](02-full-lesson.md)
+

package/docs/learn-wds/module-02-installation-setup/lesson-01-git-setup/02-full-lesson.md

@@ -0,0 +1,124 @@
+# Lesson 01: Git Setup
+
+**Create GitHub account and project repository**
+
+---
+
+## What You'll Do
+
+- Create GitHub account
+- Choose professional username
+- Create or join repository
+- Understand repository structure
+
+**Time:** 15-20 minutes
+
+---
+
+## Part 1: Create GitHub Account
+
+### What is GitHub?
+
+Professional cloud storage + time machine for your project files. Every change is saved, you can go back to any version, work with others.
+
+### Step 1: Sign Up
+
+1. Go to **<https://github.com>**
+2. Click **"Sign up"**
+3. Enter email, password, username
+
+**Username Tips:**
+- Professional: `john-designer`, `sarahux`, `mike-creates`
+- You might share this with clients
+
+4. Verify email
+5. Log in
+
+**✅ Checkpoint:** You can log in to GitHub
+
+---
+
+## Part 2: Choose Your Scenario
+
+**Scenario A:** Starting new project → Continue to Part 3  
+**Scenario B:** Joining existing → Skip to Part 5  
+**Scenario C:** Just learning → Skip to [Lesson 02](../lesson-02-ide-installation/02-full-lesson.md)
+
+---
+
+## Part 3: Create Repository
+
+1. Click profile icon → **"Your repositories"** → **"New"**
+
+### Decide Repository Structure
+
+**IMPORTANT: Your naming choice determines your structure!**
+
+**Single Repository:**
+- Name: `my-project` (e.g., `dog-walker-app`)
+- Structure: Specs + code together
+- Use when: Small team, building yourself, simple communication
+
+**Separate Specifications Repository:**
+- Name: `my-project-specs` (e.g., `dog-walker-app-specs`)
+- Structure: Specs only, separate code repo
+- Use when: Corporate, many developers, clear handoff needed
+
+---
+
+## Part 4: Create Repository
+
+**Repository Settings:**
+- Name: `____________` (lowercase-with-hyphens)
+- Description: One-liner about project
+- Public (portfolio) or Private (client work)
+- ☑️ Check "Initialize with README"
+- Click **"Create repository"**
+
+**✅ Checkpoint:** Repository created
+
+---
+
+## Part 5: Join Existing Repository
+
+**Email template:**
+
+```
+Hi [Name],
+
+I'd like to contribute to [project-name] using WDS methodology. 
+Could you add me as a collaborator?
+
+My GitHub username: [your-username]
+
+Thank you!
+```
+
+**Then:**
+1. Accept invitation from email
+2. Check repo name (ends in `-specs`? Separate repo)
+3. Browse structure (has `docs/`? WDS already!)
+
+**✅ Checkpoint:** Access granted
+
+---
+
+## Troubleshooting
+
+**Issue:** Verification email missing → Check spam  
+**Issue:** Username taken → Try `yourname-designer-2`  
+**Issue:** Repository name taken → Add your username
+
+---
+
+## What's Next?
+
+GitHub account and repository ready! Now install your IDE.
+
+**[Continue to Lesson 02: IDE Installation →](../lesson-02-ide-installation/02-full-lesson.md)**
+
+---
+
+*Part of Module 02: Installation & Setup*  
+*[← Back to Module Overview](../module-02-overview.md)*
+

package/docs/learn-wds/module-02-installation-setup/lesson-01-github-and-ide-setup/checklist.md

@@ -0,0 +1,87 @@
+# Lesson 01: GitHub & IDE Setup - Quick Checklist
+
+**⏱️ 25-30 minutes**
+
+---
+
+## Part 1: GitHub Account
+
+- [ ] Go to **<https://github.com>**
+- [ ] Click **"Sign up"**
+- [ ] Enter email, password, username (professional: `yourname-designer`)
+- [ ] Verify email
+- [ ] ✅ Log in successful
+
+---
+
+## Part 2: Create or Join Repository
+
+### Choose Your Scenario
+
+- [ ] **A:** Starting new project → Continue below
+- [ ] **B:** Joining existing → Skip to "Join Existing"
+- [ ] **C:** Just learning → Skip to Part 3
+
+### Create New Repository
+
+- [ ] Click profile icon → **"Your repositories"** → **"New"**
+
+**Decide: Single or Separate?**
+
+- [ ] **Single repo:** `my-project` (specs + code together, for small teams)
+- [ ] **Separate repo:** `my-project-specs` (specs only, for corporate/many devs)
+
+- [ ] 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 for email template)
+- [ ] Accept invitation from email
+- [ ] Check repo structure (name, folders)
+- [ ] ✅ Access granted
+
+---
+
+## Part 3: IDE Installation
+
+### Choose & Download
+
+- [ ] **Cursor** (recommended) → <https://cursor.sh>
+- [ ] **VS Code** (alternative) → <https://code.visualstudio.com>
+- [ ] Download installer
+
+### Install
+
+- [ ] **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
+
+---
+
+## Next Step
+
+✅ GitHub & IDE ready!
+
+**[→ Lesson 02: Git Configuration](../lesson-02-git-setup/checklist.md)**
+
+---
+
+**Need more detail?** See [full lesson explanation](lesson.md)
+

package/docs/learn-wds/module-02-installation-setup/lesson-01-github-and-ide-setup/lesson.md

@@ -0,0 +1,203 @@
+# Lesson 01: GitHub & IDE Setup
+
+**Get your development environment ready**
+
+---
+
+## What You'll Do
+
+- Create GitHub account
+- Create or join repository
+- Install IDE (Cursor or VS Code)
+- Verify everything works
+
+**Time:** 25-30 minutes
+
+---
+
+## Part 1: GitHub Setup
+
+### What is GitHub?
+
+Professional cloud storage + time machine for your project files. Every change is saved, you can go back to any version, and you can work with others.
+
+### Step 1: Create GitHub Account
+
+1. Go to **<https://github.com>**
+2. Click **"Sign up"** (top right)
+3. Enter email, password, username
+
+**Username Tips:**
+- Professional: `john-designer`, `sarahux`, `mike-creates`
+- You might share this with clients
+
+4. Verify email
+5. Log in
+
+**✅ Checkpoint:** You can log in to GitHub
+
+---
+
+### Step 2: Choose Your Scenario
+
+**Scenario A: Starting a New Project** → Continue to Step 3  
+**Scenario B: Joining Existing Project** → Skip to Step 6  
+**Scenario C: Just Learning WDS** → Skip to Part 2
+
+---
+
+### Step 3: Create Repository (Scenario A)
+
+1. Click profile icon → **"Your repositories"** → **"New"**
+
+### Step 4: Decide Repository Structure
+
+**IMPORTANT: Your naming choice determines your structure!**
+
+#### Single Repository
+
+**Name:** `my-project` (e.g., `dog-walker-app`)
+
+```
+my-project/
+├── docs/    ← WDS specifications
+└── src/     ← Code
+```
+
+**Use when:**
+- Small team, building yourself
+- Simple communication
+- Rapid iteration
+
+#### Separate Specifications Repository
+
+**Name:** `my-project-specs` (e.g., `dog-walker-app-specs`)
+
+```
+my-project-specs/    ← Specifications only
+my-project/          ← Separate code repo
+```
+
+**Use when:**
+- Corporate environment
+- Many developers
+- Clear handoff needed
+
+### Step 5: Create Repository
+
+- **Name:** `____________` (lowercase-with-hyphens)
+- **Description:** One-liner about project
+- **Public** (portfolio) or **Private** (client work)
+- ☑️ **Check "Initialize with README"**
+- Click **"Create repository"**
+
+**✅ Checkpoint:** Repository created
+
+---
+
+### Step 6: Join Existing Repository (Scenario B)
+
+**Email template:**
+
+```
+Hi [Name],
+
+I'd like to contribute to [project-name] using WDS methodology. 
+Could you add me as a collaborator?
+
+My GitHub username: [your-username]
+
+Thank you!
+```
+
+**Then:**
+1. Accept invitation from email
+2. Check repo name (ends in `-specs`? Separate repo)
+3. Browse structure (has `docs/`? WDS already!)
+
+**✅ Checkpoint:** Access granted
+
+---
+
+## Part 2: IDE Installation
+
+### What is an IDE?
+
+Your workspace for creating specifications. Like Microsoft Word, but for design files.
+
+### Step 1: Choose Your IDE
+
+**Cursor (Recommended)**
+- Built for AI assistance
+- Perfect for WDS
+- Download: <https://cursor.sh>
+
+**VS Code (Alternative)**
+- Industry standard
+- Works great too
+- Download: <https://code.visualstudio.com>
+
+**For beginners:** Choose Cursor
+
+---
+
+### Step 2: Install
+
+**Windows:**
+1. Run `.exe` file
+2. Click through installer
+3. Use defaults
+
+**Mac:**
+1. Open download
+2. Drag to Applications
+3. Open from Applications
+
+**Linux:**
+Follow distro instructions
+
+---
+
+### Step 3: First Launch
+
+1. Choose theme (Light/Dark)
+2. **Sign in with GitHub** → Yes!
+3. Install recommended extensions → Yes
+
+**✅ Checkpoint:** IDE open and ready
+
+---
+
+### Step 4: Verify Terminal
+
+Press **Ctrl+`** (Win/Linux) or **Cmd+`** (Mac)
+
+**✅ Checkpoint:** Terminal panel appears
+
+---
+
+## Troubleshooting
+
+**GitHub Issues:**
+- **Verification email missing** → Check spam
+- **Username taken** → Try `yourname-designer-2`
+- **Repository name taken** → Add your username
+
+**IDE Issues:**
+- **Can't find download** → Check Downloads folder
+- **Mac "unidentified developer"** → Right-click → Open
+- **Terminal won't open** → View menu → Terminal → New Terminal
+
+---
+
+## What's Next?
+
+GitHub account, repository, and IDE are ready! Now let's configure Git.
+
+**[Continue to Lesson 02: Git Configuration →](../lesson-02-git-setup/lesson.md)**
+
+---
+
+*Part of Module 02: Installation & Setup*  
+*[← Back to Module Overview](../module-02-overview.md)*
+