whiteport-design-studio 0.2.2 → 0.3.0

package/docs/learn-wds/course-explainers/Module-05-youtube-show-notes.md

@@ -1,65 +0,0 @@
-Module 05 - Trigger Mapping - Connect Business Goals to User Psychology
-<https://youtu.be/xs_cRk-NoJk>
-
-Ever built something beautiful that nobody wanted? Trigger Mapping bridges business strategy to user psychology through 5 structured workshops, creating a visual one-page map that guides every design decision. Based on 20+ years of proven methodology.
-
-*Free & open-source* | 6 minutes | Core methodology module
-
-⏱️ Timestamps
-
-00:00 The Problem - Why Brilliant Ideas Fail
-00:41 The Solution - What is a Trigger Map?
-01:30 The Three Layers - Business Goals, Target Groups, Usage Goals
-02:48 The Psychology - Positive vs Negative Drivers (Loss Aversion)
-04:01 Building the Map - The Process & Visual
-05:09 The Benefits - Stop Guessing, Start Mapping
-
-🎯 What You'll Create
-
-Visual one-page Trigger Map connecting:
-• Business Goals → Target Groups → Usage Goals (positive + negative drivers)
-• Data-driven feature prioritization
-• Clear strategic rationale for every design decision
-
-📚 Course Resources
-
-🌊 *WDS Presentation:*
-<https://whiteport.com/whiteport-design-studio/>
-
-📖 *Module 05 Overview:*
-<https://github.com/whiteport-collective/whiteport-design-studio/blob/main/docs/learn-wds/module-05-trigger-mapping/module-05-overview.md>
-
-📖 *Tutorial 05:*
-<https://github.com/whiteport-collective/whiteport-design-studio/blob/main/docs/learn-wds/module-05-trigger-mapping/tutorial-05.md>
-
-📖 *Trigger Mapping Guide:*
-<https://github.com/whiteport-collective/whiteport-design-studio/blob/main/docs/method/phase-2-trigger-mapping-guide.md>
-
-💬 *UX-Design channel in the BMad Discord Community:*
-<https://discord.gg/Pn63gAuX>
-
-📖 *GitHub Discussions:*
-<https://github.com/whiteport-collective/whiteport-design-studio/discussions>
-
-◀️ *Previous Module:* Module 04 - Product Brief
-<https://youtu.be/yhKxkuLq1kQ>
-
-▶️ *Next Module:* Module 06 - Scenarios (Coming Soon)
-
-📚 *Full Course:*
-<https://github.com/whiteport-collective/whiteport-design-studio/blob/main/docs/learn-wds/00-course-overview.md>
-
-⚡ Key Insight
-
-Negative drivers (fears/pains) are often more powerful than positive ones. Loss aversion: people work twice as hard to avoid pain as to pursue equivalent gain.
-
-📖 Heritage
-
-Based on Effect Management (Mijo Balic & Ingrid Domingues, inUse Sweden) and Impact Mapping (Gojko Adzic)
-<https://www.impactmapping.org>
-
-🎨 About WDS
-
-AI-augmented design methodology by Mårten Angner (Whiteport, Sweden). 90 minutes of strategic work saves months of building the wrong things. 🎯
-
-#TriggerMapping #UserPsychology #FeaturePrioritization #WDS #StrategicDesign

package/docs/learn-wds/course-explainers/module-01-YOUTUBE-SHOW-NOTES.md

@@ -1,75 +0,0 @@
-Module 01 - Why WDS Matters - Are You a Factory Worker or a Linchpin Designer?
-<https://www.youtube.com/watch?v=Xhw5JB7mpxw>
-
-The AI era is here. The question is: are you a factory worker or a linchpin designer? Replaceable or indispensable?
-
-This 30-minute deep dive explores why designers are irreplaceable in the AI era - not because of tools, but because of emotional labor, user-centric creativity, and the ability to walk into chaos and create order.
-
-*You'll learn:*
-✅ Seth Godin's Linchpin concept and why it matters RIGHT NOW
-✅ Three irreplaceable gifts only human designers provide
-✅ 5-dimensional thinking - the skill that makes you indispensable
-✅ The three-part transformation WDS guides you through
-✅ How to act: I Can. I Do. I Will.
-
-*Free & open-source* | 30 minutes (3 lessons × 10 min)
-
-⏱️ Timestamps
-
-00:00 The Fundamental Choice
-00:59 Two Paths: Factory vs Linchpin
-02:25 Three Irreplaceable Gifts
-04:14 The WDS Framework
-05:42 The Mindset & First Steps
-
-🎯 Key Concepts
-
-*Linchpin Designer* - Walks into chaos and creates order (Seth Godin)
-*Emotional Labor* - Genuinely caring about the outcome
-*User-Centric Creativity* - Connecting business goals to user psychology
-*5-Dimensional Thinking* - Business existence, goals, product strategy, target groups, technical viability
-
-📚 Course Resources
-
-🌊 *WDS Presentation:*
-<https://whiteport.com/whiteport-design-studio/>
-
-🛠️ *Installation Guide:*
-<https://github.com/whiteport-collective/whiteport-design-studio/blob/main/docs/getting-started/installation.md>
-
-📚 *Linchpin Book by Seth Godin:*
-<https://www.amazon.com/Linchpin-Are-You-Indispensable-ebook/dp/B00354Y9ZU>
-
-💬 *UX-Design channel in the BMad Discord Community:*
-<https://discord.gg/Pn63gAuX>
-
-📖 *GitHub Discussions:*
-<https://github.com/whiteport-collective/whiteport-design-studio/discussions>
-
-◀️ *Previous Module:* Module 00 - Getting Started
-<https://youtu.be/qYPYx01YLUc>
-
-▶️ *Next Module:* Module 02 - Installation & Setup
-<https://www.youtube.com/watch?v=tYifpxFVVks>
-
-📚 *Full Course:*
-<https://github.com/whiteport-collective/whiteport-design-studio/blob/main/docs/learn-wds/00-course-overview.md>
-
-✅ *Next Steps:*
-1. Complete the three written lessons (30 min)
-2. Download an IDE (Cursor, VS Code, Windsurf)
-3. Start Module 02: Installation & Setup
-4. Join Discord community
-5. Let yourself be known
-
-💪 *The Mindset:* I Can. I Do. I Will. No matter what. No matter when. No matter how.
-
-🎨 *About WDS*
-AI-augmented design methodology by Mårten Angner (Whiteport, Sweden). Free access to AI agents for designers. The transformation: From task-doer to strategic leader. From replaceable to indispensable.
-
-#UXDesign #AIDesign #LinchpinDesigner #WDS #BMadMethod #SethGodin #Linchpin
-
-🔥 This is not the time to hide. The AI era is here. Stand up. Act. Download. Install. Build. Move.
-
-*Ready to become indispensable? Watch the full module and move to Module 02! 🚀*
-<https://www.youtube.com/watch?v=tYifpxFVVks>

package/docs/learn-wds/course-explainers/module-02-YOUTUBE-SHOW-NOTES.md

@@ -1,86 +0,0 @@
-Module 02 - WDS Installation & Setup - From Zero to Hero in one Hour!
-<https://www.youtube.com/watch?v=tYifpxFVVks>
-
-"I've never used GitHub. I've never installed an IDE. I'm worried I'll mess something up."
-
-Sound familiar? This 6-minute guided walkthrough takes you from complete beginner to fully set up with WDS - even if you've never touched GitHub, Git, or an IDE before.
-
-*You'll learn:*
-✅ Create a GitHub account and repository
-✅ Install your IDE workspace (Cursor or VS Code)
-✅ Clone your project to your computer
-✅ Add WDS to your workspace
-✅ Meet Mimir - your personal WDS guide
-
-*Free & open-source* | 45-60 minutes setup | No technical experience required
-
-⏱️ Timestamps
-
-00:00 The Technical Setup Challenge
-00:59 Creating Your GitHub Account
-03:13 Installing Your IDE Workspace
-04:43 Cloning Your Project
-05:42 WDS Integration & Meeting Mimir
-
-🎯 Key Concepts
-
-*GitHub* - Professional cloud storage with version control
-*Repository* - A tracked folder where your project lives
-*IDE* - Your workspace for creating specifications
-*Cloning* - Making a local copy of your GitHub repository
-*Mimir* - Your WDS orchestrator (@wds-mimir anytime!)
-
-📚 4 Lessons
-
-1. *Git Setup* (15-20 min) - GitHub account, repository creation
-2. *IDE Installation* (10 min) - Download Cursor or VS Code
-3. *Repository Cloning* (10 min) - Clone project to your computer
-4. *WDS Initialization* (15-20 min) - Add WDS, create 8-phase docs, activate Mimir
-
-📁 *8-Phase Docs Structure:*
-1-project-brief • 2-trigger-mapping • 3-prd-platform • 4-ux-design • 5-design-system • 6-design-deliveries • 7-testing • 8-ongoing-development  
-
-📚 Course Resources
-
-🌊 *WDS Presentation:* [WDS Presentation](https://whiteport.com/whiteport-design-studio/)
-
-💻 *Download Cursor:* <https://cursor.sh>
-
-📥 *Download VS Code:* <https://code.visualstudio.com>
-
-📥 *GitHub:* <https://github.com>
-
-💬 *UX-Design channel in the BMad Discord Community:*
-<https://discord.gg/Pn63gAuX>
-
-📖 *GitHub Discussions:*
-<https://github.com/whiteport-collective/whiteport-design-studio/discussions>
-
-◀️ *Previous Module:* Module 01 - Why WDS Matters
-<https://www.youtube.com/watch?v=Xhw5JB7mpxw>
-
-▶️ *Next Module:* Module 03 - Alignment & Signoff
-<https://www.youtube.com/watch?v=TKjOLlU8UCE>
-
-📚 *Full Course:*
-<https://github.com/whiteport-collective/whiteport-design-studio/blob/main/docs/learn-wds/00-course-overview.md>
-
-✅ *Next Steps:*
-1. Complete the 4-lesson setup (follow along!)
-2. Activate Mimir and have your first conversation
-3. Start Module 03: Alignment & Signoff
-4. Join the WDS community
-
-💪 *"You can do this. I believe in you."* - Mimir
-
-🎨 *About WDS*
-AI-augmented design methodology by Mårten Angner (Whiteport, Sweden). Transforms designers into indispensable linchpins who connect business goals, user psychology, and technical constraints.
-
-👤 *About Mimir*
-Your WDS orchestrator - a wise advisor who assesses your skill level, guides setup, and provides support. Invoke anytime: @wds-mimir [your question]
-
-#GitHub #IDESetup #Cursor #VSCode #WDS #Mimir #DesignCourse #BeginnerFriendly
-
-*Ready to start? Follow along and you'll be WDS-ready in under an hour! 🚀*
-<https://www.youtube.com/watch?v=TKjOLlU8UCE>
-

package/docs/learn-wds/course-explainers/module-03-YOUTUBE-SHOW-NOTES.md

@@ -1,82 +0,0 @@
-Module 03 - Alignment & Signoff - Get Stakeholder Buy-In for Your Design Projects
-<https://www.youtube.com/watch?v=TKjOLlU8UCE>
-
-Struggling with the business side of design? Feel uncomfortable talking about money or negotiating contracts? This module teaches you how to get stakeholder buy-in and protect your projects with clear agreements.
-
-*You'll learn:*
-✅ The discovery discipline: Understanding before solving
-✅ When you need stakeholder alignment (and when to skip it)
-✅ Create compelling alignment documents with quantified ROI
-✅ The 6 elements of alignment (Idea, Why, What, How, Budget, Commitment)
-✅ Formalize commitment with professional contracts
-✅ Protect scope and handle change orders professionally
-
-*Free & open-source* | 55-75 minutes | Optional module
-
-⏱️ Timestamps
-
-00:00 The Business Side Challenge
-00:39 The Discovery Discipline
-02:30 The 6-Element Toolkit
-03:39 From Alignment to Contract
-04:44 Becoming a Strategic Partner
-
-🎯 Key Concepts
-
-*Discovery Discipline* - Understand before you solve (measure twice, diagnose first)
-*6 Elements of Alignment* - Idea, Why, What, How, Budget, Commitment
-*Alignment Document* - Makes the case for why the project matters
-*Signoff Documents* - External contracts or internal approval
-*Scope Protection* - Clear boundaries, change order process
-
-📚 Course Resources
-
-🌊 *WDS Presentation:*
-<https://whiteport.com/whiteport-design-studio/>
-
-Project Pitch Guide:
-<https://github.com/whiteport-collective/whiteport-design-studio/blob/main/docs/deliverables/project-pitch.md>
-
-Service Agreement Templates:
-<https://github.com/whiteport-collective/whiteport-design-studio/blob/main/docs/deliverables/service-agreement.md>
-
-UX-Design channel in the BMad Discord Community:
-<https://discord.gg/Pn63gAuX>
-
-GitHub Discussions:
-<https://github.com/whiteport-collective/whiteport-design-studio/discussions>
-
-Previous Module: Module 02 - Installation & Setup
-<https://www.youtube.com/watch?v=tYifpxFVVks>
-
-Next Module: Module 04 - Product Brief
-<https://youtu.be/yhKxkuLq1kQ>
-
-Full Course:
-<https://github.com/whiteport-collective/whiteport-design-studio/blob/main/docs/learn-wds/00-course-overview.md>
-
-✅ *When to Use This Module:*
-✅ Consultant pitching to client
-✅ Employee seeking stakeholder approval
-✅ You struggle with business conversations
-✅ You've been stuck in scope creep
-
-❌ *Skip if:* Building yourself with full autonomy
-
-� *Discovery Discipline Flow:*
-1. Discovery meeting → 2. Reflect → 3. Create pitch → 4. Present → 5. Iterate → 6. Get acceptance → 7. Generate contract → 8. Sign → 9. Proceed to Project Brief
-
-✅ *Next Steps:*
-1. Complete the 5 lessons
-2. Follow Tutorial 03 to create alignment document
-3. Practice with real or hypothetical project
-4. Start Module 04 (or skip if you don't need alignment)
-
-🎨 *About WDS*
-AI-augmented design methodology by Mårten Angner (Whiteport, Sweden). Transforms designers into strategic leaders who confidently navigate business conversations and protect projects.
-
-#DesignBusiness #ClientContracts #ScopeCreep #WDS #DesignROI #ProjectPitch
-
-💼 *Remember:* Alignment isn't about being pushy. Contracts aren't about being defensive. They're about serving clients with clarity.
-
-*Ready to master the business side of design? Watch the full module! 💼*

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

@@ -1,63 +0,0 @@
-# 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

@@ -1,124 +0,0 @@
-# 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

@@ -1,87 +0,0 @@
-# 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)
-