3.4 KiB

Raw Blame History

Module 02: Installation & Setup

Lesson 4: WDS Project Initialization

Install WDS and activate your first agent

What You'll Do

Install WDS via the CLI installer
Understand the folder structure
Activate an agent and start working

Time: 10-15 minutes

Step 1: Install WDS

Navigate to your project folder in the terminal:

cd ~/Projects/your-project-name  # Mac/Linux
cd C:\Projects\your-project-name # Windows

Run the installer:

npx whiteport-design-studio install

The installer will guide you through:

Project type — What kind of product you're designing
Experience level — Beginner, Intermediate, or Expert
IDE configuration — Sets up your AI IDE automatically

✅ Checkpoint: Installer completes, _wds/ folder appears in your project

Step 2: Understand the Structure

After installation, your project has:

your-project/
├── _wds/                    ← WDS system files
│   ├── agents/              ← Agent files (.md)
│   │   ├── saga-analyst.md
│   │   ├── freya-ux.md
│   │   └── idunn-pm.md
│   ├── workflows/           ← Phase workflows
│   ├── data/                ← Standards, frameworks
│   ├── gems/                ← Reusable prompt components
│   ├── templates/           ← Document templates
│   └── config.yaml          ← Your project configuration
├── _wds-learn/              ← Learning material (optional)
├── docs/                    ← Design output (created by agents)
│   ├── A-Product-Brief/
│   ├── B-Trigger-Map/
│   ├── C-UX-Scenarios/
│   ├── D-Design-System/
│   ├── E-PRD/
│   └── F-Agent-Dialogs/
└── .claude/instructions.md  ← IDE configuration

Key insight: _wds/ contains the methodology. docs/ is where your design work lives.

Step 3: Activate an Agent

WDS has three specialized agents:

Agent	What they do	When to use
Saga	Business & Product Analyst	Product Brief, Trigger Mapping
Freya	UX/UI Designer	Scenarios, UX Design, Visual Design
Idunn	Project Manager	Platform Requirements, Design System

Start with Saga

For a new project, start with Saga to create your Product Brief:

Tell your AI IDE:

Read and activate the agent in _wds/agents/saga-analyst.md

Saga will:

Introduce herself
Scan your project for existing WDS work
Guide you to the right starting point

✅ Checkpoint: Saga responds and welcomes you!

Troubleshooting

Issue: npx command not found → Install Node.js from https://nodejs.org Issue: Installer fails → Make sure you're in your project folder Issue: Agent file not found → Check _wds/agents/ folder exists

Congratulations!

You've completed Module 02: Installation & Setup!

What you accomplished:

✅ GitHub account & repository
✅ IDE installed
✅ Project cloned
✅ WDS installed
✅ Agent activated

You're ready to design with WDS!

What's Next?

Module 03: Alignment & Signoff
WDS Training Course
Ask Saga: "What should I do next?"

Part of Module 02: Installation & Setup ← Back to Module Overview

3.4 KiB Raw Blame History