BMAD-METHOD/src/modules/wds/docs/README.md

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:

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.

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.

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.

This course is WDS-specific - teaching you to use Saga, Freya, and Idunn agents.


📋 Deliverables

What you create with WDS: Specifications for each deliverable.

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.


📚 Reference

Additional documentation:


🎯 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:

  1. models/ → "What are the foundational frameworks?" (external, attributed)
  2. method/ → "How does WDS methodology work?" (Whiteport instruments)
  3. learn-wds/ → "How do I use WDS agents?" (WDS-specific)
  4. examples/ → "Show me a real project" (reference implementation)

🌐 External Resources

Community and Support

Additional Documentation


Ready to begin?Start with Getting Started


Whiteport Design Studio - Providing a thinking partner to every designer on the planet