# WDS-BMad Tutorial

**Complete training from project brief to AI-ready specifications**

---

## About This Tutorial

This tutorial teaches the complete WDS workflow through **16 chapters**.

Each chapter contains:
- **Inspiration** - Why this step matters, the goal
- **Teaching** - How to do it with confidence
- **Practice** - Apply it to your own project

**Format:**
- Read as documentation
- Generate videos with NotebookLM
- Use in workshops

**Time:** ~10 hours total (40 min per chapter)

---

## Tutorial Chapters

### Foundation

#### [Chapter 0: Why This Matters](chapter-00-why-this-matters/)
Learn how to be indispensable in the AI era

---

### Phase 1: Project Brief

#### [Chapter 1.1: Create Project Brief](chapter-1.1-project-brief/)
Define vision, goals, stakeholders, and constraints

---

### Phase 2: Trigger Mapping

#### [Chapter 2.1: Identify Target Groups](chapter-2.1-identify-target-groups/)
WHO are your users and how to prioritize them

#### [Chapter 2.2: Map Triggers & Outcomes](chapter-2.2-map-triggers-outcomes/)
WHAT triggers needs and WHY your business exists

#### [Chapter 2.3: Prioritize Features](chapter-2.3-prioritize-features/)
Which features serve your top triggers

---

### Phase 3: Platform Requirements

#### [Chapter 3.1: Platform Requirements](chapter-3.1-platform-requirements/)
Technical constraints, integrations, infrastructure

#### [Chapter 3.2: Functional Requirements](chapter-3.2-functional-requirements/)
What the system must do

---

### Phase 4: Conceptual Design

#### [Chapter 4.1: Initialize Scenario](chapter-4.1-initialize-scenario/)
The 5 questions that define your design journey

#### [Chapter 4.2: Sketch Interfaces](chapter-4.2-sketch-interfaces/)
Drawing pages with AI guidance

#### [Chapter 4.3: Analyze with AI](chapter-4.3-analyze-with-ai/)
Upload sketches and have strategic conversations

#### [Chapter 4.4: Decompose Components](chapter-4.4-decompose-components/)
Break pages into modular architecture

#### [Chapter 4.5: Why-Based Specifications](chapter-4.5-why-based-specs/)
Document WHAT + WHY + WHAT NOT TO DO

#### [Chapter 4.6: Validate Specifications](chapter-4.6-validate-specifications/)
Review completeness and test logic

---

### Phase 5: Design System

#### [Chapter 5.1: Extract Design Tokens](chapter-5.1-extract-design-tokens/)
Colors, typography, spacing from your specs

#### [Chapter 5.2: Component Library](chapter-5.2-component-library/)
Reusable patterns across scenarios

---

### Phase 6: Development Integration

#### [Chapter 6.1: UI Roadmap](chapter-6.1-ui-roadmap/)
Development priorities and handoff

---

## How to Use This Tutorial

### Complete Workflow (Recommended)
Work through all 16 chapters sequentially with your own project:
```
Chapters 1-16 → Complete design from brief to handoff
Time: ~10 hours (spread over days/weeks)
Result: Fully specified project ready for development
```

### Quick Start (Core Concepts)
Focus on the essential chapters:
```
Ch 0: Why This Matters
Ch 2.2: Map Triggers & Outcomes
Ch 4.1: Initialize Scenario
Ch 4.5: Why-Based Specifications
Time: ~3 hours
Result: Understanding of core WDS philosophy
```

### Phase-Specific Learning
Jump to the phase you need:
```
Phase 2 (Ch 2.1-2.3): Trigger Mapping
Phase 4 (Ch 4.1-4.6): Conceptual Design
Phase 5 (Ch 5.1-5.2): Design System
```

---

## NotebookLM Integration

Each chapter has a matching script in `/notebooklm-scripts/`:
- Feed chapter scripts to NotebookLM
- Generate audio podcasts
- Generate video presentations
- Create study guides

**All scripts match chapter numbers for easy reference.**

---

## Chapter Structure

Every chapter follows the same pattern:

**1. Inspiration (10 min)**
- Why this step matters
- The goal you're working toward
- Real-world impact

**2. Teaching (20 min)**
- How to do it with confidence
- AI support at each step
- Dog Week example walkthrough

**3. Practice (10 min)**
- Apply to your own project
- Step-by-step instructions
- Success criteria

---

## After the Tutorial

Once you've completed chapters:

1. **[Workflows Guide](../WDS-WORKFLOWS-GUIDE.md)** - Reference documentation
2. **[Quick Start](../getting-started/quick-start.md)** - Try WDS with agent
3. **[Community](https://discord.gg/whiteport)** - Get help and share

---

## Start Learning

**[Begin with Chapter 0: Why This Matters →](chapter-00-why-this-matters/)**

---

[← Back to Getting Started](../getting-started/where-to-go-next.md)