whiteport-design-studio 0.2.2 → 0.3.0

package/docs/{learn-wds → learn}/module-01-why-wds-matters/lesson-01-the-problem.md

@@ -106,8 +106,10 @@ The bottleneck in product development used to be coding. AI demolished that. Now
 
 Now that you understand the problem, let's explore the solution.
 
-**[Continue to Lesson 2: The Solution →](lesson-02-the-solution.md)**
+**[Continue to Lesson 2: Designer as Strategic Thinker →](lesson-02-designer-as-strategic-thinker.md)**
 
 ---
 
-[← Back to Module Overview](module-01-overview.md) | [Next: Lesson 2 →](lesson-02-the-solution.md)
+[← Back to Module Overview](module-01-overview.md) | [Next: Lesson 2 →](lesson-02-designer-as-strategic-thinker.md)
+
+*Part of Module 01: Why WDS Matters*

package/docs/learn/module-01-why-wds-matters/lesson-02-designer-as-strategic-thinker.md

@@ -0,0 +1,483 @@
+# Module 01: Why WDS Matters
+
+## Lesson 2: Designer as Strategic Thinker
+
+**Your role just changed. Here's why.**
+
+---
+
+## The Shift Everyone Missed
+
+Everyone knows AI made code cheap.
+
+**What most people missed:** AI made strategic thinking cheap too.
+
+**And that changes everything for designers.**
+
+---
+
+## Your Old Role: Pixel Pusher
+
+For most of your career, the designer's role was clear:
+
+**Make it pretty. Make it usable. Hand it off.**
+
+**The Agile era designer:**
+- Attended meetings constantly
+- Sketched quick mockups
+- Iterated through prototypes
+- Let PMs handle strategy
+- Communication was cheap, so meetings were endless
+- Decisions emerged through discussion
+
+**Why this worked:**
+- Communication: Cheap (constant meetings)
+- Coding: Expensive (developer time valuable)
+- Strategy: PM's job (designers executed)
+
+**Your value:** Visual craft + usability expertise
+
+---
+
+## The AI Era Changed the Game
+
+Now everything has changed.
+
+**AI didn't just make coding cheaper—it made strategic thinking cheaper.**
+
+**For you as a designer, this means:**
+- Code generation: Nearly free (AI agents)
+- Communication: Expensive (people expect polished thinking)
+- Strategy: Now accessible (AI thinking partners)
+
+**The new reality:**
+
+You're expected to arrive with your thoughts in **lovable style** - polished, strategic, shows a lot of wild new things, but far from ready to implement. Also, and here is the problem, with no connection to the thinking behind it and why you made it! 
+
+"Click instead of discuss."
+
+But where do you get the time to forge polished strategic thinking?
+
+---
+
+## The Amateur Response: Vibe Coding
+
+> "AI can code now. I'll skip strategy and just generate prototypes!"
+
+**The flow:**
+1. Prompt AI: "Build me a login screen"
+2. Get generic output
+3. Tweak colors and spacing
+4. Generate 5 variations
+5. Present to team: "Which do you like?"
+6. Team picks one
+7. Realize it doesn't solve the actual problem
+8. Repeat
+
+**The result:**
+- Flooding colleagues with **lovecoded colorful distractions**
+- Prototypes without substance
+- Pretty mockups disconnected from strategy
+- "Look what I made!" instead of "Here's what we need"
+- Burning credits on endless regeneration
+
+**You're still a pixel pusher. Just faster and with more noise. The signal was lost. Result: Who cares and so what!**
+
+---
+
+## Your New Role: Strategic Thinker
+
+**The insight everyone missed:**
+
+It's not only **coding** that got cheaper.
+
+**Strategic thinking** got cheaper too.
+
+**This is the WDS insight.**
+
+Everyone sees AI making code cheap. The amateurs stop there.
+
+**WDS sees that AI also made strategic thinking cheap.**
+
+**For designers, this changes everything:**
+
+**Amateur designers use AI for:**
+- Visual generation (prompt for pretty outputs)
+- Fast prototyping (churn variations)
+- Execution only (skip the thinking)
+
+**WDS designers use AI for:**
+- **Strategic thinking FIRST** (forge with Saga, Freya as thinking partners)
+- Think through problems collaboratively
+- Improve thinking iteratively
+- Elevate ideas and connect to business goals
+- Forge thinking in the furnace of logic, flow, and UX
+- **Create ideas that matter** instead of churning out prototypes
+- **Then generate** visuals from strategic foundation
+
+**The WDS difference:**
+
+> Everyone uses AI for code.
+> **WDS uses AI for strategic thinking first, then code.**
+
+**You're no longer just making it pretty. You're shaping strategy.**
+
+---
+
+## The Three Eras of Design
+
+| Era | Your Role | Tools | Value |
+|-----|-----------|-------|-------|
+| **Waterfall** | Execute specs | Photoshop, wireframes | Visual craft |
+| **Agile** | Collaborate constantly | Figma, Slack | Craft + collaboration |
+| **AI (amateur)** | Generate prototypes | AI + Figma | Fast prototypes |
+| **AI (WDS)** | **Forge strategy** | **AI thinking partners** | **Strategic craft** |
+
+**The shift:**
+
+**Agile era designer:**
+> "Let's meet and figure it out together. I'll sketch options."
+
+**Amateur AI designer:**
+> "AI can generate options. Let me show you 5 variations!"
+
+**WDS designer:**
+> "I forged a complete strategic solution with AI. Here's why it works, who it's for, and how it connects to our goals. Ready to implement."
+
+---
+
+## Present to Team, Not Prototype With Them
+
+### Old Model: Constant Collaboration
+
+**How you worked:**
+1. Meet constantly
+2. Discuss vague ideas
+3. Sketch something
+4. Review together
+5. Discuss changes
+6. Re-sketch
+7. Repeat until deadline
+
+**Your value:** Visual skills + collaboration
+
+**The problem:** Ideas emerge through iteration, not strategic thinking
+
+### New Model: Strategic Presentation
+
+**How you work now:**
+1. Forge thinking with AI assistance (Saga, Freya)
+2. Create complete strategic specifications
+3. Present polished vision to team
+4. They review substance, not sketches
+5. Aligned feedback
+6. Generate implementation correctly (once)
+
+**Your value:** Strategic thinking + visual craft + business alignment
+
+**The benefit:** Ideas emerge from strategic thinking, then get visualized
+
+**The shift:**
+- From "let's figure it out together in meetings"
+- To "I forged this into coherent strategy, let's align"
+
+**Communication becomes strategic alignment**, not iterative discovery.
+
+---
+
+## The Furnace of Logic
+
+**What WDS provides you as a designer:**
+
+### Phase 1: Forge Strategy (Module 04-06)
+
+**With Saga's help:**
+- Product Brief: Align vision with business goals
+- Trigger Mapping: Connect user psychology to business value
+- Feature scoring: Prioritize ruthlessly based on data
+
+**You're not just designing. You're thinking strategically about what to build and why.**
+
+### Phase 2: Forge UX (Module 08-11)
+
+**With Freya's help:**
+- Scenario outlining: Define complete user journeys
+- Conceptual sketching: Visualize strategic solutions
+- Storyboarding: Document all transformations
+- Specifications: Capture every decision with rationale
+
+**You're not just sketching. You're forging complete strategic UX specifications.**
+
+**This is the furnace.**
+
+AI agents help you **forge strategic thinking** through logic, user psychology, and business alignment.
+
+**The output:** Polished specifications that matter.
+
+**Not prototypes to iterate on. Strategic ideas to implement.**
+
+---
+
+## WDS: Your Strategic Rocket Ship With Guard Rails
+
+**The problem with amateur autonomous design:**
+
+AI lets you generate autonomously. Great!
+
+But without strategic framework, you flood colleagues with **lovecoded colorful distractions**:
+- 5 login variations with no strategic reasoning
+- Pretty mockups disconnected from business goals
+- Endless options without clear purpose
+- "Which do you like?" instead of "Here's what we need and why"
+
+**The traditional response:** Control. Oversight. Slow you down.
+
+**The WDS response:** Give you a strategic rocket ship with guard rails.
+
+### The Rocket Ship (Empowerment)
+
+**WDS enables you to work autonomously:**
+- Forge strategy with Saga (no waiting for PM)
+- Create UX with Freya (no waiting for design lead)
+- Generate specifications complete with rationale
+
+**You can move fast. Autonomously. Strategically.**
+
+### The Guard Rails (Strategic Discipline)
+
+**WDS enforces strategic rigor:**
+- Every scenario connects to Trigger Map (no designing in vacuum)
+- Every decision traces to user driving force (no decoration)
+- Every specification includes business context (no guessing)
+- Present complete thinking (no flooding with half-baked ideas)
+
+**You have freedom within strategic structure.**
+
+### The Result
+
+**With WDS:**
+- Make your strategic ideas reality (rocket ship power)
+- Without flooding colleagues (guard rails prevent chaos)
+- Autonomous but aligned (independent but strategic)
+- Fast but focused (speed with strategic substance)
+
+**The old dichotomy:**
+> Either you work slowly with oversight, OR you work fast with chaos.
+
+**The WDS solution:**
+> Work fast AND stay strategically aligned.
+
+### The Business Opportunity
+
+**WDS isn't just a personal methodology. It's a platform businesses can deploy.**
+
+**The business model:**
+
+Businesses can **fork WDS** and customize it:
+- Implement their own guard rails (company standards, design systems, brand guidelines)
+- Define their own ways of working (processes, approvals, workflows)
+- Embed their strategic frameworks (business goals, success metrics, user research)
+- Customize AI agents with company-specific knowledge
+
+**Then give this tool to their people.**
+
+**The result for businesses:**
+
+**Without WDS:**
+- Either slow employees down with oversight
+- OR let them work fast but flood the organization with lovecoded colorful distractions
+- Cannot trust autonomous work
+- AI makes the chaos worse (faster bad output)
+
+**With WDS (customized for your business):**
+- Employees work autonomously AND stay aligned with business strategy
+- Every output connects to company goals
+- Guard rails enforce company standards automatically
+- AI amplifies strategic thinking, not just execution
+- **People make things that matter** (for the business, for users)
+
+**This is the business value proposition:**
+
+> Deploy WDS as your organization's strategic framework for AI-assisted design and development. Your people get a rocket ship. You get guard rails. Everyone wins.
+
+**WDS enables businesses to:**
+- Empower teams without losing control
+- Scale strategic thinking (not just code generation)
+- Trust autonomous AI-assisted work
+- Transform "check my work" culture into "aligned strategic output" culture
+
+**The traditional choice:**
+> Control OR chaos. Slow OR sloppy. Oversight OR anarchy.
+
+**The WDS choice:**
+> Fast AND aligned. Autonomous AND strategic. Empowered AND governed.
+
+---
+
+## What This Prevents
+
+**❌ Without strategic framework (amateur autonomous):**
+- "I made 5 login screen variations! Which do you like?"
+- Lovecoded prototypes with no business connection
+- Colorful distractions that waste team time
+- Half-baked visual ideas presented as solutions
+- Flooding colleagues with "what do you think?" requests
+
+**✓ With WDS (strategic autonomous):**
+- "Here's the login scenario, traced to our #1 user driver, aligned with business goal, with complete specs and rationale."
+- Strategic specifications with clear purpose
+- Polished ideas that respect team time
+- Complete strategic thinking presented once
+- Present for alignment, not visual preference
+
+**The difference:** Strategic thinking BEFORE visual execution.
+
+**Your new value:** Strategic craft, not just visual craft.
+
+---
+
+## The Economic Reality for Designers
+
+**What changed:**
+
+| Resource | Agile Era | AI Era |
+|----------|-----------|--------|
+| **Your craft time** | Expensive (manual work) | Cheap (AI assists) |
+| **Strategic thinking** | PM's job | **Cheap (AI assists)** ← WDS insight |
+| **Communication** | Cheap (constant meetings) | Expensive (alignment takes time) |
+| **Your value** | Visual craft | **Strategic craft** |
+
+**The WDS realization:**
+
+If visual work is cheap (AI-assisted) **AND strategic thinking is also cheap (AI-assisted)**, then your value shifts from "making it pretty" to "thinking strategically about what to make and why."
+
+**This is what WDS enables.**
+
+**The professional WDS designer uses AI for both:**
+1. **Strategic thinking FIRST** (forge with Saga, Freya)
+2. Visual execution (generate from complete specs)
+
+**The amateur designer uses AI for only:**
+1. Visual generation (prompt for pretty outputs)
+2. *(Strategic thinking: Still skipped)*
+
+**The WDS advantage:**
+
+Amateur designers make AI code faster.
+
+**WDS designers make AI think strategically, then code correctly.**
+
+---
+
+## Your Choice
+
+### Path 1: Stay a Pixel Pusher (Amateur)
+
+**The flow:**
+- Skip strategic thinking
+- Prompt AI for visual outputs
+- Generate variations
+- Present options
+- Let others decide strategy
+- Repeat endlessly
+
+**Your value:** Fast visual generation
+
+**Your career:** Commoditized (AI does this)
+
+### Path 2: Become a Strategic Thinker (Professional)
+
+**The flow:**
+- Forge strategy with AI partners
+- Create complete specifications
+- Generate visuals from strategic foundation
+- Present strategic solutions
+- Team aligns on substance
+- Implement correctly
+
+**Your value:** Strategic design thinking
+
+**Your career:** Essential (AI enables this, doesn't replace it)
+
+---
+
+## Why This Matters for You
+
+**WDS exists to elevate your role from pixel pusher to strategic thinker.**
+
+**The methodology empowers you:**
+- Saga helps you think strategically about business and users
+- Freya helps you forge complete UX specifications
+- Freya helps you generate implementations
+
+**The guard rails keep you strategic:**
+- Every decision traces to business goals
+- Every design connects to user psychology
+- Every specification includes complete context
+
+**The economics work because:**
+- Strategic thinking: Cheap (AI-assisted)
+- Visual craft: Cheap (AI-assisted)
+- Your new value: **Strategic craft** (thinking + execution)
+
+**Skip the strategic thinking, and you're just a faster pixel pusher.**
+
+**Embrace strategic thinking, and you become indispensable.**
+
+**Why this matters for your career:**
+
+As businesses adopt WDS (or fork it for their own organizations), they'll need designers who can:
+- Work within strategic frameworks
+- Use AI for thinking, not just execution
+- Present polished strategic work, not half-baked prototypes
+- Operate autonomously while staying aligned
+
+**WDS-trained designers become essential** in organizations deploying strategic AI frameworks.
+
+Amateur vibe coders? They're why businesses need guard rails.
+
+**You're the professional who makes the guard rails work.**
+
+---
+
+## Key Takeaways
+
+✅ **THE WDS INSIGHT** - Strategic thinking got cheap too (not just code)
+
+✅ **Your role changed** - From pixel pusher to strategic thinker
+
+✅ **Everyone uses AI for code** - WDS uses AI for strategic thinking FIRST
+
+✅ **Vibe coding is amateur** - Generates pretty prototypes without substance
+
+✅ **Strategic craft is professional** - Forge thinking, then execute
+
+✅ **WDS gives you both** - Rocket ship (autonomy) + guard rails (strategy)
+
+✅ **Businesses can deploy WDS** - Fork it, customize guard rails, empower teams to make things that matter
+
+✅ **Present substance, not sketches** - Polished strategic thinking
+
+✅ **Your new value** - Strategic craft, not just visual craft
+
+---
+
+**Everyone knows AI made code cheap.**
+
+**The WDS insight: Strategic thinking got cheaper too.**
+
+**Everyone uses AI for code. WDS uses AI for strategic thinking first.**
+
+**Your role just changed: From pixel pusher to strategic thinker.**
+
+**WDS exists to help you step into this new role.**
+
+---
+
+**[Continue to Lesson 3: The Solution →](lesson-03-the-solution.md)**
+
+---
+
+[← Back to Lesson 1](lesson-01-the-problem.md) | [Module Overview](module-01-overview.md) | [Next: Lesson 3 →](lesson-03-the-solution.md)
+
+*Part of Module 01: Why WDS Matters*

package/docs/{learn-wds/module-01-why-wds-matters/lesson-02-the-solution.md → learn/module-01-why-wds-matters/lesson-03-the-solution.md}

@@ -1,6 +1,6 @@
 # Module 01: Why WDS Matters
 
-## Lesson 2: Becoming a Linchpin Designer
+## Lesson 3: Becoming a Linchpin Designer
 
 **The solution: WDS methodology**
 
@@ -68,8 +68,10 @@ You remain in the loop - the skilled, experienced designer who evaluates AI's wo
 
 Now that you understand the solution, let's explore what you'll learn and how to apply it.
 
-**[Continue to Lesson 3: The Path Forward →](lesson-03-the-path-forward.md)**
+**[Continue to Lesson 4: The Path Forward →](lesson-04-the-path-forward.md)**
 
 ---
 
-[← Back to Lesson 1: The Problem](lesson-01-the-problem.md) | [Next: The Path Forward →](lesson-03-the-path-forward.md)
+[← Back to Lesson 2: Designer as Strategic Thinker](lesson-02-designer-as-strategic-thinker.md) | [Module Overview](module-01-overview.md) | [Next: Lesson 4 →](lesson-04-the-path-forward.md)
+
+*Part of Module 01: Why WDS Matters*

package/docs/{learn-wds/module-01-why-wds-matters/lesson-03-the-path-forward.md → learn/module-01-why-wds-matters/lesson-04-the-path-forward.md}

@@ -1,6 +1,6 @@
 # Module 01: Why WDS Matters
 
-## Lesson 3: Your Transformation
+## Lesson 4: Your Transformation
 
 **From replaceable to indispensable**
 
@@ -75,20 +75,23 @@ _More case studies will be added here as they become available._
 You've completed Module 01: Why WDS Matters. You now understand:
 
 - ✅ The problem: Factory mindset vs linchpin mindset
+- ✅ The strategic shift: Designer as strategic thinker
 - ✅ The solution: Becoming a linchpin designer with WDS
 - ✅ The path forward: 5-dimensional thinking and transformation
 
 **Next steps:**
 
 - Review the practicalities if you haven't already
-- Start Module 02: Project Brief
+- Start Module 02: Installation & Setup
 - Apply these concepts to your own work
 
-**[Continue to Module 02: Project Brief →](../module-02-project-brief/lesson-01-inspiration.md)**
+**[Continue to Module 02: Installation & Setup →](../module-02-installation-setup/module-02-overview.md)**
 
-Or review the practicalities:
-**[Read Course Practicalities →](../00-practicalities.md)**
+Or review the getting started guide:
+**[Getting Started Guide →](../00-course-overview/00-getting-started-overview.md)**
 
 ---
 
-[← Back to Lesson 2](lesson-02-the-solution.md) | [Module Overview](module-01-overview.md) | [Next Module →](../module-02-project-brief/lesson-01-inspiration.md)
+[← Back to Lesson 3](lesson-03-the-solution.md) | [Module Overview](module-01-overview.md) | [Next Module →](../module-02-installation-setup/module-02-overview.md)
+
+*Part of Module 01: Why WDS Matters*

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

@@ -8,7 +8,7 @@
 
 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)
+**Time:** ~40 minutes (4 lessons × 10 min each)
 **Prerequisites:** None - this is where you start!
 
 ---
@@ -38,7 +38,19 @@ Understanding the factory mindset and the AI era:
 - AI threat for cogs
 - AI opportunity for linchpin designers
 
-### [Lesson 2: Becoming a Linchpin Designer](lesson-02-the-solution.md)
+### [Lesson 2: Designer as Strategic Thinker](lesson-02-designer-as-strategic-thinker.md)
+
+**Time:** 10 minutes
+
+Your role just changed:
+
+- The shift everyone missed: strategic thinking got cheap too
+- Vibe coding vs strategic craft
+- The three eras of design
+- WDS: Your strategic rocket ship with guard rails
+- Present substance, not sketches
+
+### [Lesson 3: Becoming a Linchpin Designer](lesson-03-the-solution.md)
 
 **Time:** 10 minutes
 
@@ -50,7 +62,7 @@ The solution: WDS methodology:
 - From cog to linchpin designer
 - The paradigm shift: design becomes specification
 
-### [Lesson 3: Your Transformation](lesson-03-the-path-forward.md)
+### [Lesson 4: Your Transformation](lesson-04-the-path-forward.md)
 
 **Time:** 10 minutes
 
@@ -106,4 +118,10 @@ By the end of this module, you will:
 
 ---
 
-[← Back to Course Start](../00-start-here.md)
+## Next Module
+
+**[Module 02: Installation & Setup →](../module-02-installation-setup/module-02-overview.md)**
+
+---
+
+[← Back to Course Overview](../00-course-overview/00-course-overview.md)

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

@@ -1,4 +1,6 @@
-# Lesson 01: Git Setup
+# Module 02: Installation & Setup
+
+## Lesson 1: Git Setup
 
 **Create GitHub account and project repository**
 
@@ -40,9 +42,9 @@ Professional cloud storage + time machine for your project files. Every change i
 
 ## 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)
+**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.md)
 
 ---
 
@@ -86,7 +88,7 @@ Professional cloud storage + time machine for your project files. Every change i
 ```
 Hi [Name],
 
-I'd like to contribute to [project-name] using WDS methodology. 
+I'd like to contribute to [project-name] using WDS methodology.
 Could you add me as a collaborator?
 
 My GitHub username: [your-username]
@@ -105,8 +107,8 @@ Thank you!
 
 ## Troubleshooting
 
-**Issue:** Verification email missing → Check spam  
-**Issue:** Username taken → Try `yourname-designer-2`  
+**Issue:** Verification email missing → Check spam
+**Issue:** Username taken → Try `yourname-designer-2`
 **Issue:** Repository name taken → Add your username
 
 ---
@@ -115,10 +117,9 @@ Thank you!
 
 GitHub account and repository ready! Now install your IDE.
 
-**[Continue to Lesson 02: IDE Installation →](../lesson-02-ide-installation/02-full-lesson.md)**
+**[Continue to Lesson 02: IDE Installation →](lesson-02-ide-installation.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-wds/module-02-installation-setup/lesson-02-ide-installation/02-lesson.md → learn/module-02-installation-setup/lesson-02-ide-installation.md}

@@ -1,4 +1,6 @@
-# Lesson 02: IDE Installation
+# Module 02: Installation & Setup
+
+## Lesson 2: IDE Installation
 
 **Get your workspace ready**
 
@@ -69,8 +71,8 @@ Press **Ctrl+`** (Win/Linux) or **Cmd+`** (Mac)
 
 ## Troubleshooting
 
-**Issue:** Can't find download → Check Downloads folder  
-**Issue:** Mac "unidentified developer" → Right-click → Open  
+**Issue:** Can't find download → Check Downloads folder
+**Issue:** Mac "unidentified developer" → Right-click → Open
 **Issue:** Terminal won't open → View menu → Terminal → New Terminal
 
 ---
@@ -79,10 +81,9 @@ Press **Ctrl+`** (Win/Linux) or **Cmd+`** (Mac)
 
 IDE ready! Now clone your Git repository.
 
-**[Continue to Lesson 03: Git Repository Cloning →](../lesson-03-git-cloning/02-full-lesson.md)**
+**[Continue to Lesson 03: Git Repository Cloning →](lesson-03-git-cloning.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)*