8.0 KiB
WDS Documentation
Complete documentation for Whiteport Design Studio - a design-first methodology for creating software that people love.
🚀 Getting Started
New to WDS? Start here:
- About WDS - What WDS is and why it exists (5 min)
- Installation - Set up WDS in your project (5 min)
- Quick Start - Your first 5 minutes with WDS
- Where to Go Next - Choose your learning path
Quick Path: Install → Quick Start → Choose your path
📖 The WDS Method
What WDS is: A design-focused methodology that can be done with pen & paper, design tools, or with WDS agents.
- WDS Method Overview - Complete methodology guide
- Phase 1: Product Exploration - Strategic foundation
- Phase 2: Trigger Mapping - User psychology & business goals
- Phase 3: PRD Platform - Technical foundation
- Phase 4: UX Design - Scenarios & specifications
- Phase 5: Design System - Component library (optional)
- Phase 6: PRD Finalization - PRD finalization & handoff
These guides are tool-agnostic - explaining the methodology regardless of how you apply it.
🧠 Strategic Design Models
Foundational frameworks from thought leaders that inform WDS methodology.
- Models Guide - Introduction to strategic frameworks
- Customer Awareness Cycle - Eugene Schwartz (meet users where they are)
- Impact/Effect Mapping - Mijo Balic, Ingrid Domingues, Gojko Adzic (strategic connections)
- Golden Circle - Simon Sinek (start with WHY)
- Action Mapping - Cathy Moore (focus on what people DO)
- Kathy Sierra Badass Users - Kathy Sierra (make users awesome)
- Value Trigger Chain - Whiteport method (lightweight strategic context)
These are external frameworks with full attribution to original creators. Our methods build on these giants' shoulders.
🎓 Learn WDS
How to use WDS with AI agents: Step-by-step course using WDS agents + Cursor/Windsurf.
- Complete WDS Course - Sequential learning path
- Course Overview - What you'll learn
- Module 01: Why WDS Matters - The problem & solution
- Module 02: Installation & Setup - Get WDS running
- Module 03: Alignment & Signoff - Stakeholder alignment
- Module 04: Product Brief - Create strategic foundation
- Module 05: Trigger Mapping - Map user psychology
- Module 06+ - Continue through all phases
This course is WDS-specific - teaching you to use Saga, Freya, and Idunn agents.
📋 Deliverables
What you create with WDS: Specifications for each deliverable.
- Product Brief - Strategic vision & positioning
- Trigger Map - User psychology & business goals
- Platform PRD - Technical requirements
- Page Specifications - Detailed page specs
- Design System - Component library
- Design Delivery PRD - Complete handoff package
- Project Pitch - External presentations
- Service Agreement - Client contracts
These specs are universal - defining structure regardless of how you create them.
🎨 Examples
See WDS in action: Real projects showing complete WDS workflows and documentation.
- Examples Overview - Browse all examples with descriptions
- WDS Presentation - Marketing landing page project
- Product brief, trigger map, scenarios
- Desktop concept sketches
- Benefits-first content strategy
- WDS v6 Conversion - Meta example using WDS to build WDS
- Complete session logs with context preservation
- Strategic framework development (CAC, Golden Circle, Kathy Sierra, Action Mapping)
- Long-term project management patterns
- Agent collaboration workflows
These are real projects - not sanitized demos. Copy patterns, adapt structure, learn from decisions.
🤖 Agent Activation
Using WDS agents: Quick activation guides for Saga, Freya, and Idunn.
- Agent Launchers - Quick reference
- Saga WDS Analyst - Business analysis
- Freya WDS Designer - UX design
- Idunn WDS PM - Product management
- Mimir Orchestrator - Workflow coordination
📚 Reference
Additional documentation:
- Workflows Guide - Complete workflow reference
- Agent Activation Flow - How agents initialize
🎯 Choose Your Path
I need to...
Understand the methodology (tool-agnostic)
→ Start with WDS Method Overview
→ Read phase guides as needed
Learn to use WDS with AI agents
→ Take the Complete WDS Course
→ Follow sequential modules
See what WDS creates
→ Browse Deliverables
→ Check Examples
Start using WDS now
→ Follow Getting Started
→ Activate an agent and go!
Reference specific information
→ Use Workflows Guide
→ Jump to relevant phase guide
💡 Documentation Structure
docs/
├── getting-started/ # Quick start guides (15 min total)
├── models/ # External strategic frameworks
├── method/ # Whiteport's methodology guides
├── learn-wds/ # WDS-specific course (agent-driven)
├── deliverables/ # Specifications for what you create
├── examples/ # Real project examples
└── README.md # This navigation hub
Four clear purposes:
- models/ → "What are the foundational frameworks?" (external, attributed)
- method/ → "How does WDS methodology work?" (Whiteport instruments)
- learn-wds/ → "How do I use WDS agents?" (WDS-specific)
- examples/ → "Show me a real project" (reference implementation)
🌐 External Resources
Community and Support
- Discord Community - Get help from the community
- GitHub Issues - Report bugs or request features
- YouTube Channel - Video tutorials
Additional Documentation
- BMad Method Documentation - Development workflows (BMM integrates with WDS)
- IDE Setup Guides - Configure your development environment
Ready to begin? → Start with Getting Started
Whiteport Design Studio - Providing a thinking partner to every designer on the planet