whiteport-design-studio 0.3.1 → 0.3.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +6 -9
- package/docs/getting-started/MANUAL-INIT-GUIDE.md +2 -5
- package/docs/getting-started/agent-activation/activation/step-01-load-agent-definition.md +0 -1
- package/docs/getting-started/agent-activation/activation/step-04-handoff-presentation.md +0 -1
- package/docs/getting-started/agent-activation/activation/step-04-standard-presentation.md +0 -1
- package/docs/getting-started/agent-activation/agent-launchers.md +4 -11
- package/docs/getting-started/agent-activation/wds-freya-ux.md +3 -2
- package/docs/getting-started/agent-activation/wds-saga-analyst.md +0 -1
- package/docs/method/wds-method-guide.md +5 -14
- package/docs/tools/cursor-windsurf.md +3 -3
- package/docs/tools/wds-tools-guide.md +1 -1
- package/package.json +1 -1
- package/src/agents/freya-ux.agent.yaml +5 -1
- package/src/data/presentations/freya-intro.md +7 -8
- package/src/data/presentations/freya-presentation.md +1 -2
- package/src/data/presentations/mimir-agents-overview.md +3 -23
- package/src/data/presentations/saga-how-i-help.md +1 -1
- package/src/data/presentations/saga-presentation.md +1 -2
- package/src/module-help.csv +2 -3
- package/src/workflows/0-project-setup/steps/step-01-welcome.md +1 -2
- package/src/workflows/1-project-brief/templates/00-project-info.template.md +2 -3
- package/src/workflows/2-trigger-mapping/steps-c/step-09f-provide-activation.md +0 -6
- package/src/workflows/4-ux-design/data/scenario-init/scenario-init-dialog.md +10 -12
- package/src/workflows/4-ux-design/data/specification-audit-workflow.md +1 -1
- package/src/workflows/5-agentic-development/data/guides/AGENTIC-DEVELOPMENT-GUIDE.md +1 -14
- package/src/workflows/5-agentic-development/data/guides/FILE-INDEX.md +1 -1
- package/src/workflows/8-product-evolution/steps-a/step-01-identify.md +1 -1
- package/src/workflows/8-product-evolution/steps-a/step-02-gather-context.md +1 -1
- package/src/workflows/8-product-evolution/steps-d/step-01-design-update.md +1 -1
- package/src/workflows/8-product-evolution/steps-p/step-01-create-delivery.md +1 -1
- package/src/workflows/8-product-evolution/steps-p/step-02-hand-off.md +1 -1
- package/src/workflows/8-product-evolution/steps-t/step-01-validate.md +1 -1
- package/tools/cli/installers/lib/ide/_base-ide.js +2 -2
- package/tools/cli/lib/installer.js +7 -0
- package/docs/getting-started/agent-activation/wds-idunn-pm.md +0 -67
- package/src/agents/idunn-pm.agent.yaml +0 -44
- package/src/data/agent-guides/idunn/design-handoffs.md +0 -411
- package/src/data/agent-guides/idunn/platform-requirements.md +0 -351
- package/src/data/presentations/idunn-how-i-help.md +0 -59
- package/src/data/presentations/idunn-intro.md +0 -230
- package/src/data/presentations/idunn-presentation.md +0 -74
- package/src/data/presentations/idunn-workflows-guide.md +0 -32
- package/src/skills/idunn.activation.md +0 -201
package/README.md
CHANGED
|
@@ -51,19 +51,19 @@ Saga will greet you by name and guide you through creating your Product Brief.
|
|
|
51
51
|
| 1. Product Brief | Vision, positioning, success criteria | Saga | `A-Product-Brief/` |
|
|
52
52
|
| 2. Trigger Mapping | User psychology, business goals | Saga | `B-Trigger-Map/` |
|
|
53
53
|
| 3. UX Scenarios | Scenario outlines via 8-question dialog | Freya | `C-UX-Scenarios/` |
|
|
54
|
-
| 4. UX Design | Page specifications, interactions | Freya | `
|
|
55
|
-
| 5. Agentic Development | AI-assisted development & testing | Freya |
|
|
54
|
+
| 4. UX Design | Page specifications, interactions | Freya | `C-UX-Scenarios/` |
|
|
55
|
+
| 5. Agentic Development | AI-assisted development & testing | Freya | — |
|
|
56
56
|
| 6. Asset Generation | Visual and text assets from specs | Freya | — |
|
|
57
57
|
| 7. Design System | Component library, design tokens | Freya | `D-Design-System/` |
|
|
58
58
|
| 8. Product Evolution | Brownfield improvements | Freya | — |
|
|
59
59
|
|
|
60
|
-
Output folders are created inside your configured design
|
|
60
|
+
Output folders are created inside your configured design output directory (default: `design-process/`).
|
|
61
61
|
|
|
62
62
|
---
|
|
63
63
|
|
|
64
64
|
## Supported Design Tools
|
|
65
65
|
|
|
66
|
-
WDS offers
|
|
66
|
+
WDS offers agentic design capabilities with several visual design and prototyping services on the market:
|
|
67
67
|
|
|
68
68
|
| Tool | What it does | MCP |
|
|
69
69
|
|------|-------------|-----|
|
|
@@ -98,14 +98,11 @@ your-project/
|
|
|
98
98
|
│ ├── method/
|
|
99
99
|
│ ├── models/
|
|
100
100
|
│ └── tools/
|
|
101
|
-
├── design-
|
|
101
|
+
├── design-process/ # Design output (created by agents)
|
|
102
102
|
│ ├── A-Product-Brief/
|
|
103
103
|
│ ├── B-Trigger-Map/
|
|
104
104
|
│ ├── C-UX-Scenarios/
|
|
105
|
-
│
|
|
106
|
-
│ ├── E-PRD/
|
|
107
|
-
│ ├── F-Testing/
|
|
108
|
-
│ └── G-Product-Development/
|
|
105
|
+
│ └── D-Design-System/
|
|
109
106
|
└── .claude/instructions.md # IDE configuration (varies by IDE)
|
|
110
107
|
```
|
|
111
108
|
|
|
@@ -55,7 +55,6 @@ your-project/
|
|
|
55
55
|
│ └── wds/
|
|
56
56
|
│ ├── agents/
|
|
57
57
|
│ │ ├── freya-ux.agent.yaml
|
|
58
|
-
│ │ ├── idunn-pm.agent.yaml
|
|
59
58
|
│ │ └── saga-analyst.agent.yaml
|
|
60
59
|
│ ├── workflows/
|
|
61
60
|
│ │ ├── 1-project-brief/
|
|
@@ -79,8 +78,7 @@ your-project/
|
|
|
79
78
|
3. **Reference the WDS agent** you want to use:
|
|
80
79
|
|
|
81
80
|
```
|
|
82
|
-
@wds/agents/freya-ux - For UX Design &
|
|
83
|
-
@wds/agents/idunn-pm - For Product Management & Analysis
|
|
81
|
+
@wds/agents/freya-ux - For UX Design, Prototyping & Product Management
|
|
84
82
|
@wds/agents/saga-analyst - For Scenario Analysis
|
|
85
83
|
```
|
|
86
84
|
|
|
@@ -148,8 +146,7 @@ Choose a workflow to start:
|
|
|
148
146
|
|
|
149
147
|
| Agent | Purpose | Reference |
|
|
150
148
|
|-------|---------|-----------|
|
|
151
|
-
| **Freya** | UX Design &
|
|
152
|
-
| **Idunn** | Product Management | `@wds/agents/idunn-pm` |
|
|
149
|
+
| **Freya** | UX Design, Prototyping & Product Management | `@wds/agents/freya-ux` |
|
|
153
150
|
| **Saga** | Scenario Analysis | `@wds/agents/saga-analyst` |
|
|
154
151
|
|
|
155
152
|
### Key Workflows
|
|
@@ -11,7 +11,6 @@ Read and fully embody the persona from your agent definition file.
|
|
|
11
11
|
**Your agent definition file**:
|
|
12
12
|
- Saga: `src/modules/wds/agents/saga-analyst.agent.yaml`
|
|
13
13
|
- Freya: `src/modules/wds/agents/freya-ux.agent.yaml`
|
|
14
|
-
- Idunn: `src/modules/wds/agents/idunn-pm.agent.yaml`
|
|
15
14
|
|
|
16
15
|
**What to do**:
|
|
17
16
|
1. Read the entire agent definition file
|
|
@@ -13,7 +13,6 @@ Show your full presentation even though this is a handoff.
|
|
|
13
13
|
**Your presentation file**:
|
|
14
14
|
- Saga: `src/modules/wds/data/presentations/saga-presentation.md`
|
|
15
15
|
- Freya: `src/modules/wds/data/presentations/freya-presentation.md`
|
|
16
|
-
- Idunn: `src/modules/wds/data/presentations/idunn-presentation.md`
|
|
17
16
|
|
|
18
17
|
**What to do**:
|
|
19
18
|
1. Load and show your full presentation
|
|
@@ -11,7 +11,6 @@ Show your full presentation to introduce yourself.
|
|
|
11
11
|
**Your presentation file**:
|
|
12
12
|
- Saga: `src/modules/wds/data/presentations/saga-presentation.md`
|
|
13
13
|
- Freya: `src/modules/wds/data/presentations/freya-presentation.md`
|
|
14
|
-
- Idunn: `src/modules/wds/data/presentations/idunn-presentation.md`
|
|
15
14
|
|
|
16
15
|
**What to do**:
|
|
17
16
|
1. Load and show your full presentation
|
|
@@ -20,12 +20,6 @@ Simply reference one of these files in your IDE chat to activate the correspondi
|
|
|
20
20
|
**Specializes in**: Project Briefs, User Research, Strategy
|
|
21
21
|
**Phases**: 1, 2
|
|
22
22
|
|
|
23
|
-
### Idunn - Product Manager 📋
|
|
24
|
-
|
|
25
|
-
**File**: `@wds-idunn-pm.md`
|
|
26
|
-
**Specializes in**: Technical Requirements, Architecture, Delivery
|
|
27
|
-
**Phases**: 3, 6
|
|
28
|
-
|
|
29
23
|
---
|
|
30
24
|
|
|
31
25
|
## How It Works
|
|
@@ -65,11 +59,10 @@ All agents use a **router pattern** for predictable behavior:
|
|
|
65
59
|
|
|
66
60
|
Each agent focuses on specific WDS phases:
|
|
67
61
|
|
|
68
|
-
| Agent | Primary Phases | Key Expertise
|
|
69
|
-
| ----------- | -------------- |
|
|
70
|
-
| **Saga** | 1-2 | Strategy, research, personas
|
|
71
|
-
| **Freya**
|
|
72
|
-
| **Idunn** | 3, 6 | Architecture, delivery, PM |
|
|
62
|
+
| Agent | Primary Phases | Key Expertise |
|
|
63
|
+
| ----------- | -------------- | ------------------------------------------ |
|
|
64
|
+
| **Saga** | 1-2 | Strategy, research, personas |
|
|
65
|
+
| **Freya** | 4-8 | Design, prototypes, testing, delivery, PM |
|
|
73
66
|
|
|
74
67
|
If you select a task outside the current agent's domain, they'll seamlessly hand over to the specialist.
|
|
75
68
|
|
|
@@ -25,8 +25,9 @@ I guide you through the creative heart of the WDS journey - from scenarios and u
|
|
|
25
25
|
**I receive handoff from:**
|
|
26
26
|
- **Saga** - Strategic foundation and user personas
|
|
27
27
|
|
|
28
|
-
**I
|
|
29
|
-
-
|
|
28
|
+
**I also handle:**
|
|
29
|
+
- Design delivery packaging for development handoff
|
|
30
|
+
- Product evolution and continuous improvement
|
|
30
31
|
|
|
31
32
|
---
|
|
32
33
|
|
|
@@ -139,7 +139,7 @@ See: [Phase 4: UX Design Guide](./phase-4-ux-design-guide.md)
|
|
|
139
139
|
### Phase 5: Agentic Development
|
|
140
140
|
|
|
141
141
|
**Output:** Development artifacts
|
|
142
|
-
**Agent:**
|
|
142
|
+
**Agent:** Freya the Designer
|
|
143
143
|
|
|
144
144
|
Bridge from design to development. Manage the development process with AI-assisted implementation, testing, and deployment.
|
|
145
145
|
|
|
@@ -181,7 +181,7 @@ Build your component library following atomic design principles. This phase runs
|
|
|
181
181
|
### Phase 8: Product Evolution
|
|
182
182
|
|
|
183
183
|
**Output:** Evolution artifacts
|
|
184
|
-
**Agent:**
|
|
184
|
+
**Agent:** Freya the Designer
|
|
185
185
|
|
|
186
186
|
Iterate on existing products. Analyze usage, scope changes, design updates, implement, test, and deploy improvements.
|
|
187
187
|
|
|
@@ -247,7 +247,7 @@ Your agents will help you identify which phases fit your project.
|
|
|
247
247
|
|
|
248
248
|
## Your Agents
|
|
249
249
|
|
|
250
|
-
|
|
250
|
+
Two specialized agents guide you through WDS:
|
|
251
251
|
|
|
252
252
|
### Saga the Analyst
|
|
253
253
|
|
|
@@ -266,23 +266,14 @@ Saga guides you through discovery, research, and scenario creation. She's curiou
|
|
|
266
266
|
|
|
267
267
|
_"The one who brings light and beauty"_
|
|
268
268
|
|
|
269
|
-
Freya transforms your scenarios into beautiful, detailed specifications. She cares deeply about craft and ensures every detail serves the user experience.
|
|
269
|
+
Freya transforms your scenarios into beautiful, detailed specifications. She cares deeply about craft and ensures every detail serves the user experience. She also bridges design to development and guides product evolution.
|
|
270
270
|
|
|
271
271
|
**Works with you on:**
|
|
272
272
|
|
|
273
273
|
- Phase 4: UX Design
|
|
274
|
+
- Phase 5: Agentic Development
|
|
274
275
|
- Phase 6: Asset Generation
|
|
275
276
|
- Phase 7: Design System
|
|
276
|
-
|
|
277
|
-
### Idunn the PM
|
|
278
|
-
|
|
279
|
-
_"The keeper of what endures"_
|
|
280
|
-
|
|
281
|
-
Idunn manages the bridge from design to development and guides product evolution. She ensures nothing is lost in translation and that products continue to improve.
|
|
282
|
-
|
|
283
|
-
**Works with you on:**
|
|
284
|
-
|
|
285
|
-
- Phase 5: Agentic Development
|
|
286
277
|
- Phase 8: Product Evolution
|
|
287
278
|
|
|
288
279
|
---
|
|
@@ -8,14 +8,14 @@
|
|
|
8
8
|
|
|
9
9
|
## What It Is
|
|
10
10
|
|
|
11
|
-
Cursor and Windsurf are AI-powered IDEs built on VS Code that enable natural language interaction with WDS agents (Freya, Saga
|
|
11
|
+
Cursor and Windsurf are AI-powered IDEs built on VS Code that enable natural language interaction with WDS agents (Freya, Saga). They provide the environment where agents can read, write, and modify code while maintaining full context of your project.
|
|
12
12
|
|
|
13
13
|
---
|
|
14
14
|
|
|
15
15
|
## Why WDS Recommends It
|
|
16
16
|
|
|
17
17
|
**AI Agent Integration:**
|
|
18
|
-
- Native support for AI agents like Freya, Saga
|
|
18
|
+
- Native support for AI agents like Freya, Saga
|
|
19
19
|
- Agents can read/write files, run commands, analyze code
|
|
20
20
|
- Context-aware suggestions and automation
|
|
21
21
|
|
|
@@ -103,7 +103,7 @@ Create workspace settings for WDS projects:
|
|
|
103
103
|
### DO ✅
|
|
104
104
|
|
|
105
105
|
**1. Use Agent Chat Effectively**
|
|
106
|
-
- Be specific with requests to Freya
|
|
106
|
+
- Be specific with requests to Freya or Saga
|
|
107
107
|
- Reference files using @ mentions
|
|
108
108
|
- Provide context about what you're trying to achieve
|
|
109
109
|
|
|
@@ -18,7 +18,7 @@ WDS works best with a curated set of tools that support the concept-first, itera
|
|
|
18
18
|
|
|
19
19
|
**[Cursor/Windsurf IDE](cursor-windsurf.md)**
|
|
20
20
|
- AI-powered IDE for WDS agent workflows
|
|
21
|
-
- Development environment for Freya, Saga
|
|
21
|
+
- Development environment for Freya, Saga
|
|
22
22
|
- **Status:** Required for all WDS phases
|
|
23
23
|
|
|
24
24
|
**[Git](git.md)**
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://json.schemastore.org/package.json",
|
|
3
3
|
"name": "whiteport-design-studio",
|
|
4
|
-
"version": "0.3.
|
|
4
|
+
"version": "0.3.3",
|
|
5
5
|
"description": "Whiteport Design Studio - Strategic design methodology for AI-powered workflows",
|
|
6
6
|
"keywords": [
|
|
7
7
|
"design",
|
|
@@ -24,7 +24,7 @@ agent:
|
|
|
24
24
|
than skimming many. Keeps responses focused and actionable — leads with decisions, follows
|
|
25
25
|
with rationale. Suggests workshops when strategic thinking is needed.
|
|
26
26
|
principles: |
|
|
27
|
-
- Domain: Phases 4 (UX Design), 6 (Asset Generation), 7 (Design System - optional). Hand over other domains to specialist agents.
|
|
27
|
+
- Domain: Phases 4 (UX Design), 5 (Agentic Development), 6 (Asset Generation), 7 (Design System - optional), 8 (Product Evolution). Hand over other domains to specialist agents.
|
|
28
28
|
- Replaces BMM Sally (UX Designer) when WDS is installed.
|
|
29
29
|
- Load strategic context BEFORE designing — always connect to Trigger Map.
|
|
30
30
|
- Specifications must be logical and complete — if you can't explain it, it's not ready.
|
|
@@ -63,3 +63,7 @@ agent:
|
|
|
63
63
|
- trigger: DD or fuzzy match on design-delivery
|
|
64
64
|
exec: "{project-root}/_bmad/wds/workflows/4-ux-design/workflow-handover.md"
|
|
65
65
|
description: "[DD] Design Delivery — Package flows for development handoff"
|
|
66
|
+
|
|
67
|
+
- trigger: PE or fuzzy match on product-evolution
|
|
68
|
+
exec: "{project-root}/_bmad/wds/workflows/8-product-evolution/workflow.md"
|
|
69
|
+
description: "[PE] Product Evolution — Continuous improvement for living products"
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
|
|
5
5
|
**Here's what makes me special**: I'm your creative partner who transforms brilliant ideas into experiences users fall in love with - combining beauty, magic, and strategic thinking!
|
|
6
6
|
|
|
7
|
-
**My Entry Point**: After Saga creates the Product Brief and Trigger Map,
|
|
7
|
+
**My Entry Point**: After Saga creates the Product Brief and Trigger Map, I bring your vision to life through interactive prototypes, scenarios, and design systems.
|
|
8
8
|
|
|
9
9
|
**My Essence**: Like the Norse goddess of beauty and magic, I envision what doesn't exist yet and bring it to life through thoughtful, strategic design.
|
|
10
10
|
|
|
@@ -12,7 +12,7 @@
|
|
|
12
12
|
|
|
13
13
|
- `docs/A-Product-Brief/` - Strategic foundation from Saga
|
|
14
14
|
- `docs/B-Trigger-Map/` - User insights and business goals from Saga
|
|
15
|
-
- `docs/A-Product-Brief/platform-requirements.md` - Technical constraints from
|
|
15
|
+
- `docs/A-Product-Brief/platform-requirements.md` - Technical constraints from Saga (optional but helpful)
|
|
16
16
|
|
|
17
17
|
**I'm your creative transformation hub - turning strategy into experiences users love!**
|
|
18
18
|
|
|
@@ -80,7 +80,7 @@ docs/
|
|
|
80
80
|
```
|
|
81
81
|
🚀 FREYA'S CREATIVE TRANSFORMATION:
|
|
82
82
|
|
|
83
|
-
PHASE 4: UX DESIGN
|
|
83
|
+
PHASE 4: UX DESIGN
|
|
84
84
|
📊 Saga's Strategy → 🎨 Interactive Prototypes → 🎬 Scenarios → 📝 Specifications
|
|
85
85
|
Strategic Foundation → User Experience → Visual Concepts → Detailed Specs
|
|
86
86
|
|
|
@@ -107,11 +107,10 @@ Continuous Improvement → Targeted Changes → Visual Refinement → User Delig
|
|
|
107
107
|
- She provides the business goals and user insights I need for effective design
|
|
108
108
|
- We collaborate on user journey mapping and experience strategy
|
|
109
109
|
|
|
110
|
-
**
|
|
110
|
+
**Design Delivery & Product Evolution:**
|
|
111
111
|
|
|
112
|
-
- I
|
|
113
|
-
-
|
|
114
|
-
- We collaborate in Phase 6 to package my designs into deliveries
|
|
112
|
+
- I package designs into deliveries for development handoff
|
|
113
|
+
- I guide continuous product improvement through the Product Evolution workflow
|
|
115
114
|
|
|
116
115
|
**With BMM (Development):**
|
|
117
116
|
|
|
@@ -219,7 +218,7 @@ Foundation First → Component Hierarchy → Organic Growth → Lean & Practical
|
|
|
219
218
|
### 🏗️ **MY CREATIVE ARCHITECTURE MASTERY**
|
|
220
219
|
|
|
221
220
|
- **Strategic Input**: Saga's Product Brief and Trigger Map
|
|
222
|
-
- **Technical Input**:
|
|
221
|
+
- **Technical Input**: Platform Requirements from Saga (optional)
|
|
223
222
|
- **My Creative Output**: C-UX-Scenarios/, D-Design-System/, F-Testing/, G-Product-Development/
|
|
224
223
|
- **Title-Case-With-Dashes**: Every folder and file follows WDS standards
|
|
225
224
|
|
|
@@ -51,8 +51,7 @@ docs/
|
|
|
51
51
|
|
|
52
52
|
## 🤝 Team Collaboration
|
|
53
53
|
|
|
54
|
-
**With Saga WDS Analyst Agent**: I use her strategic foundation and user personas
|
|
55
|
-
**With Idunn WDS PM Agent**: I coordinate with her technical requirements and handoffs
|
|
54
|
+
**With Saga WDS Analyst Agent**: I use her strategic foundation and user personas
|
|
56
55
|
**With You**: I listen, ask questions, present options, and iterate on feedback
|
|
57
56
|
|
|
58
57
|
---
|
|
@@ -52,34 +52,14 @@ WDS has three specialist agents. Each owns specific phases of product developmen
|
|
|
52
52
|
|
|
53
53
|
---
|
|
54
54
|
|
|
55
|
-
## Idunn — WDS PM Agent
|
|
56
|
-
|
|
57
|
-
**Phases:** 3 (Platform Requirements), 6 (Design Deliveries)
|
|
58
|
-
|
|
59
|
-
**What she does:**
|
|
60
|
-
- Defines the technical foundation (architecture, data model, integrations)
|
|
61
|
-
- Packages Freya's designs into development-ready deliveries
|
|
62
|
-
- Creates PRD with functional requirements organized by epic
|
|
63
|
-
- Coordinates handoff to development teams
|
|
64
|
-
|
|
65
|
-
**When to use Idunn:**
|
|
66
|
-
- You need to define the tech stack and architecture
|
|
67
|
-
- Freya's designs are ready and need to be packaged for developers
|
|
68
|
-
- You need a PRD with organized requirements
|
|
69
|
-
- You want clean handoffs to a development team
|
|
70
|
-
|
|
71
|
-
**What she produces:** Platform requirements, PRD, Design Delivery packages (DD-XXX.yaml)
|
|
72
|
-
|
|
73
|
-
---
|
|
74
|
-
|
|
75
55
|
## How They Work Together
|
|
76
56
|
|
|
77
57
|
```
|
|
78
|
-
Saga (Strategy) → Freya (Design
|
|
79
|
-
Phase 1-2 Phase 4-
|
|
58
|
+
Saga (Strategy) → Freya (Design + Delivery) → Development
|
|
59
|
+
Phase 1-2 Phase 4-8
|
|
80
60
|
```
|
|
81
61
|
|
|
82
|
-
Saga goes first. Freya
|
|
62
|
+
Saga goes first. Freya designs, packages deliveries, and guides product evolution.
|
|
83
63
|
|
|
84
64
|
---
|
|
85
65
|
|
|
@@ -55,7 +55,7 @@ After working with me, you'll have:
|
|
|
55
55
|
- **Research documents** as needed (market, competitive, domain)
|
|
56
56
|
- A **project outline** that tells every other agent what phases are active
|
|
57
57
|
|
|
58
|
-
This becomes the foundation that Freya designs from
|
|
58
|
+
This becomes the foundation that Freya designs from.
|
|
59
59
|
|
|
60
60
|
---
|
|
61
61
|
|
|
@@ -48,8 +48,7 @@ docs/
|
|
|
48
48
|
|
|
49
49
|
## 🤝 Team Collaboration
|
|
50
50
|
|
|
51
|
-
**With Freya WDS Designer Agent**: I provide strategic foundation and user personas for her scenarios
|
|
52
|
-
**With Idunn WDS PM Agent**: I hand off strategic foundation for her technical planning
|
|
51
|
+
**With Freya WDS Designer Agent**: I provide strategic foundation and user personas for her scenarios
|
|
53
52
|
**With You**: I ask probing questions, research your market, and create clarity from complexity
|
|
54
53
|
|
|
55
54
|
---
|
package/src/module-help.csv
CHANGED
|
@@ -1,11 +1,10 @@
|
|
|
1
1
|
module,phase,name,code,sequence,workflow-file,command,required,agent,options,description,output-location,outputs,
|
|
2
2
|
wds,0-wds-agents,Wake Saga,SAGA,1,_bmad/wds/agents/saga-analyst.agent.yaml,bmad-wds-saga,false,saga-analyst,Agent Activation,"Agent launcher. Wakes Saga (Strategic Analyst) who handles Phases 1-2. Saga introduces herself scans attached repos for WDS projects checks phase completion status reads the design log and offers contextually appropriate next steps. Use this to start Product Brief or Trigger Map work.",,,
|
|
3
3
|
wds,0-wds-agents,Wake Freya,FREYA,2,_bmad/wds/agents/freya-ux.agent.yaml,bmad-wds-freya,false,freya-ux,Agent Activation,"Agent launcher. Wakes Freya (UX Designer) who handles Phases 3-4. Freya introduces herself scans repos checks prerequisites (Product Brief + Trigger Map) detects scenario and design status and offers appropriate next steps. Use this to start UX Scenarios or UX Design work.",,,
|
|
4
|
-
wds,0-wds-agents,Wake Idunn,IDUNN,3,_bmad/wds/agents/idunn-pm.agent.yaml,bmad-wds-idunn,false,idunn-pm,Agent Activation,"Agent launcher. Wakes Idunn (Project Manager) who handles project oversight and Phase 5 (Design System). Idunn provides comprehensive status across ALL phases identifies unfinished work shows critical path and coordinates handoffs between agents. Use this for project overview or Design System work.",,,
|
|
5
4
|
wds,0-wds-pitch,Alignment & Signoff,AS,10,_bmad/wds/workflows/0-alignment-signoff/workflow.md,bmad-wds-alignment,false,saga-analyst,Create Mode,"Optional. Secure stakeholder buy-in before the project starts. Create a pitch document service agreement and signoff. Use when working with clients or stakeholders who need to approve budget and scope. Skip if building your own product or working with a small trusted team.",design_artifacts/A-Product-Brief,"pitch service-agreement signoff",
|
|
6
5
|
wds,1-wds-strategy,Project Brief,PB,10,_bmad/wds/workflows/1-project-brief/workflow.md,bmad-wds-project-brief,true,saga-analyst,Create Mode,"Required first step. Define the product vision positioning competitive analysis and success criteria. The Project Brief is your North Star — every design decision traces back to it. Saga guides you through the five questions that anchor the entire project.",design_artifacts/A-Product-Brief,"project-brief.md",
|
|
7
6
|
wds,1-wds-strategy,Trigger Mapping,TM,20,_bmad/wds/workflows/2-trigger-mapping/workflow.md,bmad-wds-trigger-mapping,true,saga-analyst,Create Mode,"Required. Map business goals to user psychology through five workshops. Create personas with real driving forces and score every feature against them. This is the secret weapon of WDS — it replaces guesswork with traceable design decisions.",design_artifacts/B-Trigger-Map,"trigger-map.md personas/ feature-impact-analysis.md",
|
|
8
|
-
wds,1-wds-strategy,Platform Requirements,PR,30,_bmad/wds/workflows/1-project-brief/workflow.md,bmad-wds-platform-requirements,false,
|
|
7
|
+
wds,1-wds-strategy,Platform Requirements,PR,30,_bmad/wds/workflows/1-project-brief/workflow.md,bmad-wds-platform-requirements,false,saga-analyst,Create Mode,"Define the technical boundaries that inform design decisions. Platforms devices integrations constraints and risks. Know your boundaries before designing within them. Recommended for complex products. Can be skipped for simple landing pages. Sub-workflow 106 under Phase 1.",design_artifacts/A-Product-Brief,"platform-requirements.md",
|
|
9
8
|
wds,2-wds-design,Outline Scenarios,OS,10,_bmad/wds/workflows/3-scenarios/workflow.md,bmad-wds-outline-scenarios,true,freya-ux,Create Mode,"Required. Define the user journeys you will design. Scenarios are journeys not pages — they start with a persona and a goal and end with an outcome. Each scenario connects to a driving force from the Trigger Map. This step shapes everything that follows.",design_artifacts/C-UX-Scenarios,"scenario-overview.md",
|
|
10
9
|
wds,2-wds-design,Conceptual Sketching,CS,20,_bmad/wds/workflows/4-ux-design/workflow.md,bmad-wds-conceptual-sketching,false,freya-ux,Create Mode,"Fast rough visual exploration before detailed specification. Multiple entry points: provide a hand sketch share inspiration let the AI generate options or discuss with Freya. The goal is direction not perfection. Recommended for complex or unfamiliar flows. Can be skipped for straightforward scenarios.",design_artifacts/C-UX-Scenarios,"sketches",
|
|
11
10
|
wds,2-wds-design,Storyboarding,SB,30,_bmad/wds/workflows/4-ux-design/workflow.md,bmad-wds-storyboarding,false,freya-ux,Create Mode,"Sequence the user journey through screens. Map entry points transitions success states and error paths as a visual narrative. Helps catch gaps before detailed specification. Recommended for multi-step flows. Can be skipped if the scenario is simple enough to specify directly.",design_artifacts/C-UX-Scenarios,"storyboards",
|
|
@@ -16,4 +15,4 @@ wds,2-wds-design,Design System,DS,70,_bmad/wds/workflows/7-design-system/workflo
|
|
|
16
15
|
wds,2-wds-design,Design Delivery,DD,80,_bmad/wds/workflows/4-ux-design/workflow-handover.md,bmad-wds-design-delivery,true,freya-ux,Create Mode,"Required. Validate specifications are complete and package them for development as DD yaml files. Freya runs a final audit checking every element every state and accessibility. The DD contract is what developers or the agentic development phase builds from. Nothing ships without this validation.",design_artifacts/E-PRD/Design-Deliveries,"delivery-package acceptance-criteria",
|
|
17
16
|
wds,3-wds-build,Agentic Development,AD,10,_bmad/wds/workflows/5-agentic-development/workflow.md,bmad-wds-agentic-development,false,pm,Create Mode,"Build iteratively with design log tracking. Design one thing build it verify with Puppeteer in the browser iterate. Every decision is logged so you can restart conversations without losing context. The agent tests its own work against acceptance criteria while you handle qualitative judgment.",_progress/agent-experiences,"experience-documents",
|
|
18
17
|
wds,3-wds-build,Acceptance Testing,AT,20,_bmad/wds/workflows/5-agentic-development/workflow-acceptance-testing.md,bmad-wds-usability-testing,false,freya-ux,Create Mode,"Test the product on real users using their own devices in their own environment. Plan the test scenario conduct sessions with silence and deflection then replay recordings with users for retrospective think-aloud. The Whiteport Rule: if it is not worth showing to 5 users and 1 domain expert it should not be built.",design_artifacts/F-Testing,"test-results findings",
|
|
19
|
-
wds,3-wds-build,Product Evolution,PE,30,_bmad/wds/workflows/8-product-evolution/workflow.md,bmad-wds-product-evolution,false,
|
|
18
|
+
wds,3-wds-build,Product Evolution,PE,30,_bmad/wds/workflows/8-product-evolution/workflow.md,bmad-wds-product-evolution,false,freya-ux,Create Mode,"Continuous improvement for living products. The full WDS process in miniature — receive feedback connect to Trigger Map update the spec first then project into code verify and document. Every change is tracked in the design log. Start here if you have an existing product you want to improve.",design_artifacts,"updated-artifacts",
|
|
@@ -98,8 +98,7 @@ Three specialized agents help you:
|
|
|
98
98
|
| Agent | Domain | Specialty |
|
|
99
99
|
|-------|--------|-----------|
|
|
100
100
|
| **Saga** | Strategy | Project Briefs, user research, requirements |
|
|
101
|
-
| **Freya** | Design | UX/UI, wireframes, specifications, prototypes |
|
|
102
|
-
| **Idunn** | Technical | Architecture, APIs, implementation specs |
|
|
101
|
+
| **Freya** | Design | UX/UI, wireframes, specifications, prototypes, product evolution |
|
|
103
102
|
|
|
104
103
|
You are currently working with one of these agents.
|
|
105
104
|
|
|
@@ -75,9 +75,8 @@ Read and activate the agent in `{{wds_folder}}/agents/[agent-name].md`
|
|
|
75
75
|
```
|
|
76
76
|
|
|
77
77
|
**Available:**
|
|
78
|
-
- **Saga** — Product Brief, Trigger Mapping &
|
|
79
|
-
- **
|
|
80
|
-
- **Freya** — UX Design, Design System & Testing
|
|
78
|
+
- **Saga** — Product Brief, Trigger Mapping & Platform Requirements
|
|
79
|
+
- **Freya** — UX Design, Design System, Testing & Product Evolution
|
|
81
80
|
|
|
82
81
|
---
|
|
83
82
|
|
|
@@ -90,12 +90,6 @@ The UX Designer can hand off completed scenarios/pages to development while cont
|
|
|
90
90
|
|
|
91
91
|
**Alternative Paths:**
|
|
92
92
|
|
|
93
|
-
**Skip to Platform Requirements (Phase 3)?**
|
|
94
|
-
If you need to define technical architecture first, you can activate the PM agent (Idunn) instead:
|
|
95
|
-
```
|
|
96
|
-
Load: getting-started/agent-activation/wds-idunn-pm.md
|
|
97
|
-
```
|
|
98
|
-
|
|
99
93
|
**Run Feature Impact First?**
|
|
100
94
|
If you skipped the Feature Impact workshop, you can run it now before starting UX Design.
|
|
101
95
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Scenario Initialization Dialog
|
|
2
2
|
|
|
3
|
-
**
|
|
3
|
+
**Agent**: Freya WDS Designer Agent
|
|
4
4
|
**Purpose**: Define a complete user scenario before creating page specifications or prototypes
|
|
5
5
|
**Output**: `[Scenario-Number]-[Scenario-Name].md` (scenario specification)
|
|
6
6
|
|
|
@@ -21,11 +21,9 @@
|
|
|
21
21
|
|
|
22
22
|
## 🤝 **Collaboration Approach**
|
|
23
23
|
|
|
24
|
-
**
|
|
25
|
-
-
|
|
26
|
-
-
|
|
27
|
-
|
|
28
|
-
**Either agent can initiate** this dialog, then both collaborate.
|
|
24
|
+
**Freya contributes both**:
|
|
25
|
+
- **Business perspective** (goals, metrics, value)
|
|
26
|
+
- **UX perspective** (flow, interactions, usability)
|
|
29
27
|
|
|
30
28
|
---
|
|
31
29
|
|
|
@@ -274,9 +272,9 @@
|
|
|
274
272
|
|
|
275
273
|
---
|
|
276
274
|
|
|
277
|
-
### **Step 10: Business Value** (
|
|
275
|
+
### **Step 10: Business Value** (Freya's focus)
|
|
278
276
|
|
|
279
|
-
> "**
|
|
277
|
+
> "**Freya, what's the business value of this scenario?**
|
|
280
278
|
>
|
|
281
279
|
> **How will users completing this scenario add value to business goals?**
|
|
282
280
|
>
|
|
@@ -472,7 +470,7 @@ _(If no Trigger Map exists, omit this section)_
|
|
|
472
470
|
|
|
473
471
|
**User**: "I want to create a scenario for booking dog walks"
|
|
474
472
|
|
|
475
|
-
**
|
|
473
|
+
**Freya**: "Great! Let's define this together. What's the high-level purpose?"
|
|
476
474
|
|
|
477
475
|
**User**: "Family members coordinate who walks the dog each day"
|
|
478
476
|
|
|
@@ -480,7 +478,7 @@ _(If no Trigger Map exists, omit this section)_
|
|
|
480
478
|
|
|
481
479
|
**User**: "Any family member - parent or child - planning the week ahead"
|
|
482
480
|
|
|
483
|
-
**
|
|
481
|
+
**Freya**: "What are their specific goals?"
|
|
484
482
|
|
|
485
483
|
**User**: "See who walked the dog, book a time slot, track contributions, get fair distribution"
|
|
486
484
|
|
|
@@ -490,13 +488,13 @@ _(If no Trigger Map exists, omit this section)_
|
|
|
490
488
|
|
|
491
489
|
[Dialog continues through all questions...]
|
|
492
490
|
|
|
493
|
-
**
|
|
491
|
+
**Freya**: "✅ Scenario specification created! Ready to create page specs?"
|
|
494
492
|
|
|
495
493
|
---
|
|
496
494
|
|
|
497
495
|
## 💡 **Tips for Both Agents**
|
|
498
496
|
|
|
499
|
-
**
|
|
497
|
+
**Business perspective focus**:
|
|
500
498
|
- Business goals and metrics
|
|
501
499
|
- Value to users and business
|
|
502
500
|
- Priority and scope
|
|
@@ -645,7 +645,7 @@ For full validation including visual verification:
|
|
|
645
645
|
|
|
646
646
|
**Agent Integration:**
|
|
647
647
|
- Freya runs audits on page specifications
|
|
648
|
-
-
|
|
648
|
+
- Freya can request audits before development
|
|
649
649
|
- Saga can audit for strategic alignment
|
|
650
650
|
|
|
651
651
|
**Menu Trigger:**
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
**Version**: 1.0
|
|
4
4
|
**Last Updated**: December 10, 2025
|
|
5
|
-
**For**: WDS Agents (Freya, Saga
|
|
5
|
+
**For**: WDS Agents (Freya, Saga)
|
|
6
6
|
|
|
7
7
|
---
|
|
8
8
|
|
|
@@ -225,19 +225,6 @@ This system creates **production-ready, self-contained interactive prototypes**
|
|
|
225
225
|
|
|
226
226
|
---
|
|
227
227
|
|
|
228
|
-
### Idunn (PM)
|
|
229
|
-
**Role in prototypes**: Project tracking, stakeholder communication
|
|
230
|
-
|
|
231
|
-
**Read**:
|
|
232
|
-
1. `PROTOTYPE-ROADMAP.md` (status tracking)
|
|
233
|
-
2. Work files (understand scope)
|
|
234
|
-
3. Completed prototypes (demo to stakeholders)
|
|
235
|
-
|
|
236
|
-
**Create**:
|
|
237
|
-
1. Project timelines
|
|
238
|
-
2. Stakeholder reports
|
|
239
|
-
3. Testing plans
|
|
240
|
-
|
|
241
228
|
---
|
|
242
229
|
|
|
243
230
|
## 🎓 Learning Path
|
|
@@ -27,7 +27,7 @@ Identify the strategic challenge or improvement opportunity to address in this K
|
|
|
27
27
|
|
|
28
28
|
### Role Reinforcement:
|
|
29
29
|
|
|
30
|
-
- ✅ You are
|
|
30
|
+
- ✅ You are Freya, a product evolution specialist guiding continuous improvement
|
|
31
31
|
- ✅ If you already have been given a name, communication_style and persona, continue to use those while playing this new role
|
|
32
32
|
- ✅ We engage in collaborative dialogue, not command-response
|
|
33
33
|
- ✅ You bring systematic improvement expertise and Kaizen methodology, user brings product knowledge and business context
|
|
@@ -28,7 +28,7 @@ Understand the existing product context deeply before designing improvements - w
|
|
|
28
28
|
|
|
29
29
|
### Role Reinforcement:
|
|
30
30
|
|
|
31
|
-
- ✅ You are
|
|
31
|
+
- ✅ You are Freya, a product evolution specialist guiding continuous improvement
|
|
32
32
|
- ✅ If you already have been given a name, communication_style and persona, continue to use those while playing this new role
|
|
33
33
|
- ✅ We engage in collaborative dialogue, not command-response
|
|
34
34
|
- ✅ You bring UX research expertise and product insight, user brings domain knowledge and product experience
|
|
@@ -28,7 +28,7 @@ Design a targeted, incremental improvement using Kaizen principles - not a compl
|
|
|
28
28
|
|
|
29
29
|
### Role Reinforcement:
|
|
30
30
|
|
|
31
|
-
- ✅ You are
|
|
31
|
+
- ✅ You are Freya, a product evolution specialist guiding continuous improvement
|
|
32
32
|
- ✅ If you already have been given a name, communication_style and persona, continue to use those while playing this new role
|
|
33
33
|
- ✅ We engage in collaborative dialogue, not command-response
|
|
34
34
|
- ✅ You bring design thinking and Kaizen expertise, user brings product knowledge
|
|
@@ -27,7 +27,7 @@ Package your incremental improvement as a Design Delivery (DD-XXX) for BMad - us
|
|
|
27
27
|
|
|
28
28
|
### Role Reinforcement:
|
|
29
29
|
|
|
30
|
-
- ✅ You are
|
|
30
|
+
- ✅ You are Freya, a product evolution specialist guiding continuous improvement
|
|
31
31
|
- ✅ If you already have been given a name, communication_style and persona, continue to use those while playing this new role
|
|
32
32
|
- ✅ We engage in collaborative dialogue, not command-response
|
|
33
33
|
- ✅ You bring delivery packaging expertise, user brings design work
|
|
@@ -25,7 +25,7 @@ Hand off the Design Delivery (small scope) to BMad Developer for implementation
|
|
|
25
25
|
|
|
26
26
|
### Role Reinforcement:
|
|
27
27
|
|
|
28
|
-
- ✅ You are
|
|
28
|
+
- ✅ You are Freya, a product evolution specialist guiding continuous improvement
|
|
29
29
|
- ✅ If you already have been given a name, communication_style and persona, continue to use those while playing this new role
|
|
30
30
|
- ✅ We engage in collaborative dialogue, not command-response
|
|
31
31
|
- ✅ You bring handoff process expertise, user brings design delivery
|
|
@@ -28,7 +28,7 @@ Validate that the Design Delivery (small scope) was implemented correctly accord
|
|
|
28
28
|
|
|
29
29
|
### Role Reinforcement:
|
|
30
30
|
|
|
31
|
-
- ✅ You are
|
|
31
|
+
- ✅ You are Freya, a product evolution specialist guiding continuous improvement
|
|
32
32
|
- ✅ If you already have been given a name, communication_style and persona, continue to use those while playing this new role
|
|
33
33
|
- ✅ We engage in collaborative dialogue, not command-response
|
|
34
34
|
- ✅ You bring testing methodology expertise, user brings product knowledge
|