whiteport-design-studio 0.1.0 → 0.2.0

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

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

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

@@ -1,66 +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.
+# 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.