whiteport-design-studio 0.1.0

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

@@ -0,0 +1,73 @@
+# Lesson 04: WDS Project Initialization - Quick Checklist
+
+**⏱️ 15-20 minutes**
+
+---
+
+## Clone WDS Repository
+
+In terminal (in Projects folder):
+
+```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
+- [ ] ✅ Both folders in sidebar
+
+---
+
+## Create Docs Structure
+
+In terminal (in YOUR project):
+
+```bash
+cd ~/Projects/your-project-name
+
+# 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/`
+
+---
+
+## Activate Mimir
+
+- [ ] Find `whiteport-design-studio/src/modules/wds/MIMIR-WDS-ORCHESTRATOR.md`
+- [ ] Press **Ctrl+L** or **Cmd+L** (open AI chat)
+- [ ] Drag Mimir file to chat
+- [ ] Type: "Hello Mimir! I just completed setup."
+- [ ] ✅ Mimir responds!
+
+---
+
+## 🎉 Complete!
+
+- ✅ GitHub account & repository
+- ✅ IDE installed
+- ✅ Project cloned
+- ✅ WDS integrated
+- ✅ Docs structure created
+- ✅ Mimir activated
+
+**Next:** [Module 03: Create Project Brief](../../module-03-project-brief/module-03-overview.md)
+
+---
+
+**Need more detail?** See [full lesson](02-full-lesson.md)
+

package/docs/learn-wds/module-02-installation-setup/lesson-05-initiate-mimir/checklist.md

@@ -0,0 +1,79 @@
+# Lesson 05: Mimir Activation - Quick Checklist
+
+**⏱️ 5 minutes**
+
+---
+
+## Find Mimir
+
+In Cursor sidebar:
+- [ ] Expand `whiteport-design-studio`
+- [ ] Expand `src` → `modules` → `wds`
+- [ ] Find `MIMIR-WDS-ORCHESTRATOR.md`
+
+---
+
+## Open AI Chat
+
+- [ ] Press **Ctrl+L** (Win/Linux) or **Cmd+L** (Mac)
+- [ ] Or click chat icon in sidebar
+
+---
+
+## Activate Mimir
+
+- [ ] Drag `MIMIR-WDS-ORCHESTRATOR.md` into chat input
+- [ ] OR type: `@MIMIR-WDS-ORCHESTRATOR.md`
+- [ ] Type: "Hello Mimir! I just completed setup and I'm ready to start."
+- [ ] Press **Enter**
+- [ ] ✅ Mimir responds!
+
+---
+
+## Answer Mimir's Questions
+
+Be honest about:
+- [ ] Your skill level (beginner/learning/comfortable/experienced)
+- [ ] Your project
+- [ ] How you're feeling
+
+Mimir will:
+- [ ] Verify your installation
+- [ ] Guide your next steps
+- [ ] Connect you with specialist agents when ready
+
+---
+
+## Remember This Command
+
+Whenever you need help:
+```
+@wds-mimir [your question]
+```
+
+---
+
+## 🎉 You Did It!
+
+**Completed:**
+- ✅ GitHub account & repository
+- ✅ IDE installed
+- ✅ Project cloned
+- ✅ WDS integrated
+- ✅ Docs structure created
+- ✅ Mimir activated
+
+**You're ready to design with WDS!**
+
+---
+
+## Next Steps
+
+- **[Module 03: Create Project Brief](../../module-03-project-brief/module-03-overview.md)**
+- **[WDS Training Course](../../00-course-overview.md)**
+- **Ask Mimir:** "What should I do next?"
+
+---
+
+**Need more detail?** See [full lesson explanation](lesson.md)
+

package/docs/learn-wds/module-02-installation-setup/lesson-05-initiate-mimir/tutorial.md

@@ -0,0 +1,244 @@
+# Lesson 05: Mimir Activation
+
+**Activate your WDS guide and begin your journey**
+
+---
+
+## What You'll Do
+
+- Find the Mimir orchestrator file
+- Drag it to AI chat
+- Have your first conversation with Mimir
+- Begin guided WDS workflow
+
+**Time:** 5 minutes
+
+---
+
+## What is Mimir?
+
+**Mimir** is your WDS guide and orchestrator.
+
+Think of Mimir as:
+- Your coach through WDS methodology
+- Your trainer for each workflow
+- Your psychologist when things feel overwhelming
+- Your strategist for project decisions
+
+**Mimir's role:** Assess your needs, understand your skill level, and connect you with the right specialist agents (Freya, Saga, Idunn) when appropriate.
+
+---
+
+## Step 1: Find the Mimir File
+
+In Cursor sidebar:
+
+1. Expand **`whiteport-design-studio`**
+2. Expand **`src`** → **`modules`** → **`wds`**
+3. Find **`MIMIR-WDS-ORCHESTRATOR.md`**
+
+**✅ Checkpoint:** You can see the Mimir file
+
+---
+
+## Step 2: Open AI Chat
+
+In Cursor:
+
+- **Windows/Linux:** Press **Ctrl+L**
+- **Mac:** Press **Cmd+L**
+- Or click the **chat icon** in the sidebar
+
+**The AI chat panel will appear!**
+
+---
+
+## Step 3: Drag Mimir to Chat
+
+1. Click and hold **`MIMIR-WDS-ORCHESTRATOR.md`** in the sidebar
+2. Drag it into the AI chat input area
+3. Release
+
+**You should see the file attached to your message!**
+
+**Alternative method:**
+Type in chat:
+```
+@MIMIR-WDS-ORCHESTRATOR.md
+```
+
+---
+
+## Step 4: Send Your First Message
+
+**Type your first message:**
+
+```
+Hello Mimir! I just completed the installation setup and I'm ready to start.
+```
+
+**Press Enter or click Send**
+
+---
+
+## What Mimir Will Do
+
+Mimir will:
+
+1. **Welcome you warmly** 🌊
+2. **Assess your situation:**
+   - Technical skill level (beginner → experienced)
+   - Emotional state (excited, nervous, ready)
+   - Familiarity with WDS
+3. **Check your environment:**
+   - Is WDS repository present?
+   - Is your project set up correctly?
+   - Do you have the docs structure?
+4. **Understand your project:**
+   - What are you building?
+   - What phase are you in?
+   - Do you need to start from Project Brief?
+5. **Guide your next steps:**
+   - Route you to appropriate agent if needed
+   - Suggest which workflow to start with
+   - Offer training if you want to learn first
+
+---
+
+## Be Honest with Mimir
+
+**Mimir adapts to YOU.**
+
+If you're nervous → Mimir will be extra patient  
+If you're experienced → Mimir will be concise  
+If you're confused → Mimir will slow down
+
+**There are no wrong answers!**
+
+---
+
+## Example First Conversation
+
+**You:**
+> Hello Mimir! I just completed setup and I'm ready to start.
+
+**Mimir:**
+> Welcome! 🌊 I'm Mimir, your guide through Whiteport Design Studio.
+>
+> I can see you've completed the installation - that's fantastic work!
+>
+> Let me understand your situation:
+> 1. How comfortable are you with design tools and AI assistants? (Complete beginner / Learning / Comfortable / Experienced)
+> 2. What project are you working on?
+> 3. How are you feeling about starting this journey?
+
+**Just answer honestly!** Mimir will adapt to your needs.
+
+---
+
+## Whenever You Need Help
+
+**Remember this simple command:**
+
+```
+@wds-mimir [your question]
+```
+
+**Examples:**
+- `@wds-mimir I'm stuck on trigger mapping, can you help?`
+- `@wds-mimir Which agent should I work with for UX design?`
+- `@wds-mimir I feel overwhelmed, where should I start?`
+- `@wds-mimir Can you walk me through the WDS training?`
+
+**No question is too small. Mimir is always here to guide you.**
+
+---
+
+## Troubleshooting
+
+**Issue:** Can't find MIMIR file  
+**Solution:** Make sure you added `whiteport-design-studio` to workspace (Lesson 04, Step 5)
+
+**Issue:** Drag doesn't work  
+**Solution:** Use `@MIMIR-WDS-ORCHESTRATOR.md` instead
+
+**Issue:** AI doesn't respond  
+**Solution:** Make sure you're connected to internet, wait a moment, try again
+
+**Issue:** Not sure what to say  
+**Solution:** Just say "Hello! I'm new and ready to start" - Mimir will guide you from there
+
+---
+
+## 🎉 Congratulations!
+
+### You Did It!
+
+You've completed the entire Module 02: Installation & Setup!
+
+**What you accomplished:**
+- ✅ Created GitHub account
+- ✅ Set up project repository
+- ✅ Installed IDE (Cursor or VS Code)
+- ✅ Cloned your project
+- ✅ Added WDS to workspace
+- ✅ Created docs structure
+- ✅ Activated Mimir
+
+**This is HUGE!** Many designers never get past this point. You're ready to design with WDS.
+
+---
+
+## Your Journey Continues
+
+**Next steps (Mimir will guide you):**
+
+- **[Module 03: Create Project Brief](../../module-03-project-brief/module-03-overview.md)** - If starting a new project
+- **[WDS Training Course](../../00-course-overview.md)** - If you want to learn methodology first
+- **Ask Mimir** - "What should I do next?"
+
+---
+
+## Pro Tips for Beginners
+
+**Tip 1: Commit Often**
+Every time you make meaningful progress, save to GitHub:
+```bash
+git add .
+git commit -m "Describe what you did"
+git push
+```
+
+**Tip 2: Keep WDS Updated**
+Once a month, update WDS to get new features:
+```bash
+cd ~/Projects/whiteport-design-studio
+git pull
+```
+
+**Tip 3: When in Doubt, Ask Mimir**
+```
+@wds-mimir [your question]
+```
+No question is too small!
+
+**Tip 4: Save Your Workspace**
+In Cursor: **File** → **Save Workspace As** → `my-project.code-workspace`
+Next time, just open this file!
+
+---
+
+## Remember
+
+**Whenever in doubt:**
+
+```
+@wds-mimir [your question]
+```
+
+**Mimir believes in you. You can do this. Welcome to WDS.** 🌊
+
+---
+
+*Part of Module 02: Installation & Setup*  
+*[← Back to Module Overview](../module-02-overview.md)*

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

@@ -0,0 +1,77 @@
+# 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/)
+**15-20 minutes** | Create GitHub account and repository
+
+- **[01 - Quick Checklist](lesson-01-git-setup/01-quick-checklist.md)** - Action list
+- **[02 - Full Lesson](lesson-01-git-setup/02-full-lesson.md)** - With explanations
+
+---
+
+### [Lesson 02: IDE Installation](lesson-02-ide-installation/)
+**10 minutes** | Install Cursor or VS Code
+
+- **[01 - Quick Checklist](lesson-02-ide-installation/01-quick-checklist.md)** - Action list
+- **[02 - Full Lesson](lesson-02-ide-installation/02-full-lesson.md)** - With explanations
+
+---
+
+### [Lesson 03: Git Repository Cloning](lesson-03-git-cloning/)
+**10 minutes** | Clone your project to your computer
+
+- **[01 - Quick Checklist](lesson-03-git-cloning/01-quick-checklist.md)** - Action list
+- **[02 - Full Lesson](lesson-03-git-cloning/02-full-lesson.md)** - With explanations
+
+---
+
+### [Lesson 04: WDS Project Initialization](lesson-04-wds-initialization/)
+**15-20 minutes** | Add WDS, create docs structure, activate Mimir
+
+- **[01 - Quick Checklist](lesson-04-wds-initialization/01-quick-checklist.md)** - Action list
+- **[02 - Full Lesson](lesson-04-wds-initialization/02-full-lesson.md)** - With explanations
+
+---
+
+## Quick Start
+
+**Want the fastest path?**
+
+Follow the checklists: [Start with Lesson 01 Checklist →](lesson-01-git-setup/01-quick-checklist.md)
+
+**Want detailed explanations?**
+
+Follow the full lessons: [Start with Lesson 01 Full Lesson →](lesson-01-git-setup/02-full-lesson.md)
+
+---
+
+## After This Module
+
+- ✅ GitHub account and repository
+- ✅ IDE installed and configured
+- ✅ Project cloned to your computer
+- ✅ WDS integrated in workspace
+- ✅ Docs folder structure created
+- ✅ Mimir activated and ready
+
+**Next:** [Module 03: Create Project Brief](../module-03-project-brief/module-03-overview.md)
+
+---
+
+*Part of the WDS Course: From Designer to Linchpin*  
+*[← Back to Course Overview](../00-course-overview.md)*

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

@@ -0,0 +1,175 @@
+# Lesson 1: Understanding Alignment
+
+**Why alignment matters before starting work - and why understanding comes first**
+
+**Time:** 10 minutes
+
+---
+
+## The Foundation: Understand Before You Solve
+
+Before we talk about alignment documents and contracts, let's talk about the discipline that makes everything else work: **understanding before solving**.
+
+**The carpenter measures twice before cutting once.**  
+**The doctor diagnoses before writing a prescription.**  
+**You understand deeply before proposing solutions.**
+
+This isn't about being slow. It's about being professional.
+
+---
+
+## The Two-Meeting Approach
+
+**Meeting 1: Discovery**
+- Ask questions
+- Find the real pain points
+- Take notes
+- Confirm understanding
+- Say: "Let me think about this and come back with a thoughtful proposal"
+- **Do NOT present solutions yet**
+
+**Meeting 2: Presentation**
+- Present your thoughtful alignment document
+- Show you understand their needs
+- Negotiate and iterate
+- Get acceptance
+
+**Why this matters:** When you resist the urge to solve immediately and take time to understand deeply, stakeholders FEEL that you genuinely care about their success, not just about showing off your cleverness.
+
+---
+
+## Why Alignment Matters
+
+When you're building something that makes the world a better place, and you need others involved, you need alignment first.
+
+**Without alignment:**
+- Misunderstandings about scope
+- Disagreements about budget
+- Unclear expectations
+- Projects fail or stall
+
+**With alignment:**
+- Everyone understands the idea, why, what, how, budget, and commitment
+- Clear expectations from the start
+- Projects succeed because everyone is on the same page
+
+---
+
+## The 6 Elements of Alignment
+
+When others are involved, you need alignment on:
+
+1. **The Idea** - What are we building?
+2. **Why** - Why should it be done?
+3. **What** - What does it contain?
+4. **How** - How will it be executed?
+5. **Budget** - What resources are needed?
+6. **Commitment** - What are we willing to commit to make it happen?
+
+**But here's the key:** These elements come from discovery. You learn what they need FIRST, then you articulate these elements based on that understanding. You're not making this up - you're reflecting back what they told you matters to them.
+
+---
+
+## Discovery Questions That Reveal What They Need
+
+Before you can create an alignment document, you need to understand what success looks like for THEM:
+
+**Understanding Their Desired Outcomes:**
+- **What does success look like for you?** (Their desired outcome)
+- **What's not working right now?** (The pain they're experiencing)
+- **Tell me more about that - what specifically happens?** (Dig deeper)
+- **How does that impact your business/team/users?** (Understanding consequences)
+- **What happens if we don't solve this?** (The cost of inaction)
+- **What have you tried before?** (What didn't work and why)
+- **What would make this a home run?** (Their definition of exceptional)
+
+**Understanding Their Concerns & Risks:**
+- **Is there something specific you're concerned about?** (Their worries)
+- **What would help you feel confident about moving forward?** (What they need to feel secure)
+- **What lessons have you learned from past projects?** (Learning from history without dwelling on failures)
+- **What would make you feel this is going well as we proceed?** (Positive indicators)
+- **What dependencies or external factors should we plan for?** (External factors, neutral framing)
+- **What would be important to include in our agreement?** (Their priorities for protection)
+- **How would you like us to handle changes or unexpected situations?** (Proactive planning)
+
+**Keep asking until you find the real pain point AND the real risks.** Then enquire deeper about both. Confirm they actually exist before you even think about solutions.
+
+**Why ask about risks?** Because understanding their concerns helps you:
+- Create contract provisions that actually protect against real risks
+- Set realistic expectations
+- Build trust by showing you're thinking about problems, not just opportunities
+- Design solutions that mitigate their specific concerns
+- Include mutually beneficial protections in the agreement
+
+---
+
+## Different User Scenarios
+
+### Consultant → Client
+- **You:** Consultant proposing a solution
+- **They:** Client who needs to approve
+- **Document:** Project Contract
+- **Need:** Get client aligned and committed
+
+### Business Owner → Suppliers
+- **You:** Business owner hiring consultants/suppliers
+- **They:** Suppliers who need to understand the work
+- **Document:** Service Agreement
+- **Need:** Get suppliers aligned and committed
+
+### Manager/Employee → Stakeholders
+- **You:** Manager or employee seeking approval
+- **They:** Internal stakeholders (sponsors, budget approvers)
+- **Document:** Signoff Document
+- **Need:** Get stakeholders aligned and committed
+
+---
+
+## When to Skip Alignment
+
+**Skip this module if:**
+- You're doing the project yourself
+- 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)
+
+---
+
+## The Alignment Process
+
+**The complete workflow from first meeting to project start:**
+
+1. **Discovery meeting** - Listen: Ask questions, find pain points, take notes, confirm understanding
+2. **Stop & reflect** - "Let me think about this and come back with a thoughtful proposal"
+3. **Create alignment document** - Based on what you learned in discovery
+4. **Presentation meeting** - Present: Share with stakeholders, show you understood them
+5. **Iterate** - Negotiate: Adjust and refine together until you find the perfect match
+6. **Get acceptance** - Accept: They say "Yes, this is exactly what we need"
+7. **Generate signoff document** - Contract: Create short, clear contract based on accepted pitch
+8. **Sign** - Both parties sign
+9. **Create project brief** - Brief: Use pitch and contract as the backbone
+
+**Key principle:** The pitch and contract aren't throwaway documents. They become the foundation that guides your entire project. Everything connects.
+
+---
+
+## Key Takeaways
+
+**The discipline of professional patience:**
+- The carpenter measures twice before cutting once
+- The doctor diagnoses before prescribing
+- You understand before solving
+
+**The mindset shift:**
+- When you genuinely understand what they need, pitching stops feeling like selling and starts feeling like helping
+- You're not trying to impress them with quick solutions - you're serving them with thoughtful understanding
+
+**WDS helps with alignment** - getting everyone on the same page before starting work. But it starts with the discipline to understand deeply first. The alignment phase is collaborative and iterative. Once approved, the signoff document formalizes that commitment.
+
+---
+
+**Next:** [Lesson 2: Creating Your Alignment Document →](lesson-02-creating-alignment-document.md)
+
+[← Back to Module Overview](module-03-overview.md)
+