whiteport-design-studio 0.1.0

package/docs/getting-started/quick-start.md

@@ -0,0 +1,125 @@
+# Quick Start
+
+**Your first 5 minutes with WDS**
+
+---
+
+## What You'll Do
+
+1. Create a Trigger Map
+2. Initialize a scenario
+3. Sketch your first page
+4. Generate specifications
+
+**Time: 5 minutes**
+
+---
+
+## Step 1: Start WDS
+
+```bash
+npm start
+```
+
+Agent: "Welcome to Whiteport Design Studio! Ready to start?"
+
+---
+
+## Step 2: Create Trigger Map
+
+```
+You: "Let's create a Trigger Map for a dog walking app"
+
+Agent: "Great! Who is your primary target group?"
+You: "Parents who struggle with family dog care coordination"
+
+Agent: "What triggers their need?"
+You: "Family conflict over who walks the dog"
+
+Agent: "What outcome do they want?"
+You: "Accountability without nagging"
+```
+
+**✅ Trigger Map created**
+
+---
+
+## Step 3: Initialize Scenario
+
+```
+Agent: "What feature delivers the most value to parents?"
+You: "Family dog walk calendar"
+
+Agent: "Where do they first encounter this?"
+You: "Google search - frustrated with conflict"
+
+Agent: "What's the shortest path to mutual success?"
+You: "Landing → Sign up → Family setup → Calendar → First walk"
+```
+
+**✅ Scenario initialized**
+
+---
+
+## Step 4: Sketch First Page
+
+```
+Agent: "Let's start with the Landing page. Upload your sketch."
+You: [Upload sketch]
+
+Agent: "I see: Header, Hero section, How it works, Sign up CTA.
+        Should I analyze these sections?"
+You: "Yes"
+```
+
+**✅ Sketch analyzed**
+
+---
+
+## Step 5: Generate Specifications
+
+```
+Agent: "Based on your Trigger Map:
+        - Target: Parents (tired of nagging)
+        - Trigger: Family conflict
+
+        For the Hero section, I suggest:
+        Headline: 'Stop Nagging. Start Harmony.'
+
+        Does this address their frustration?"
+
+You: "Perfect!"
+```
+
+**✅ Specifications generated**
+
+---
+
+## What Just Happened?
+
+You created **conceptual specifications** in 5 minutes:
+
+- Connected to user psychology (Trigger Map)
+- Grounded in real context (Scenario Init)
+- Generated with AI assistance (Agent collaboration)
+- Preserved your thinking (Conceptual specs)
+
+---
+
+## Next Steps
+
+### Learn the Concepts
+
+[Learn WDS Course](../learn-wds/00-course-overview.md) - Deep dive into WDS methodology
+
+### Start Your Project
+
+[Workflows Guide](../wds-workflows-guide.md) - Full workflow documentation
+
+### Get Help
+
+[Community](https://discord.gg/whiteport) - Join the WDS community
+
+---
+
+[← Back to Installation](installation.md) | [Next: Where to Go Next →](where-to-go-next.md)

package/docs/getting-started/where-to-go-next.md

@@ -0,0 +1,137 @@
+# Where to Go Next
+
+**You've learned about WDS, installed it, and completed the quick start. Now what?**
+
+---
+
+## Choose Your Path
+
+### 🎓 Take the Course
+
+**[WDS Course: From Designer to Linchpin](../learn-wds/00-course-overview.md)**
+
+Complete training from project brief to AI-ready specifications:
+
+**Module 01: Why WDS Matters**  
+Learn how to be indispensable in the AI era. Understand the paradigm shift where design becomes specification.  
+→ [Start Module 01](../learn-wds/module-01-why-wds-matters/module-01-overview.md)
+
+**Modules 02-16: Complete WDS Workflow**  
+Master every phase from trigger mapping through design system to development handoff. Each module includes:
+
+- **Lessons** - Theory and concepts with NotebookLM audio
+- **Tutorials** - Step-by-step hands-on guides
+- **Practice** - Apply to your own project
+
+→ [View All Modules](../learn-wds/00-course-overview.md)
+
+**Best for:** Comprehensive learning with structured curriculum
+
+**Time:** ~10 hours (lessons + tutorials + practice)
+
+---
+
+### 🚀 Start Your Project
+
+**[Workflows Guide](../wds-workflows-guide.md)**
+
+Step-by-step workflows for:
+
+**Phase 1: Project Brief**  
+Define vision, goals, stakeholders, and constraints that guide all design decisions.  
+→ [Tutorial: Create Project Brief](../learn-wds/module-04-product-brief/tutorial-04.md)
+
+**Phase 2: Trigger Mapping**  
+Understand WHO your users are, WHAT triggers their needs, and WHY your business exists. Create a Trigger Map that connects user psychology to business value.  
+→ [Tutorial: Map Triggers & Outcomes](../learn-wds/module-05-map-triggers-outcomes/tutorial-04.md)
+
+**Phase 3: Platform Requirements**  
+Document technical constraints, integrations, and infrastructure needs.  
+→ [Workflows Guide](../wds-workflows-guide.md)
+
+**Phase 4: UX Design**  
+Transform ideas into conceptual specifications that preserve your design intent. AI agents help you think through solutions, then capture your brilliance in specifications that give your designs eternal life.  
+→ [Tutorial: Initialize Scenario](../learn-wds/module-08-initialize-scenario/tutorial-08.md) | [Tutorial: Conceptual Specs](../learn-wds/module-12-conceptual-specs/tutorial-12.md)
+
+**Phase 5: Design System**  
+Extract design tokens, create reusable components, and generate interactive HTML catalog.  
+→ [Workflows Guide](../wds-workflows-guide.md)
+
+**Best for:** Hands-on learning with a real project
+
+**Time:** Ongoing (project-based)
+
+---
+
+### 📚 Reference Documentation
+
+**[Modular Architecture](../workflows/4-ux-design/modular-architecture/00-MODULAR-ARCHITECTURE-GUIDE.md)**
+
+Technical details on:
+
+- Three-tier file structure
+- Content placement rules
+- Component decomposition
+- Storyboard integration
+
+**Best for:** Looking up specific techniques
+
+**Time:** As needed (reference)
+
+---
+
+## Recommended Learning Path
+
+```
+1. Quick Start (5 min) ✅ You are here
+   ↓
+2. Tutorial (1-2 hours)
+   Watch videos, understand concepts
+   ↓
+3. Your First Project (ongoing)
+   Apply WDS to a real project
+   ↓
+4. Reference Docs (as needed)
+   Look up specific techniques
+```
+
+---
+
+## Community & Support
+
+### Discord
+
+Join the WDS community for:
+
+- Questions and answers
+- Project feedback
+- Feature discussions
+
+### GitHub
+
+- Report issues
+- Request features
+- Contribute
+
+### YouTube
+
+- Video tutorials
+- Walkthroughs
+- Case studies
+
+---
+
+## Quick Links
+
+- [Course](../learn-wds/00-course-overview.md)
+- [Workflows](../wds-workflows-guide.md)
+- [Modular Architecture](../src/workflows/4-ux-design/modular-architecture/00-MODULAR-ARCHITECTURE-GUIDE.md)
+- [Conceptual Specifications](../src/workflows/4-ux-design/CONCEPTUAL-SPECIFICATIONS.md)
+
+---
+
+**Ready to dive deeper? Start with the [Course](../learn-wds/00-course-overview.md)!**
+
+---
+
+[← Back to Quick Start](quick-start.md)

package/docs/learn-wds/00-course-overview/00-getting-started-overview.md

@@ -0,0 +1,66 @@
+# Getting Started with WDS
+
+**Everything you need to know before starting the course**
+
+---
+
+## Welcome
+
+Before diving into the WDS methodology, take a few minutes to understand what you need to start, how to approach the course, and where to get help.
+
+**This section covers:**
+
+1. **Prerequisites** - Skills, tools, and requirements
+2. **Learning Paths** - How to take the course and what you'll create
+3. **Support** - Testimonials, FAQ, and community
+
+**Total reading time:** ~15 minutes
+
+---
+
+## Quick Navigation
+
+### [01. Prerequisites →](01-prerequisites.md)
+
+What skills you need, tools required, and time investment
+
+- **Time:** 5 minutes
+- **Key question:** Am I ready to start?
+
+### [02. Learning Paths →](02-learning-paths.md)
+
+Choose your journey and see what you'll create
+
+- **Time:** 5 minutes
+- **Key question:** Which path is right for me?
+
+### [03. Support →](03-support.md)
+
+Testimonials, FAQ, and getting help
+
+- **Time:** 5 minutes
+- **Key question:** What if I get stuck?
+
+---
+
+## Ready to Start?
+
+Once you've reviewed these sections, you're ready to begin:
+
+**[Start Module 01: Why WDS Matters →](../module-01-why-wds-matters/module-01-overview.md)**
+
+Or review the full course structure:
+
+**[← Back to Course Overview](../00-course-overview.md)**
+
+---
+
+## Your Transformation Starts Now
+
+Remember:
+
+- **The design becomes the specification**
+- **The specification becomes the product**
+- **The code is just the printout**
+
+Ten hours of learning. A lifetime of being indispensable.

package/docs/learn-wds/00-course-overview/01-prerequisites.md

@@ -0,0 +1,98 @@
+# Getting Started: Prerequisites
+
+**What you need to start learning WDS**
+
+---
+
+## What Skills You Need
+
+**Required (you probably already have these):**
+
+- Basic design thinking and UX principles
+- Ability to sketch interfaces (hand-drawn or digital)
+- Understanding of user needs and business goals
+- Willingness to think deeply about WHY
+
+**NOT required:**
+
+- ❌ Coding skills
+- ❌ Advanced technical knowledge
+- ❌ Experience with AI tools
+- ❌ Formal design education
+
+**The truth:** If you can design interfaces and explain your thinking, you have everything you need to start.
+
+---
+
+## Time Investment
+
+### How Long Does It Take?
+
+**Total course time:** ~10 hours
+
+- Spread over days or weeks at your own pace
+- Each module: 30-40 minutes
+- Practice exercises: 1-2 hours per module
+
+**Breakdown:**
+
+- **Week 1-2:** Foundation modules (Why WDS, Project Brief)
+- **Week 3-4:** Core workflow (Trigger Mapping, Scenarios)
+- **Week 5-6:** Advanced topics (Design Systems, Handoff)
+- **Ongoing:** Practice with your own projects
+
+**Real-world application:**
+
+- First project with WDS: 2-3x slower than your usual process (learning curve)
+- Second project: Same speed as traditional approach
+- Third project onwards: 3-5x faster with better quality
+
+---
+
+## Tools You'll Need
+
+### Essential Tools
+
+**For sketching:**
+
+- Paper and pen (seriously, this works best)
+- OR digital sketching tool (Excalidraw, Figma, iPad + Pencil)
+
+**For AI assistance:**
+
+- Access to Claude, ChatGPT, or similar AI assistant
+- Free tier is sufficient to start
+
+**For documentation:**
+
+- Text editor (VS Code recommended, but any will work)
+- Markdown support (built into most modern editors)
+
+**For collaboration:**
+
+- Git/GitHub (optional but recommended)
+- Shared folder system (Google Drive, Dropbox, etc.)
+
+**Total cost to get started:** $0-20/month
+
+- Free tier AI tools work fine
+- Paid AI subscriptions ($20/month) provide better experience but aren't required
+
+---
+
+## Are You Ready?
+
+You have everything you need if you can answer YES to these:
+
+- ✅ I can design interfaces and explain my thinking
+- ✅ I have 10 hours to invest over the next few weeks
+- ✅ I have access to basic tools (paper/pen + AI assistant)
+- ✅ I'm willing to think deeply about WHY
+
+**Next:** Choose your learning path
+
+**[Continue to Learning Paths →](02-learning-paths.md)**
+
+---
+
+[← Back to Overview](overview.md) | [Next: Learning Paths →](02-learning-paths.md)

package/docs/learn-wds/00-course-overview/02-learning-paths.md

@@ -0,0 +1,99 @@
+# Getting Started: Learning Paths
+
+**Choose your journey through WDS**
+
+---
+
+## Choose Your Journey
+
+### Option 1: Full Immersion (Recommended)
+
+- Complete all modules in order
+- Practice exercises for each module
+- Apply to a real project as you learn
+- **Time:** 6-8 weeks, 10-15 hours total
+- **Best for:** Designers who want to master the methodology
+
+### Option 2: Quick Start
+
+- Focus on core modules (Module 01, 02, 04, 06)
+- Skip advanced topics initially
+- Get started fast, learn more later
+- **Time:** 2-3 weeks, 3-4 hours total
+- **Best for:** Designers who need results quickly
+
+### Option 3: Self-Paced
+
+- Learn one module per week
+- Deep practice between modules
+- Build multiple projects as you learn
+- **Time:** 16+ weeks, 20+ hours total
+- **Best for:** Designers who want deep mastery
+
+---
+
+## What You'll Create
+
+### Your First WDS Project
+
+By the end of this course, you'll have created:
+
+**1. Complete Project Brief**
+
+- Vision and goals clearly defined
+- Stakeholders and constraints documented
+- Foundation for all design decisions
+
+**2. Trigger Map**
+
+- Target groups identified and prioritized
+- User triggers and outcomes mapped
+- Features prioritized by impact
+
+**3. Scenario Specifications**
+
+- At least one complete user scenario
+- Conceptual specifications for key components
+- AI-ready documentation
+
+**4. Design System Foundation**
+
+- Design tokens extracted from your specs
+- Component patterns identified
+- Reusable architecture defined
+
+**Estimated value:** What used to take 6-8 weeks now takes 1-2 weeks
+
+---
+
+## Course Format
+
+Each module contains:
+
+- **Inspiration** - Why this matters and what you'll gain
+- **Teaching** - How to do it with confidence and AI support
+- **Practice** - Apply it to your own project
+- **Tutorial** - Quick step-by-step guide (for practical modules)
+
+**Learning formats:**
+
+- Read as documentation
+- Generate videos/podcasts with NotebookLM
+- Use in workshops and team training
+- Apply to real projects as you learn
+
+---
+
+## Ready to Begin?
+
+Choose your path and start learning:
+
+**[Start Module 01: Why WDS Matters →](../module-01-why-wds-matters/module-01-overview.md)**
+
+Or check support resources first:
+
+**[Continue to Support →](03-support.md)**
+
+---
+
+[← Back to Prerequisites](01-prerequisites.md) | [Next: Support →](03-support.md)

package/docs/learn-wds/00-course-overview/03-support.md

@@ -0,0 +1,128 @@
+# Getting Started: Support
+
+**Help, community, and what other designers say**
+
+---
+
+## What Other Designers Say
+
+### Testimonials
+
+> "I was skeptical at first - another design methodology? But WDS changed how I think about my role. I'm no longer just making things pretty. I'm the strategic thinker who makes products come alive."
+>
+> **— Sarah K., Product Designer**
+
+> "The 5x speed increase is real. But what surprised me most was how much clearer my thinking became. Writing conceptual specifications forced me to understand the 'why' at a deeper level."
+>
+> **— Marcus L., UX Lead**
+
+> "I thought AI would replace me. WDS showed me how to make AI amplify my thinking instead. Now I'm the most valuable designer on my team."
+>
+> **— Priya S., Senior Designer**
+
+> "The paradigm shift hit me in Module 4: my design IS the product. The code is just the printout. That completely changed how I approach every project."
+>
+> **— James T., Design Director**
+
+_Note: More testimonials will be added as designers complete the course._
+
+---
+
+## Common Questions
+
+### FAQ
+
+**Q: Do I need to know how to code?**
+A: No. WDS is about design thinking and specifications. AI handles the implementation.
+
+**Q: What if I don't have a project to practice with?**
+A: The course includes practice exercises. You can also use a hypothetical project or redesign an existing app.
+
+**Q: Can I use this with my current design process?**
+A: Yes! WDS complements existing processes. Many designers integrate it gradually.
+
+**Q: Is this only for digital products?**
+A: WDS is optimized for digital products, but the principles apply to any design work.
+
+**Q: What if I get stuck?**
+A: Each module includes clear examples and guidance. The AI assistant can help clarify concepts as you learn.
+
+**Q: Do I need to complete all modules?**
+A: No. The Quick Start path (4 modules) gives you enough to start applying WDS immediately.
+
+**Q: Can I teach this to my team?**
+A: Yes! WDS is open-source and free. Share it with your entire team.
+
+**Q: How is this different from traditional design documentation?**
+A: Traditional docs describe WHAT. WDS captures WHY + WHAT + WHAT NOT TO DO. This makes it AI-ready and preserves your design intent.
+
+---
+
+## Getting Help
+
+### During the Course
+
+**While learning:**
+
+- Each module includes detailed examples
+- AI assistants can clarify concepts in real-time
+- Practice exercises with clear success criteria
+
+**After completion:**
+
+- GitHub Discussions for questions and sharing
+- Community showcase of WDS projects
+- Regular updates and new case studies
+
+**Contributing:**
+
+- WDS is open-source and welcomes contributions
+- Share your case studies and learnings
+- Help improve the course for future designers
+
+---
+
+## Support & Community
+
+### Resources
+
+**Documentation:**
+
+- Full course materials in markdown
+- NotebookLM integration for audio/video learning
+- Workshop materials for team training
+
+**Community:**
+
+- GitHub Discussions for Q&A
+- Project showcase and feedback
+- Regular updates and improvements
+
+**Open Source:**
+
+- Free to use and share
+- Contributions welcome
+- Help shape the future of WDS
+
+---
+
+## Ready to Start?
+
+You have everything you need:
+
+- ✅ The skills (design thinking)
+- ✅ The tools (paper + AI)
+- ✅ The time (10 hours)
+- ✅ The motivation (staying indispensable)
+
+**Next step:** Start learning!
+
+**[Start Module 01: Why WDS Matters →](../module-01-why-wds-matters/module-01-overview.md)**
+
+Or review the full course structure:
+
+**[← Back to Course Overview](../00-course-overview.md)**
+
+---
+
+[← Back to Learning Paths](02-learning-paths.md) | [Start Learning →](../module-01-why-wds-matters/module-01-overview.md)