whiteport-design-studio 0.3.2 → 0.3.4

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.
Files changed (54) hide show
  1. package/README.md +6 -9
  2. package/docs/getting-started/MANUAL-INIT-GUIDE.md +2 -5
  3. package/docs/getting-started/agent-activation/activation/step-01-load-agent-definition.md +0 -1
  4. package/docs/getting-started/agent-activation/activation/step-04-handoff-presentation.md +0 -1
  5. package/docs/getting-started/agent-activation/activation/step-04-standard-presentation.md +0 -1
  6. package/docs/getting-started/agent-activation/agent-launchers.md +4 -11
  7. package/docs/getting-started/agent-activation/wds-freya-ux.md +3 -2
  8. package/docs/getting-started/agent-activation/wds-saga-analyst.md +0 -1
  9. package/docs/method/wds-method-guide.md +5 -14
  10. package/docs/tools/cursor-windsurf.md +3 -3
  11. package/docs/tools/wds-tools-guide.md +1 -1
  12. package/package.json +1 -1
  13. package/src/agents/freya-ux.agent.yaml +5 -1
  14. package/src/data/agent-guides/saga/working-with-existing-materials.md +187 -78
  15. package/src/data/presentations/freya-intro.md +7 -8
  16. package/src/data/presentations/freya-presentation.md +1 -2
  17. package/src/data/presentations/mimir-agents-overview.md +3 -23
  18. package/src/data/presentations/saga-how-i-help.md +1 -1
  19. package/src/data/presentations/saga-presentation.md +1 -2
  20. package/src/module-help.csv +2 -3
  21. package/src/workflows/0-project-setup/steps/step-01-welcome.md +1 -2
  22. package/src/workflows/1-project-brief/steps-c/step-01-init.md +26 -3
  23. package/src/workflows/1-project-brief/steps-c/step-02-vision.md +13 -0
  24. package/src/workflows/1-project-brief/steps-c/step-03-positioning.md +13 -0
  25. package/src/workflows/1-project-brief/steps-c/step-05-business-model.md +13 -0
  26. package/src/workflows/1-project-brief/steps-c/step-06-business-customers.md +13 -0
  27. package/src/workflows/1-project-brief/steps-c/step-07-target-users.md +13 -0
  28. package/src/workflows/1-project-brief/steps-c/step-07a-product-concept.md +13 -0
  29. package/src/workflows/1-project-brief/steps-c/step-08-success-criteria.md +13 -0
  30. package/src/workflows/1-project-brief/steps-c/step-09-competitive-landscape.md +13 -0
  31. package/src/workflows/1-project-brief/steps-c/step-10-constraints.md +13 -0
  32. package/src/workflows/1-project-brief/steps-c/step-10a-platform-strategy.md +13 -0
  33. package/src/workflows/1-project-brief/steps-c/step-11-tone-of-voice.md +13 -0
  34. package/src/workflows/1-project-brief/templates/00-project-info.template.md +2 -3
  35. package/src/workflows/2-trigger-mapping/steps-c/step-09f-provide-activation.md +0 -6
  36. package/src/workflows/4-ux-design/data/scenario-init/scenario-init-dialog.md +10 -12
  37. package/src/workflows/4-ux-design/data/specification-audit-workflow.md +1 -1
  38. package/src/workflows/5-agentic-development/data/guides/AGENTIC-DEVELOPMENT-GUIDE.md +1 -14
  39. package/src/workflows/5-agentic-development/data/guides/FILE-INDEX.md +1 -1
  40. package/src/workflows/8-product-evolution/steps-a/step-01-identify.md +1 -1
  41. package/src/workflows/8-product-evolution/steps-a/step-02-gather-context.md +1 -1
  42. package/src/workflows/8-product-evolution/steps-d/step-01-design-update.md +1 -1
  43. package/src/workflows/8-product-evolution/steps-p/step-01-create-delivery.md +1 -1
  44. package/src/workflows/8-product-evolution/steps-p/step-02-hand-off.md +1 -1
  45. package/src/workflows/8-product-evolution/steps-t/step-01-validate.md +1 -1
  46. package/docs/getting-started/agent-activation/wds-idunn-pm.md +0 -67
  47. package/src/agents/idunn-pm.agent.yaml +0 -44
  48. package/src/data/agent-guides/idunn/design-handoffs.md +0 -411
  49. package/src/data/agent-guides/idunn/platform-requirements.md +0 -351
  50. package/src/data/presentations/idunn-how-i-help.md +0 -59
  51. package/src/data/presentations/idunn-intro.md +0 -230
  52. package/src/data/presentations/idunn-presentation.md +0 -74
  53. package/src/data/presentations/idunn-workflows-guide.md +0 -32
  54. package/src/skills/idunn.activation.md +0 -201
@@ -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, and Idunn establishes the platform requirements, I bring your vision to life through interactive prototypes, scenarios, and design systems.
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 Idunn (optional but helpful)
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 (Parallel with Idunn's Platform Work)
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
- **With Idunn (PM):**
110
+ **Design Delivery & Product Evolution:**
111
111
 
112
- - I work in parallel with her during Phase 3-4 (she does platform, I do design)
113
- - She provides technical constraints from platform requirements
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**: Idunn's Platform Requirements (optional)
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) + Idunn (Platform) → Idunn (Handoff) → Development
79
- Phase 1-2 Phase 4-5 Phase 3 Phase 6
58
+ Saga (Strategy) → Freya (Design + Delivery) → Development
59
+ Phase 1-2 Phase 4-8
80
60
  ```
81
61
 
82
- Saga goes first. Freya and Idunn work in parallel. Idunn packages everything at the end.
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 and Idunn plans 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
  ---
@@ -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,idunn-pm,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",
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,idunn-pm,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",
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
 
@@ -56,9 +56,28 @@ Welcome the user and explain that this is their strategic foundation. This workf
56
56
  - Competitive landscape (what alternatives exist)
57
57
  - Constraints & context (real-world limitations)
58
58
 
59
- Set time expectations (30-60 minutes) and ask about any existing context that should be considered.
59
+ Set time expectations and ask about any existing context that should be considered.
60
60
 
61
- ### 2. Design Log Update
61
+ If the user provides or has provided existing materials (PRD, brief, research, website, guidelines), acknowledge them and tell the user you will analyze them before starting the strategic conversation.
62
+
63
+ ### 2. Material Analysis Phase (if materials exist)
64
+
65
+ **MANDATORY when `existing_materials.has_materials` is true or when the user provides documents during this step.**
66
+
67
+ Load and follow `src/data/agent-guides/saga/working-with-existing-materials.md` — specifically the **Material Analysis Phase** (Steps A through D).
68
+
69
+ This means:
70
+ 1. **Read** every provided document completely
71
+ 2. **Extract** information into categories (vision, positioning, users, business model, etc.)
72
+ 3. **Present** your findings ONE category at a time — quote the source, add your interpretation, ask the user to confirm/refine/reject each one
73
+ 4. **Identify gaps** — tell the user which topics are not covered in their materials
74
+ 5. **Plan the workflow** — tell the user which steps will be quick confirmations vs. full conversations
75
+
76
+ **Time estimate adjustment:** If materials are comprehensive, tell the user: "Since you've already done a lot of the thinking, this will be faster — probably 15-20 minutes to confirm and fill gaps, rather than a full 60-minute discovery."
77
+
78
+ **CRITICAL:** Do NOT skip this phase and jump to Step 2 (Vision). The analysis must happen here, before any step-by-step workflow begins. If you acknowledge the materials and then proceed to ask "What's your vision?" — that is a SYSTEM FAILURE.
79
+
80
+ ### 3. Design Log Update
62
81
  **Mandatory:** Update `dialog/00-context.md` before marking this step complete.
63
82
 
64
83
  Fill in:
@@ -89,8 +108,9 @@ ONLY WHEN user confirms readiness will you then load and read fully `{nextStepFi
89
108
 
90
109
  ### ✅ SUCCESS:
91
110
  - User welcomed and expectations set
92
- - Time estimate communicated (30-60 minutes)
111
+ - Time estimate communicated
93
112
  - Existing context gathered (or noted as none)
113
+ - If materials provided: Material Analysis Phase completed (extract → present → confirm → identify gaps → plan workflow)
94
114
  - Design log updated with project metadata
95
115
  - User confirms readiness to proceed
96
116
 
@@ -99,5 +119,8 @@ ONLY WHEN user confirms readiness will you then load and read fully `{nextStepFi
99
119
  - Generated content without user input
100
120
  - Skipped design log update
101
121
  - Did not wait for user confirmation before proceeding
122
+ - Materials provided but NOT analyzed (acknowledged and moved on = FAILURE)
123
+ - Materials analyzed but NOT presented to user for confirmation (pocketed silently = FAILURE)
124
+ - Asked questions whose answers are clearly in the provided documents
102
125
 
103
126
  **Master Rule:** Skipping steps, optimizing sequences, or not following exact instructions is FORBIDDEN and constitutes SYSTEM FAILURE.
@@ -48,6 +48,19 @@ Help the user explore and articulate their vision through natural conversation,
48
48
 
49
49
  ## Sequence of Instructions (Do not deviate, skip, or optimize)
50
50
 
51
+ ### 0. Check Material Analysis Status
52
+
53
+ **If vision was already confirmed during the Material Analysis Phase (Step 1):**
54
+ Run in **Confirmation Mode** — do NOT re-run the full exploratory conversation:
55
+ 1. Reference the confirmed vision: "We confirmed your vision as [synthesis from analysis phase]."
56
+ 2. Ask: "Anything to add or refine before I document it?"
57
+ 3. If nothing: synthesize, document, and advance to Step 5 (State Update)
58
+ 4. If additions: capture them, update the synthesis, confirm, then advance
59
+ 5. Skip substeps 1-3 below — they are for discovery, not re-discovery
60
+
61
+ **If no materials exist or vision was not covered:**
62
+ Run the full exploration below.
63
+
51
64
  ### 1. Open Conversation (Substep 1)
52
65
  Load and reference `../data/vision-open-conversation.md`. Adapt opening question to context, invite user to think out loud about what they are building and why it matters.
53
66
 
@@ -48,6 +48,19 @@ Help the user explore and articulate their positioning through natural conversat
48
48
 
49
49
  ## Sequence of Instructions (Do not deviate, skip, or optimize)
50
50
 
51
+ ### 0. Check Material Analysis Status
52
+
53
+ **If positioning was already confirmed during the Material Analysis Phase (Step 1):**
54
+ Run in **Confirmation Mode** — do NOT re-run the full exploratory conversation:
55
+ 1. Reference the confirmed positioning: "We confirmed your positioning as [synthesis from analysis phase]."
56
+ 2. Ask: "Anything to add or refine before I document it?"
57
+ 3. If nothing: synthesize, document, and advance to the Design Log / State Update step
58
+ 4. If additions: capture them, update the synthesis, confirm, then advance
59
+ 5. Skip the exploratory substeps below — they are for discovery, not re-discovery
60
+
61
+ **If no materials exist or positioning was not covered in materials:**
62
+ Run the full exploration below.
63
+
51
64
  ### 1. Open Conversation (Substep 1)
52
65
  Load and reference `../data/positioning-open-conversation.md`. Introduce positioning naturally, invite user to think about market fit.
53
66
 
@@ -48,6 +48,19 @@ Help the user identify and understand their business model (B2B, B2C, or both) t
48
48
 
49
49
  ## Sequence of Instructions (Do not deviate, skip, or optimize)
50
50
 
51
+ ### 0. Check Material Analysis Status
52
+
53
+ **If business model was already confirmed during the Material Analysis Phase (Step 1):**
54
+ Run in **Confirmation Mode** — do NOT re-run the full exploratory conversation:
55
+ 1. Reference the confirmed business model: "We confirmed your business model as [synthesis from analysis phase]."
56
+ 2. Ask: "Anything to add or refine before I document it?"
57
+ 3. If nothing: synthesize, document, and advance to the Design Log / State Update step
58
+ 4. If additions: capture them, update the synthesis, confirm, then advance
59
+ 5. Skip the exploratory substeps below — they are for discovery, not re-discovery
60
+
61
+ **If no materials exist or business model was not covered in materials:**
62
+ Run the full exploration below.
63
+
51
64
  ### 1. Open the Conversation
52
65
  Start naturally based on context. If they have mentioned customers already, reference that. If unclear, ask about who pays for the product. Adapt tone to stakes level.
53
66
 
@@ -54,6 +54,19 @@ Help the user define their ideal business customer profile, including company ch
54
54
 
55
55
  ## Sequence of Instructions (Do not deviate, skip, or optimize)
56
56
 
57
+ ### 0. Check Material Analysis Status
58
+
59
+ **If business customers were already confirmed during the Material Analysis Phase (Step 1):**
60
+ Run in **Confirmation Mode** — do NOT re-run the full exploratory conversation:
61
+ 1. Reference the confirmed business customers: "We confirmed your business customers as [synthesis from analysis phase]."
62
+ 2. Ask: "Anything to add or refine before I document it?"
63
+ 3. If nothing: synthesize, document, and advance to the Design Log / State Update step
64
+ 4. If additions: capture them, update the synthesis, confirm, then advance
65
+ 5. Skip the exploratory substeps below — they are for discovery, not re-discovery
66
+
67
+ **If no materials exist or business customers were not covered in materials:**
68
+ Run the full exploration below.
69
+
57
70
  ### 1. Guide Business Customer Definition
58
71
  Ask about company size, industry, decision-making structure, and budget authority. Also identify buying roles (buyer vs. user).
59
72
 
@@ -54,6 +54,19 @@ Help the user define their ideal customer profile by exploring who we are design
54
54
 
55
55
  ## Sequence of Instructions (Do not deviate, skip, or optimize)
56
56
 
57
+ ### 0. Check Material Analysis Status
58
+
59
+ **If target users were already confirmed during the Material Analysis Phase (Step 1):**
60
+ Run in **Confirmation Mode** — do NOT re-run the full exploratory conversation:
61
+ 1. Reference the confirmed target users: "We confirmed your target users as [synthesis from analysis phase]."
62
+ 2. Ask: "Anything to add or refine before I document it?"
63
+ 3. If nothing: synthesize, document, and advance to the Design Log / State Update step
64
+ 4. If additions: capture them, update the synthesis, confirm, then advance
65
+ 5. Skip the exploratory substeps below — they are for discovery, not re-discovery
66
+
67
+ **If no materials exist or target users were not covered in materials:**
68
+ Run the full exploration below.
69
+
57
70
  ### 1. Guide User Description
58
71
  Guide user to describe their ideal users in detail. Ask about their role, demographics, daily experience, frustrations, goals, and current solutions. Also identify any secondary users or stakeholders.
59
72
 
@@ -54,6 +54,19 @@ Capture the designer's STRUCTURAL vision — the founding idea, key concept, or
54
54
 
55
55
  ## Sequence of Instructions (Do not deviate, skip, or optimize)
56
56
 
57
+ ### 0. Check Material Analysis Status
58
+
59
+ **If product concept was already confirmed during the Material Analysis Phase (Step 1):**
60
+ Run in **Confirmation Mode** — do NOT re-run the full exploratory conversation:
61
+ 1. Reference the confirmed product concept: "We confirmed your product concept as [synthesis from analysis phase]."
62
+ 2. Ask: "Anything to add or refine before I document it?"
63
+ 3. If nothing: synthesize, document, and advance to the Design Log / State Update step
64
+ 4. If additions: capture them, update the synthesis, confirm, then advance
65
+ 5. Skip the exploratory substeps below — they are for discovery, not re-discovery
66
+
67
+ **If no materials exist or product concept was not covered in materials:**
68
+ Run the full exploration below.
69
+
57
70
  ### 1. Open the Concept Conversation
58
71
  Check for existing materials first. Without materials: Ask about the core concept, the structural idea, what everything builds from. With materials: Reference what they mention and probe deeper.
59
72
 
@@ -47,6 +47,19 @@ Help the user explore and define what success looks like through conversational
47
47
 
48
48
  ## Sequence of Instructions (Do not deviate, skip, or optimize)
49
49
 
50
+ ### 0. Check Material Analysis Status
51
+
52
+ **If success criteria were already confirmed during the Material Analysis Phase (Step 1):**
53
+ Run in **Confirmation Mode** — do NOT re-run the full exploratory conversation:
54
+ 1. Reference the confirmed success criteria: "We confirmed your success criteria as [synthesis from analysis phase]."
55
+ 2. Ask: "Anything to add or refine before I document it?"
56
+ 3. If nothing: synthesize, document, and advance to the Design Log / State Update step
57
+ 4. If additions: capture them, update the synthesis, confirm, then advance
58
+ 5. Skip the exploratory substeps below — they are for discovery, not re-discovery
59
+
60
+ **If no materials exist or success criteria were not covered in materials:**
61
+ Run the full exploration below.
62
+
50
63
  ### 1. Open the Conversation
51
64
  Ask about what changes when this launches and is working well.
52
65
 
@@ -47,6 +47,19 @@ Help user explore alternatives and discover their unfair advantage. Explore what
47
47
 
48
48
  ## Sequence of Instructions (Do not deviate, skip, or optimize)
49
49
 
50
+ ### 0. Check Material Analysis Status
51
+
52
+ **If competitive landscape was already confirmed during the Material Analysis Phase (Step 1):**
53
+ Run in **Confirmation Mode** — do NOT re-run the full exploratory conversation:
54
+ 1. Reference the confirmed competitive landscape: "We confirmed your competitive landscape as [synthesis from analysis phase]."
55
+ 2. Ask: "Anything to add or refine before I document it?"
56
+ 3. If nothing: synthesize, document, and advance to the Design Log / State Update step
57
+ 4. If additions: capture them, update the synthesis, confirm, then advance
58
+ 5. Skip the exploratory substeps below — they are for discovery, not re-discovery
59
+
60
+ **If no materials exist or competitive landscape was not covered in materials:**
61
+ Run the full exploration below.
62
+
50
63
  ### 1. Open with Alternatives
51
64
  Start broad: what do people do today? Include manual solutions, do-nothing, different approaches.
52
65
 
@@ -47,6 +47,19 @@ Help user identify constraints as design parameters.
47
47
 
48
48
  ## Sequence of Instructions (Do not deviate, skip, or optimize)
49
49
 
50
+ ### 0. Check Material Analysis Status
51
+
52
+ **If constraints were already confirmed during the Material Analysis Phase (Step 1):**
53
+ Run in **Confirmation Mode** — do NOT re-run the full exploratory conversation:
54
+ 1. Reference the confirmed constraints: "We confirmed your constraints as [synthesis from analysis phase]."
55
+ 2. Ask: "Anything to add or refine before I document it?"
56
+ 3. If nothing: synthesize, document, and advance to the Design Log / State Update step
57
+ 4. If additions: capture them, update the synthesis, confirm, then advance
58
+ 5. Skip the exploratory substeps below — they are for discovery, not re-discovery
59
+
60
+ **If no materials exist or constraints were not covered in materials:**
61
+ Run the full exploration below.
62
+
50
63
  ### 1. Frame Positively
51
64
  Design parameters.
52
65
 
@@ -47,6 +47,19 @@ Establish the technical platform strategy and device support requirements that w
47
47
 
48
48
  ## Sequence of Instructions (Do not deviate, skip, or optimize)
49
49
 
50
+ ### 0. Check Material Analysis Status
51
+
52
+ **If platform strategy was already confirmed during the Material Analysis Phase (Step 1):**
53
+ Run in **Confirmation Mode** — do NOT re-run the full exploratory conversation:
54
+ 1. Reference the confirmed platform strategy: "We confirmed your platform strategy as [synthesis from analysis phase]."
55
+ 2. Ask: "Anything to add or refine before I document it?"
56
+ 3. If nothing: synthesize, document, and advance to the Design Log / State Update step
57
+ 4. If additions: capture them, update the synthesis, confirm, then advance
58
+ 5. Skip the exploratory substeps below — they are for discovery, not re-discovery
59
+
60
+ **If no materials exist or platform strategy was not covered in materials:**
61
+ Run the full exploration below.
62
+
50
63
  ### 1. Guide Platform Strategy Definition
51
64
  Help user define their platform strategy by asking about primary platform choice, supported devices, device priority, interaction models needed, offline functionality requirements, native device features needed, and platform rationale including constraints and future plans.
52
65
 
@@ -47,6 +47,19 @@ Establish the product's communication personality and style for consistent UI mi
47
47
 
48
48
  ## Sequence of Instructions (Do not deviate, skip, or optimize)
49
49
 
50
+ ### 0. Check Material Analysis Status
51
+
52
+ **If tone and brand personality were already confirmed during the Material Analysis Phase (Step 1):**
53
+ Run in **Confirmation Mode** — do NOT re-run the full exploratory conversation:
54
+ 1. Reference the confirmed tone: "We confirmed your tone and brand personality as [synthesis from analysis phase]."
55
+ 2. Ask: "Anything to add or refine before I document it?"
56
+ 3. If nothing: synthesize, document, and advance to the Design Log / State Update step
57
+ 4. If additions: capture them, update the synthesis, confirm, then advance
58
+ 5. Skip the exploratory substeps below — they are for discovery, not re-discovery
59
+
60
+ **If no materials exist or tone was not covered in materials:**
61
+ Run the full exploration below.
62
+
50
63
  ### 1. Analyze Product Context
51
64
  Review what you've learned:
52
65
  - Vision & positioning
@@ -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 & Scenarios
79
- - **Idunn** — Platform Requirements & Design Deliveries
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
- **Agents**: Freya WDS Designer Agent + Idunn WDS PM Agent
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
- **Both agents contribute**:
25
- - Idunn brings **business perspective** (goals, metrics, value)
26
- - Freya brings **UX perspective** (flow, interactions, usability)
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** (Idunn's focus)
275
+ ### **Step 10: Business Value** (Freya's focus)
278
276
 
279
- > "**Idunn, what's the business value of this scenario?**
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
- **Idunn**: "Great! Let's define this together. I'll collaborate with Freya. What's the high-level purpose?"
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
- **Idunn**: "What are their specific goals?"
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
- **Idunn & Freya**: "✅ Scenario specification created! Ready to create page specs?"
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
- **Idunn focuses on**:
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
- - Idunn can request audits before development
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, Idunn)
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
@@ -52,7 +52,7 @@ agentic-development/
52
52
 
53
53
  #### `AGENTIC-DEVELOPMENT-GUIDE.md`
54
54
  **Purpose**: Complete system overview
55
- **For**: All agents (Freya, Saga, Idunn)
55
+ **For**: All agents (Freya, Saga)
56
56
  **Contains**:
57
57
  - System overview
58
58
  - Folder structure
@@ -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 Idunn, a product evolution specialist guiding continuous improvement
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 Idunn, a product evolution specialist guiding continuous improvement
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 Idunn, a product evolution specialist guiding continuous improvement
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 Idunn, a product evolution specialist guiding continuous improvement
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