whiteport-design-studio 0.2.2 → 0.3.0

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

@@ -1,51 +0,0 @@
-# Lesson 03: Git Repository Cloning - Quick Checklist
-
-**⏱️ 10 minutes**
-
----
-
-## 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
-
----
-
-## Next Step
-
-✅ Repository cloned!
-
-**[→ Lesson 04: WDS Project Initialization](../lesson-04-wds-initialization/01-quick-checklist.md)**
-
----
-
-**Need more detail?** See [full lesson](02-full-lesson.md)
-

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

@@ -1,111 +0,0 @@
-# Lesson 03: Git Repository Cloning
-
-**Clone your project to your computer**
-
----
-
-## What You'll Do
-
-- Create Projects folder
-- Clone your repository
-- Open project in IDE
-- Understand Git auto-installation
-
-**Time:** 10 minutes
-
----
-
-## Step 1: Create Projects Folder
-
-**Choose a location:**
-- Windows: `C:\Users\YourName\Projects\`
-- Mac/Linux: `~/Projects/`
-
-In terminal (**Ctrl+`** or **Cmd+`**):
-
-```bash
-# Windows
-mkdir C:\Projects
-cd C:\Projects
-
-# Mac/Linux
-mkdir ~/Projects
-cd ~/Projects
-```
-
-**✅ Checkpoint:** Projects folder created
-
----
-
-## Step 2: Get Repository URL
-
-1. Go to your repository on GitHub
-2. Click green **"Code"** button
-3. Make sure **"HTTPS"** selected
-4. Click copy icon (📋)
-
-**Your URL:** `https://github.com/your-username/your-project.git`
-
----
-
-## Step 3: Clone Repository
-
-In terminal:
-
-```bash
-git clone [paste your URL]
-```
-
-**Example:**
-```bash
-git clone https://github.com/john-designer/dog-walker-app.git
-```
-
-**If Cursor prompts "Install Git?"** → Click **"Install"**, wait, try again
-
-**✅ Checkpoint:** See "Cloning into..." then "done"
-
----
-
-## Step 4: Open Project in IDE
-
-1. **File** → **Open Folder**
-2. Navigate to Projects folder
-3. Select your project folder
-4. Click **"Select Folder"** or **"Open"**
-
-**✅ Checkpoint:** Project name in sidebar with README.md
-
----
-
-## About Git Auto-Installation
-
-**Git** is the tool that syncs with GitHub. Modern IDEs handle this automatically:
-
-- First time cloning → IDE prompts to install
-- You click "Install"
-- Done!
-
-**Alternative:** Use GitHub Desktop (<https://desktop.github.com>) for visual interface
-
----
-
-## Troubleshooting
-
-**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.
-
-**[Continue to Lesson 04: WDS Project Initialization →](../lesson-04-wds-initialization/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-03-git-cloning/03-quick-checklist.md

@@ -1,51 +0,0 @@
-# Lesson 03: Git Repository Cloning - Quick Checklist
-
-**⏱️ 10 minutes**
-
----
-
-## 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
-
----
-
-## Next Step
-
-✅ Repository cloned!
-
-**[→ Lesson 04: WDS Project Initialization](../lesson-04-wds-initialization/01-quick-checklist.md)**
-
----
-
-**Need more detail?** See [full lesson](02-full-lesson.md)
-

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

@@ -1,41 +0,0 @@
-# Lesson 03: Git Configuration - Quick Checklist
-
-**⏱️ 5 minutes**
-
----
-
-## Choose Approach
-
-- [ ] **Option 1:** Let Cursor handle Git (easiest - do nothing now!)
-- [ ] **Option 2:** Use GitHub Desktop (visual) → <https://desktop.github.com>
-- [ ] **Option 3:** Check terminal: `git --version`
-
----
-
-## If Using GitHub Desktop
-
-- [ ] Download from <https://desktop.github.com>
-- [ ] Install
-- [ ] Sign in with GitHub account
-- [ ] ✅ Ready to clone visually
-
----
-
-## Recap Your Repo Structure
-
-You decided in Lesson 01:
-- [ ] Single repo: `my-project` (specs + code together)
-- [ ] Separate repo: `my-project-specs` (specs only)
-
----
-
-## Next Step
-
-✅ Git configured!
-
-**[→ Lesson 04: Repository Cloning & WDS Integration](../lesson-04-clone-and-wds/checklist.md)**
-
----
-
-**Need more detail?** See [full lesson explanation](lesson.md)
-

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

@@ -1,159 +0,0 @@
-# Lesson 03: Git Configuration
-
-**Let your IDE handle Git automatically**
-
----
-
-## What You'll Do
-
-- Understand what Git does
-- Recap your repository structure decision
-- Let Cursor install Git automatically
-- OR use GitHub Desktop (visual alternative)
-
-**Time:** 5 minutes
-
----
-
-## What is Git?
-
-**Git** is the behind-the-scenes tool that syncs your computer with GitHub.
-
-**Good news:** You don't need to install it manually! Modern IDEs like Cursor handle this for you.
-
----
-
-## Step 1: Recap Your Repository Structure
-
-**You already decided this in Lesson 01 when naming your repo!**
-
-### Single Repo (named `my-project`)
-```
-my-project/
-├── docs/              ← Your WDS specifications
-└── src/               ← Code lives here too
-```
-
-### Separate Repo (named `my-project-specs`)
-```
-my-project-specs/      ← This repo (specifications only)
-                       ← Code repo created separately
-```
-
-**For this tutorial, we assume single repo** (`dog-walker-app`)
-
----
-
-## Step 2: Choose Your Git Approach
-
-### Option 1: Let Cursor Handle It (Recommended)
-
-**The easiest way:** Do nothing!
-
-When you try to clone a repository in Lesson 04, Cursor will:
-
-1. Check if Git is installed
-2. If not, **automatically prompt you**: "Install Git?"
-3. You click **"Install"**
-4. Done!
-
-**That's it.** No command line needed.
-
-**✅ This is the recommended path for beginners**
-
----
-
-### Option 2: GitHub Desktop (Visual Alternative)
-
-**For designers who prefer visual tools:**
-
-#### Why GitHub Desktop?
-
-- ✅ No terminal commands needed
-- ✅ Visual interface for everything
-- ✅ See changes side-by-side
-- ✅ Many professional designers use it
-- ✅ Works perfectly with Cursor
-
-#### Install GitHub Desktop
-
-1. Download from **<https://desktop.github.com>**
-2. Install it (follow standard installer)
-3. Open GitHub Desktop
-4. Sign in with your GitHub account
-5. Done!
-
-#### How it Works
-
-- Use GitHub Desktop to **clone** repositories
-- Use GitHub Desktop to **commit** and **push** changes
-- Use Cursor to **edit** specifications
-- They work together perfectly!
-
-**This is a perfectly valid professional workflow.**
-
-**Bonus:** GitHub Desktop also helps you decide between single vs separate repos visually!
-
----
-
-### Option 3: Already Comfortable with Terminal?
-
-**Optional check for those who want to know:**
-
-In Cursor terminal (press **Ctrl+`** or **Cmd+`**):
-
-```bash
-git --version
-```
-
-**If you see a version number:**
-```
-git version 2.x.x
-```
-✅ Git is installed!
-
-**If you see "command not found":**
-No problem! Continue to Lesson 04, Cursor will prompt you.
-
----
-
-## Which Option Should You Choose?
-
-**Choose Option 1 (Let Cursor Handle It) if:**
-- You're a complete beginner
-- You want the simplest path
-- You're comfortable with terminal appearing in Lesson 04
-
-**Choose Option 2 (GitHub Desktop) if:**
-- You prefer visual interfaces
-- You want to see changes graphically
-- You're nervous about terminal commands
-- You want a tool you'll keep using
-
-**Both are great!** Many professionals use GitHub Desktop daily.
-
----
-
-## Troubleshooting
-
-**Issue:** Not sure which option to choose  
-**Solution:** Use Option 1 (Let Cursor handle it) - simplest for beginners
-
-**Issue:** GitHub Desktop won't sign in  
-**Solution:** Make sure you completed Lesson 01 (GitHub account created)
-
-**Issue:** Worried about making mistakes  
-**Solution:** Git saves everything - you can always undo!
-
----
-
-## What's Next?
-
-Git will be ready when you need it! Now it's time to clone your repository and add WDS to your workspace.
-
-**[Continue to Lesson 04: Repository Cloning & WDS Integration →](../lesson-04-clone-and-wds/tutorial.md)**
-
----
-
-*Part of Module 02: Installation & Setup*  
-*[← Back to Module Overview](../module-02-overview.md)*

package/docs/learn-wds/module-02-installation-setup/lesson-04-clone-and-wds/checklist.md

@@ -1,93 +0,0 @@
-# Lesson 04: Repository Cloning & WDS Integration - Quick Checklist
-
-**⏱️ 15-20 minutes**
-
----
-
-## Create Projects Folder
-
-In Cursor terminal (**Ctrl+`** or **Cmd+`**):
-
-```bash
-# Windows
-mkdir C:\Projects
-cd C:\Projects
-
-# Mac/Linux
-mkdir ~/Projects
-cd ~/Projects
-```
-
-- [ ] ✅ Projects folder created
-
----
-
-## Clone Your Project
-
-- [ ] Go to your repo on GitHub → Click **"Code"** → Copy URL
-- [ ] In terminal: `git clone [paste-url-here]`
-- [ ] (If prompted: Install Git → Click "Install")
-- [ ] ✅ "done" message
-
----
-
-## Open Project in Cursor
-
-- [ ] **File** → **Open Folder**
-- [ ] Select your project folder
-- [ ] ✅ Project in sidebar
-
----
-
-## Clone WDS
-
-In terminal:
-```bash
-cd ~/Projects  # or cd C:\Projects
-git clone https://github.com/whiteport-collective/whiteport-design-studio.git
-```
-
-- [ ] ✅ WDS cloned
-
----
-
-## Add WDS to Workspace
-
-- [ ] **File** → **Add Folder to Workspace**
-- [ ] Select `whiteport-design-studio` folder
-- [ ] Click **"Add"**
-- [ ] ✅ Both folders in sidebar
-
----
-
-## Create Docs Structure
-
-In terminal (in YOUR project folder):
-
-```bash
-cd ~/Projects/your-project-name  # YOUR project!
-
-# Mac/Linux
-mkdir -p docs/{1-project-brief,2-trigger-mapping,3-prd-platform,4-ux-design,5-design-system,6-design-deliveries,7-testing,8-ongoing-development}
-
-# Windows (if above doesn't work)
-mkdir docs
-cd docs
-mkdir 1-project-brief 2-trigger-mapping 3-prd-platform 4-ux-design 5-design-system 6-design-deliveries 7-testing 8-ongoing-development
-cd ..
-```
-
-- [ ] ✅ 8 folders in `docs/`
-
----
-
-## Next Step
-
-✅ Everything cloned and ready!
-
-**[→ Lesson 05: Mimir Activation](../lesson-05-initiate-mimir/checklist.md)**
-
----
-
-**Need more detail?** See [full lesson explanation](lesson.md)
-

package/docs/learn-wds/module-02-installation-setup/lesson-04-clone-and-wds/tutorial.md

@@ -1,217 +0,0 @@
-# Lesson 04: Repository Cloning & WDS Integration
-
-**Get your project and WDS onto your computer**
-
----
-
-## What You'll Do
-
-- Clone your project repository
-- Add WDS to your workspace
-- Create docs folder structure
-
-**Time:** 15-20 minutes
-
----
-
-## Step 1: Choose Where to Store Projects
-
-**Create a Projects folder:**
-
-**Windows:** `C:\Users\YourName\Projects\`  
-**Mac/Linux:** `/Users/YourName/Projects/` or `~/Projects/`
-
-### Create the Folder
-
-In Cursor terminal (**Ctrl+`** or **Cmd+`**):
-
-```bash
-# Windows
-mkdir C:\Projects
-cd C:\Projects
-
-# Mac/Linux
-mkdir ~/Projects
-cd ~/Projects
-```
-
-**✅ Checkpoint:** Projects folder created
-
----
-
-## Step 2: Clone Your Project Repository
-
-**What is cloning?** Copying your GitHub repository to your computer so you can work on it.
-
-### 2.1 Get Your Repository URL
-
-1. Go to your repository on GitHub
-2. Click the green **"Code"** button
-3. Make sure **"HTTPS"** is selected
-4. Click the **copy icon** (📋)
-
-**Your URL looks like:** `https://github.com/your-username/your-project.git`
-
-### 2.2 Clone the Repository
-
-In Cursor terminal:
-
-```bash
-git clone [paste your URL here]
-```
-
-**Example:**
-```bash
-git clone https://github.com/john-designer/dog-walker-app.git
-```
-
-**If Cursor prompts "Install Git?"** → Click **"Install"** and wait, then try again.
-
-**✅ Checkpoint:** You see "Cloning into..." and then "done"
-
----
-
-## Step 3: Open Your Project in Cursor
-
-1. In Cursor: **File** → **Open Folder**
-2. Navigate to your Projects folder
-3. Select your project folder (e.g., `dog-walker-app`)
-4. Click **"Select Folder"** or **"Open"**
-
-**✅ Checkpoint:** You see your project name in the left sidebar with README.md
-
----
-
-## Step 4: Clone WDS Repository
-
-**What is WDS?** The methodology files that contain agents, workflows, and training.
-
-**WDS lives separately from your project.**
-
-In Cursor terminal (make sure you're in Projects folder):
-
-```bash
-# Navigate back to Projects folder
-cd ~/Projects  # Mac/Linux
-cd C:\Projects # Windows
-
-# Clone WDS
-git clone https://github.com/whiteport-collective/whiteport-design-studio.git
-```
-
-**✅ Checkpoint:** WDS cloned successfully
-
----
-
-## Step 5: Add WDS to Your Workspace
-
-1. In Cursor: **File** → **Add Folder to Workspace**
-2. Navigate to your Projects folder
-3. Select the `whiteport-design-studio` folder
-4. Click **"Add"**
-
-**✅ Checkpoint:** You see both folders in your Cursor sidebar:
-- your-project
-- whiteport-design-studio
-
----
-
-## Step 6: Create Docs Folder Structure
-
-**What is the docs folder?** Where all your WDS specifications will live. This is your design source of truth.
-
-**Navigate to YOUR project (not WDS):**
-
-```bash
-# Change to your project
-cd ~/Projects/dog-walker-app  # Mac/Linux (use YOUR project name!)
-cd C:\Projects\dog-walker-app # Windows (use YOUR project name!)
-```
-
-**Create the 8-phase structure:**
-
-```bash
-# Mac/Linux (works in most terminals)
-mkdir -p docs/1-project-brief
-mkdir -p docs/2-trigger-mapping
-mkdir -p docs/3-prd-platform
-mkdir -p docs/4-ux-design
-mkdir -p docs/5-design-system
-mkdir -p docs/6-design-deliveries
-mkdir -p docs/7-testing
-mkdir -p docs/8-ongoing-development
-```
-
-**Windows alternative (if above doesn't work):**
-```bash
-mkdir docs
-cd docs
-mkdir 1-project-brief
-mkdir 2-trigger-mapping
-mkdir 3-prd-platform
-mkdir 4-ux-design
-mkdir 5-design-system
-mkdir 6-design-deliveries
-mkdir 7-testing
-mkdir 8-ongoing-development
-cd ..
-```
-
-**✅ Checkpoint:** You see a `docs/` folder with 8 numbered subfolders in your project
-
----
-
-## Quick Reference: What Lives Where
-
-```
-Your Computer/
-└── Projects/
-    ├── your-project/                          ← YOUR PROJECT
-    │   ├── docs/                              ← Your specifications
-    │   │   ├── 1-project-brief/
-    │   │   ├── 2-trigger-mapping/
-    │   │   ├── 3-prd-platform/
-    │   │   ├── 4-ux-design/
-    │   │   ├── 5-design-system/
-    │   │   ├── 6-design-deliveries/
-    │   │   ├── 7-testing/
-    │   │   └── 8-ongoing-development/
-    │   ├── src/                               ← Code (if single repo)
-    │   └── README.md
-    │
-    └── whiteport-design-studio/               ← WDS METHODOLOGY
-        └── src/modules/wds/
-            ├── agents/
-            ├── workflows/
-            ├── course/
-            └── MIMIR-WDS-ORCHESTRATOR.md
-```
-
----
-
-## Troubleshooting
-
-**Issue:** "Git command not found"  
-**Solution:** Let Cursor install Git when prompted, then try again
-
-**Issue:** "Permission denied" when cloning  
-**Solution:** Make sure you're signed into GitHub in Cursor
-
-**Issue:** "Can't find MIMIR file"  
-**Solution:** Make sure you added `whiteport-design-studio` folder to workspace (Step 5)
-
-**Issue:** "mkdir: cannot create directory"  
-**Solution:** Make sure you're in your project folder: `cd ~/Projects/your-project`
-
----
-
-## What's Next?
-
-Everything is set up! Now let's activate Mimir and begin your WDS journey.
-
-**[Continue to Lesson 05: Mimir Activation →](../lesson-05-initiate-mimir/tutorial.md)**
-
----
-
-*Part of Module 02: Installation & Setup*  
-*[← Back to Module Overview](../module-02-overview.md)*