4.4 KiB
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
Learn how to be indispensable in the AI era
Phase 1: Project Brief
Chapter 1.1: Create Project Brief
Define vision, goals, stakeholders, and constraints
Phase 2: Trigger Mapping
Chapter 2.1: Identify Target Groups
WHO are your users and how to prioritize them
Chapter 2.2: Map Triggers & Outcomes
WHAT triggers needs and WHY your business exists
Chapter 2.3: Prioritize Features
Which features serve your top triggers
Phase 3: Platform Requirements
Chapter 3.1: Platform Requirements
Technical constraints, integrations, infrastructure
Chapter 3.2: Functional Requirements
What the system must do
Phase 4: Conceptual Design
Chapter 4.1: Initialize Scenario
The 5 questions that define your design journey
Chapter 4.2: Sketch Interfaces
Drawing pages with AI guidance
Chapter 4.3: Analyze with AI
Upload sketches and have strategic conversations
Chapter 4.4: Decompose Components
Break pages into modular architecture
Chapter 4.5: Why-Based Specifications
Document WHAT + WHY + WHAT NOT TO DO
Chapter 4.6: Validate Specifications
Review completeness and test logic
Phase 5: Design System
Chapter 5.1: Extract Design Tokens
Colors, typography, spacing from your specs
Chapter 5.2: Component Library
Reusable patterns across scenarios
Phase 6: Development Integration
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:
- Workflows Guide - Reference documentation
- Quick Start - Try WDS with agent
- Community - Get help and share
Start Learning
Begin with Chapter 0: Why This Matters →