WDS Install errors fixed

This commit is contained in:
Mårten Angner 2026-01-08 14:24:05 +01:00
parent 251c5c5c0c
commit 1a7cf04e3e
22 changed files with 823 additions and 886 deletions

13
package-lock.json generated
View File

@ -244,7 +244,6 @@
"integrity": "sha512-e7jT4DxYvIDLk1ZHmU/m/mB19rex9sv0c2ftBtjSBv+kVM/902eh0fINUzD7UwLLNR+jU585GxUJ8/EBfAM5fw==", "integrity": "sha512-e7jT4DxYvIDLk1ZHmU/m/mB19rex9sv0c2ftBtjSBv+kVM/902eh0fINUzD7UwLLNR+jU585GxUJ8/EBfAM5fw==",
"dev": true, "dev": true,
"license": "MIT", "license": "MIT",
"peer": true,
"dependencies": { "dependencies": {
"@babel/code-frame": "^7.27.1", "@babel/code-frame": "^7.27.1",
"@babel/generator": "^7.28.5", "@babel/generator": "^7.28.5",
@ -3643,7 +3642,6 @@
"integrity": "sha512-W609buLVRVmeW693xKfzHeIV6nJGGz98uCPfeXI1ELMLXVeKYZ9m15fAMSaUPBHYLGFsVRcMmSCksQOrZV9BYA==", "integrity": "sha512-W609buLVRVmeW693xKfzHeIV6nJGGz98uCPfeXI1ELMLXVeKYZ9m15fAMSaUPBHYLGFsVRcMmSCksQOrZV9BYA==",
"devOptional": true, "devOptional": true,
"license": "MIT", "license": "MIT",
"peer": true,
"dependencies": { "dependencies": {
"undici-types": "~7.16.0" "undici-types": "~7.16.0"
} }
@ -3983,7 +3981,6 @@
"integrity": "sha512-NZyJarBfL7nWwIq+FDL6Zp/yHEhePMNnnJ0y3qfieCrmNvYct8uvtiV41UvlSe6apAfk0fY1FbWx+NwfmpvtTg==", "integrity": "sha512-NZyJarBfL7nWwIq+FDL6Zp/yHEhePMNnnJ0y3qfieCrmNvYct8uvtiV41UvlSe6apAfk0fY1FbWx+NwfmpvtTg==",
"dev": true, "dev": true,
"license": "MIT", "license": "MIT",
"peer": true,
"bin": { "bin": {
"acorn": "bin/acorn" "acorn": "bin/acorn"
}, },
@ -4290,7 +4287,6 @@
"integrity": "sha512-6mF/YrvwwRxLTu+aMEa5pwzKUNl5ZetWbTyZCs9Um0F12HUmxUiF5UHiZPy4rifzU3gtpM3xP2DfdmkNX9eZRg==", "integrity": "sha512-6mF/YrvwwRxLTu+aMEa5pwzKUNl5ZetWbTyZCs9Um0F12HUmxUiF5UHiZPy4rifzU3gtpM3xP2DfdmkNX9eZRg==",
"dev": true, "dev": true,
"license": "MIT", "license": "MIT",
"peer": true,
"dependencies": { "dependencies": {
"@astrojs/compiler": "^2.13.0", "@astrojs/compiler": "^2.13.0",
"@astrojs/internal-helpers": "0.7.5", "@astrojs/internal-helpers": "0.7.5",
@ -5358,7 +5354,6 @@
} }
], ],
"license": "MIT", "license": "MIT",
"peer": true,
"dependencies": { "dependencies": {
"baseline-browser-mapping": "^2.9.0", "baseline-browser-mapping": "^2.9.0",
"caniuse-lite": "^1.0.30001759", "caniuse-lite": "^1.0.30001759",
@ -6689,7 +6684,6 @@
"integrity": "sha512-LEyamqS7W5HB3ujJyvi0HQK/dtVINZvd5mAAp9eT5S/ujByGjiZLCzPcHVzuXbpJDJF/cxwHlfceVUDZ2lnSTw==", "integrity": "sha512-LEyamqS7W5HB3ujJyvi0HQK/dtVINZvd5mAAp9eT5S/ujByGjiZLCzPcHVzuXbpJDJF/cxwHlfceVUDZ2lnSTw==",
"dev": true, "dev": true,
"license": "MIT", "license": "MIT",
"peer": true,
"dependencies": { "dependencies": {
"@eslint-community/eslint-utils": "^4.8.0", "@eslint-community/eslint-utils": "^4.8.0",
"@eslint-community/regexpp": "^4.12.1", "@eslint-community/regexpp": "^4.12.1",
@ -10304,7 +10298,6 @@
"integrity": "sha512-p3JTemJJbkiMjXEMiFwgm0v6ym5g8K+b2oDny+6xdl300tUKySxvilJQLSea48C6OaYNmO30kH9KxpiAg5bWJw==", "integrity": "sha512-p3JTemJJbkiMjXEMiFwgm0v6ym5g8K+b2oDny+6xdl300tUKySxvilJQLSea48C6OaYNmO30kH9KxpiAg5bWJw==",
"dev": true, "dev": true,
"license": "MIT", "license": "MIT",
"peer": true,
"dependencies": { "dependencies": {
"globby": "15.0.0", "globby": "15.0.0",
"js-yaml": "4.1.1", "js-yaml": "4.1.1",
@ -12378,7 +12371,6 @@
} }
], ],
"license": "MIT", "license": "MIT",
"peer": true,
"dependencies": { "dependencies": {
"nanoid": "^3.3.11", "nanoid": "^3.3.11",
"picocolors": "^1.1.1", "picocolors": "^1.1.1",
@ -12444,7 +12436,6 @@
"integrity": "sha512-v6UNi1+3hSlVvv8fSaoUbggEM5VErKmmpGA7Pl3HF8V6uKY7rvClBOJlH6yNwQtfTueNkGVpOv/mtWL9L4bgRA==", "integrity": "sha512-v6UNi1+3hSlVvv8fSaoUbggEM5VErKmmpGA7Pl3HF8V6uKY7rvClBOJlH6yNwQtfTueNkGVpOv/mtWL9L4bgRA==",
"dev": true, "dev": true,
"license": "MIT", "license": "MIT",
"peer": true,
"bin": { "bin": {
"prettier": "bin/prettier.cjs" "prettier": "bin/prettier.cjs"
}, },
@ -13273,7 +13264,6 @@
"integrity": "sha512-3nk8Y3a9Ea8szgKhinMlGMhGMw89mqule3KWczxhIzqudyHdCIOHw8WJlj/r329fACjKLEh13ZSk7oE22kyeIw==", "integrity": "sha512-3nk8Y3a9Ea8szgKhinMlGMhGMw89mqule3KWczxhIzqudyHdCIOHw8WJlj/r329fACjKLEh13ZSk7oE22kyeIw==",
"dev": true, "dev": true,
"license": "MIT", "license": "MIT",
"peer": true,
"dependencies": { "dependencies": {
"@types/estree": "1.0.8" "@types/estree": "1.0.8"
}, },
@ -14837,7 +14827,6 @@
"integrity": "sha512-+Oxm7q9hDoLMyJOYfUYBuHQo+dkAloi33apOPP56pzj+vsdJDzr+j1NISE5pyaAuKL4A3UD34qd0lx5+kfKp2g==", "integrity": "sha512-+Oxm7q9hDoLMyJOYfUYBuHQo+dkAloi33apOPP56pzj+vsdJDzr+j1NISE5pyaAuKL4A3UD34qd0lx5+kfKp2g==",
"dev": true, "dev": true,
"license": "MIT", "license": "MIT",
"peer": true,
"dependencies": { "dependencies": {
"esbuild": "^0.25.0", "esbuild": "^0.25.0",
"fdir": "^6.4.4", "fdir": "^6.4.4",
@ -15111,7 +15100,6 @@
"resolved": "https://registry.npmjs.org/yaml/-/yaml-2.8.2.tgz", "resolved": "https://registry.npmjs.org/yaml/-/yaml-2.8.2.tgz",
"integrity": "sha512-mplynKqc1C2hTVYxd0PU2xQAc22TI1vShAYGksCCfxbn/dFwnHTNi1bvYsBTkhdUNtGIf5xNOg938rrSSYvS9A==", "integrity": "sha512-mplynKqc1C2hTVYxd0PU2xQAc22TI1vShAYGksCCfxbn/dFwnHTNi1bvYsBTkhdUNtGIf5xNOg938rrSSYvS9A==",
"license": "ISC", "license": "ISC",
"peer": true,
"bin": { "bin": {
"yaml": "bin.mjs" "yaml": "bin.mjs"
}, },
@ -15303,7 +15291,6 @@
"integrity": "sha512-gzUt/qt81nXsFGKIFcC3YnfEAx5NkunCfnDlvuBSSFS02bcXu4Lmea0AFIUwbLWxWPx3d9p8S5QoaujKcNQxcQ==", "integrity": "sha512-gzUt/qt81nXsFGKIFcC3YnfEAx5NkunCfnDlvuBSSFS02bcXu4Lmea0AFIUwbLWxWPx3d9p8S5QoaujKcNQxcQ==",
"dev": true, "dev": true,
"license": "MIT", "license": "MIT",
"peer": true,
"funding": { "funding": {
"url": "https://github.com/sponsors/colinhacks" "url": "https://github.com/sponsors/colinhacks"
} }

View File

@ -108,4 +108,3 @@ design_experience:
label: "Intermediate - Familiar with design concepts, balanced approach" label: "Intermediate - Familiar with design concepts, balanced approach"
- value: "expert" - value: "expert"
label: "Expert - Experienced designer, be direct and efficient" label: "Expert - Experienced designer, be direct and efficient"

View File

@ -13,9 +13,7 @@ const chalk = require('chalk');
* @param {Object} options.logger - Logger instance for output * @param {Object} options.logger - Logger instance for output
* @returns {Promise<boolean>} - Success status * @returns {Promise<boolean>} - Success status
*/ */
async function install(options) { async function install({ projectRoot, installedIDEs, logger }) {
const { projectRoot, config, installedIDEs, logger } = options;
try { try {
logger.log(chalk.blue('🎨 Installing WDS Module...')); logger.log(chalk.blue('🎨 Installing WDS Module...'));
@ -42,11 +40,11 @@ async function install(options) {
for (const folder of wdsFolders) { for (const folder of wdsFolders) {
const folderPath = path.join(docsPath, folder); const folderPath = path.join(docsPath, folder);
if (!(await fs.pathExists(folderPath))) { if (await fs.pathExists(folderPath)) {
logger.log(chalk.dim(`${folder}/ (already exists)`));
} else {
await fs.ensureDir(folderPath); await fs.ensureDir(folderPath);
logger.log(chalk.dim(`${folder}/`)); logger.log(chalk.dim(`${folder}/`));
} else {
logger.log(chalk.dim(`${folder}/ (already exists)`));
} }
} }

View File

@ -8,6 +8,7 @@ agent:
title: WDS Designer title: WDS Designer
icon: 🎨 icon: 🎨
module: wds module: wds
hasSidecar: false
persona: persona:
role: Strategic UX Designer + Your Design Thinking Partner role: Strategic UX Designer + Your Design Thinking Partner
@ -40,52 +41,36 @@ agent:
**Agent References**: When mentioning other WDS agents, always use the format: **Agent References**: When mentioning other WDS agents, always use the format:
"[Name] WDS [Role] Agent" (e.g., "Saga WDS Analyst Agent", "Idunn WDS PM Agent") "[Name] WDS [Role] Agent" (e.g., "Saga WDS Analyst Agent", "Idunn WDS PM Agent")
micro_guides: | principles: |
**When I need detailed guidance, I load these micro-guides:** **Micro-Guides (load when needed):**
- Strategic Design → data/agent-guides/freya/strategic-design.md (before designing, VTC/Trigger Map connection)
- Specification Quality → data/agent-guides/freya/specification-quality.md (creating specs, logical explanations)
- Interactive Prototyping → data/agent-guides/freya/interactive-prototyping.md (HTML prototypes, validation)
- Content Creation → data/agent-guides/freya/content-creation.md (strategic content, 6-model framework)
- Design System → data/agent-guides/freya/design-system.md (Phase 5, organic growth)
**Strategic Design** → data/agent-guides/freya/strategic-design.md **Workflow Management:**
- Before designing anything (connect to VTC, Trigger Map, Customer Awareness) - On activation: Check conversations (conversation-persistence/check-conversations.md)
- VTC connection, driving forces, Golden Circle hierarchy - Before work: Check task appropriateness (task-reflection.md)
- On close: Save conversation (conversation-persistence/save-conversation.md)
- Show presentation (freya-presentation.md), then project analysis (project-analysis-router.md)
**Specification Quality** → data/agent-guides/freya/specification-quality.md **Collaboration:**
- Before creating specs (logical explanations, purpose-based naming) - My domain: Phases 4 (UX Design), 5 (Design System - optional), 7 (Testing)
- Section-first workflow, multi-language, developer trust - Other domains: Hand over seamlessly to specialized agent
- BMM overlap: I replace Sally (UX Designer) when WDS is installed
**Interactive Prototyping** → data/agent-guides/freya/interactive-prototyping.md **Core Approach:**
- When creating HTML prototypes (prototypes as thinking tools) - Load strategic context BEFORE designing (micro-guide: strategic-design.md)
- Validation process, fidelity levels, Design System integration - Specifications must be logical and complete (micro-guide: specification-quality.md)
- Prototypes validate before production (micro-guide: interactive-prototyping.md)
- Content is strategic, not decorative (micro-guide: content-creation.md)
- Design systems grow organically (micro-guide: design-system.md if Phase 5)
**Content Creation** → data/agent-guides/freya/content-creation.md **Project Tracking:**
- Before creating strategic content (headlines, features, sections) - Update project outline when completing work
- 6-model framework, workshop vs quick mode, content purpose - Use specific file names: [TOPIC]-GUIDE.md, never generic README.md
- See: workflows/00-system/FILE-NAMING-CONVENTIONS.md
**Design System** → data/agent-guides/freya/design-system.md
- When Phase 5 enabled (organic growth, opportunity/risk assessment)
- Three modes, component operations, foundation first
principles:
workflow_management: |
- On activation: Check conversations (conversation-persistence/check-conversations.md)
- Before work: Check task appropriateness (task-reflection.md)
- On close: Save conversation (conversation-persistence/save-conversation.md)
- Show presentation (freya-presentation.md), then project analysis (project-analysis-router.md)
collaboration: |
- My domain: Phases 4 (UX Design), 5 (Design System - optional), 7 (Testing)
- Other domains: Hand over seamlessly to specialized agent
- BMM overlap: I replace Sally (UX Designer) when WDS is installed
core_approach: |
- Load strategic context BEFORE designing (micro-guide: strategic-design.md)
- Specifications must be logical and complete (micro-guide: specification-quality.md)
- Prototypes validate before production (micro-guide: interactive-prototyping.md)
- Content is strategic, not decorative (micro-guide: content-creation.md)
- Design systems grow organically (micro-guide: design-system.md if Phase 5)
project_tracking: |
- Update project outline when completing work
- Use specific file names: [TOPIC]-GUIDE.md, never generic README.md
- See: workflows/00-system/FILE-NAMING-CONVENTIONS.md
menu: menu:
- trigger: workflow-status - trigger: workflow-status

View File

@ -8,6 +8,7 @@ agent:
title: WDS Product Manager title: WDS Product Manager
icon: 📋 icon: 📋
module: wds module: wds
hasSidecar: false
persona: persona:
role: Strategic Product Manager + Technical Coordinator + Handoff Specialist role: Strategic Product Manager + Technical Coordinator + Handoff Specialist
@ -32,40 +33,33 @@ agent:
**Agent References**: When mentioning other WDS agents, use: "[Name] WDS [Role] Agent" **Agent References**: When mentioning other WDS agents, use: "[Name] WDS [Role] Agent"
micro_guides: | principles: |
**When I need detailed guidance, I load these micro-guides:** **Micro-Guides (load when needed):**
- Platform Requirements → data/agent-guides/idunn/platform-requirements.md (Phase 3, technical foundation)
- Design Handoffs → data/agent-guides/idunn/design-handoffs.md (Phase 6, BMM handoff preparation)
**Platform Requirements** → data/agent-guides/idunn/platform-requirements.md **Workflow Management:**
- During Phase 3 or technical foundation work - On activation: Check conversations (conversation-persistence/check-conversations.md)
- Architecture, data model, integrations, security, performance, constraints - Before work: Check task appropriateness (task-reflection.md)
- On close: Save conversation (conversation-persistence/save-conversation.md)
- Show presentation (idunn-presentation.md), then project analysis (project-analysis/instructions.md)
**Design Handoffs** → data/agent-guides/idunn/design-handoffs.md **Collaboration:**
- During Phase 6 or preparing BMM handoff - My domain: Phases 3 (Platform Requirements), 6 (Design Deliveries)
- DD-XXX files, complete PRD, acceptance criteria, continuous handoff pattern - Other domains: Hand over seamlessly to specialized agent
- Note: I do NOT replace BMM PM Agent (different focus: technical foundation + handoffs)
principles: **Core Approach:**
workflow_management: | - Technical foundation in parallel with design (micro-guide: platform-requirements.md)
- On activation: Check conversations (conversation-persistence/check-conversations.md) - Package complete flows for BMM handoff (micro-guide: design-handoffs.md)
- Before work: Check task appropriateness (task-reflection.md) - Reference, don't duplicate (link to requirements, don't copy)
- On close: Save conversation (conversation-persistence/save-conversation.md) - Organize by value (epic-based, testable units)
- Show presentation (idunn-presentation.md), then project analysis (project-analysis/instructions.md) - Continuous handoff pattern (don't wait for everything)
collaboration: | **Project Tracking:**
- My domain: Phases 3 (Platform Requirements), 6 (Design Deliveries) - Update project outline when completing work
- Other domains: Hand over seamlessly to specialized agent - File naming: [TOPIC]-GUIDE.md, DD-XXX-[epic-name].yaml
- Note: I do NOT replace BMM PM Agent (different focus: technical foundation + handoffs) - See: workflows/00-system/FILE-NAMING-CONVENTIONS.md
core_approach: |
- Technical foundation in parallel with design (micro-guide: platform-requirements.md)
- Package complete flows for BMM handoff (micro-guide: design-handoffs.md)
- Reference, don't duplicate (link to requirements, don't copy)
- Organize by value (epic-based, testable units)
- Continuous handoff pattern (don't wait for everything)
project_tracking: |
- Update project outline when completing work
- File naming: [TOPIC]-GUIDE.md, DD-XXX-[epic-name].yaml
- See: workflows/00-system/FILE-NAMING-CONVENTIONS.md
menu: menu:
- trigger: workflow-status - trigger: workflow-status

View File

@ -8,7 +8,7 @@ agent:
title: WDS Analyst title: WDS Analyst
icon: 📚 icon: 📚
module: wds module: wds
version: "1.0.0" hasSidecar: false
persona: persona:
role: Strategic Business Analyst + Product Discovery Partner role: Strategic Business Analyst + Product Discovery Partner
@ -38,54 +38,44 @@ agent:
**Agent References**: When mentioning other WDS agents, use: "[Name] WDS [Role] Agent" **Agent References**: When mentioning other WDS agents, use: "[Name] WDS [Role] Agent"
micro_guides: | principles: |
**When I need detailed guidance, I load these micro-guides:** **Micro-Guides (load when needed):**
- Discovery Conversation → data/agent-guides/saga/discovery-conversation.md (Product Brief, Alignment & Signoff)
- Trigger Mapping → data/agent-guides/saga/trigger-mapping.md (Phase 2, psychology analysis)
- Strategic Documentation → data/agent-guides/saga/strategic-documentation.md (documentation creation)
**Discovery Conversation** → data/agent-guides/saga/discovery-conversation.md **Working Rhythm:**
- During Product Brief, Alignment & Signoff, or any discovery work
- Natural listening pattern, reflection techniques, handling different user types
**Trigger Mapping** → data/agent-guides/saga/trigger-mapping.md
- During Phase 2 or psychology analysis
- Business goals → users → driving forces, Feature Impact Analysis
**Strategic Documentation** → data/agent-guides/saga/strategic-documentation.md
- When creating Product Brief, Project Outline, or documentation
- File naming, absolute paths, precision standards, maintenance
principles:
workflow_management: |
- On activation: Check conversations (conversation-persistence/check-conversations.md)
- Before work: Check task appropriateness (task-reflection.md)
- On close: Save conversation (conversation-persistence/save-conversation.md)
- Show presentation (saga-presentation.md), then project analysis (project-analysis/instructions.md)
collaboration: |
- My domain: Phases 1 (Product Brief), 2 (Trigger Mapping)
- Other domains: Hand over seamlessly to specialized agent
- BMM overlap: I replace Mary (Analyst) when WDS is installed
core_approach: |
- Discovery through conversation (micro-guide: discovery-conversation.md)
- Connect business to psychology (micro-guide: trigger-mapping.md)
- Create coordinating documentation (micro-guide: strategic-documentation.md)
- One question at a time, listen deeply
- Find and treat as bible: **/project-context.md
project_tracking: |
- Create project outline during Product Brief (10 micro-steps)
- Use absolute paths: docs/A-Product-Brief/, docs/B-Trigger-Map/
- Alliterative persona names: Harriet the Hairdresser, Marcus Manager
- File naming: [TOPIC]-GUIDE.md, never generic README.md
- See: workflows/00-system/FILE-NAMING-CONVENTIONS.md
working_rhythm: |
1. You share an idea or question 1. You share an idea or question
2. I listen and reflect back naturally (in my own words) 2. I listen and reflect back naturally (in my own words)
3. I confirm understanding, then wait for your confirmation 3. I confirm understanding, then wait for your confirmation
4. Once confirmed, we explore solutions together 4. Once confirmed, we explore solutions together
5. I structure insights into clear documentation 5. I structure insights into clear documentation
**Workflow Management:**
- On activation: Check conversations (conversation-persistence/check-conversations.md)
- Before work: Check task appropriateness (task-reflection.md)
- On close: Save conversation (conversation-persistence/save-conversation.md)
- Show presentation (saga-presentation.md), then project analysis (project-analysis/instructions.md)
**Collaboration:**
- My domain: Phases 1 (Product Brief), 2 (Trigger Mapping)
- Other domains: Hand over seamlessly to specialized agent
- BMM overlap: I replace Mary (Analyst) when WDS is installed
**Core Approach:**
- Discovery through conversation (micro-guide: discovery-conversation.md)
- Connect business to psychology (micro-guide: trigger-mapping.md)
- Create coordinating documentation (micro-guide: strategic-documentation.md)
- One question at a time, listen deeply
- Find and treat as bible: **/project-context.md
**Project Tracking:**
- Create project outline during Product Brief (10 micro-steps)
- Use absolute paths: docs/A-Product-Brief/, docs/B-Trigger-Map/
- Alliterative persona names: Harriet the Hairdresser, Marcus Manager
- File naming: [TOPIC]-GUIDE.md, never generic README.md
- See: workflows/00-system/FILE-NAMING-CONVENTIONS.md
menu: menu:
- trigger: workflow-status - trigger: workflow-status
workflow: "{project-root}/{bmad_folder}/wds/workflows/workflow-status/workflow.yaml" workflow: "{project-root}/{bmad_folder}/wds/workflows/workflow-status/workflow.yaml"

View File

@ -108,4 +108,3 @@ current_scenario:
- "Testimonials Section" - "Testimonials Section"
- "CTA Section" - "CTA Section"
- "Footer Section" - "Footer Section"

View File

@ -2,7 +2,7 @@
**Master the complete WDS methodology and become indispensable as a designer in the AI era** **Master the complete WDS methodology and become indispensable as a designer in the AI era**
https://www.youtube.com/watch?v=CQ5Aai_r-uo [Watch the Course Introduction Video](https://www.youtube.com/watch?v=CQ5Aai_r-uo)
--- ---

View File

@ -1,7 +1,7 @@
# YouTube Show Notes: Module 00 - Getting Started with WDS # YouTube Show Notes: Module 00 - Getting Started with WDS
**Video Link:** **Video Link:**
https://youtu.be/qYPYx01YLUc <https://youtu.be/qYPYx01YLUc>
**Video Title:** **Video Title:**
Getting Started with Whiteport Design Studio - Your Path to Becoming a Linchpin Designer Getting Started with Whiteport Design Studio - Your Path to Becoming a Linchpin Designer
@ -61,27 +61,27 @@ _To be added after video production based on transcript_
### **This Module** ### **This Module**
📖 **Module 00 Overview:** Getting Started Guide 📖 **Module 00 Overview:** Getting Started Guide
https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/learn-wds/00-course-overview/00-getting-started-overview.md <https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/learn-wds/00-course-overview/00-getting-started-overview.md>
### **Get Started with WDS** ### **Get Started with WDS**
🌊 **WDS Presentation Page:** Learn about the methodology 🌊 **WDS Presentation Page:** Learn about the methodology
https://whiteport.com/whiteport-design-studio/ <https://whiteport.com/whiteport-design-studio/>
🛠️ **Installation Guide:** Download IDE, Install WDS 🛠️ **Installation Guide:** Download IDE, Install WDS
https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/getting-started/installation.md <https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/getting-started/installation.md>
📖 **Quick Start:** Get up and running fast 📖 **Quick Start:** Get up and running fast
https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/getting-started/quick-start.md <https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/getting-started/quick-start.md>
📖 **About WDS:** Philosophy and approach 📖 **About WDS:** Philosophy and approach
https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/getting-started/about-wds.md <https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/getting-started/about-wds.md>
### **Community & Support** ### **Community & Support**
💬 **BMad Discord:** Real designers helping each other 💬 **BMad Discord:** Real designers helping each other
[Discord invite link] [Discord invite link]
📖 **GitHub Discussions:** Ask questions, share your journey 📖 **GitHub Discussions:** Ask questions, share your journey
https://github.com/whiteport-collective/whiteport-design-studio/discussions <https://github.com/whiteport-collective/whiteport-design-studio/discussions>
--- ---
@ -90,11 +90,11 @@ https://github.com/whiteport-collective/whiteport-design-studio/discussions
**◀️ Previous Module:** _This is the first module_ **◀️ Previous Module:** _This is the first module_
**▶️ Next Module:** Module 01 - Why WDS Matters **▶️ Next Module:** Module 01 - Why WDS Matters
📺 Video: https://www.youtube.com/watch?v=Xhw5JB7mpxw 📺 Video: <https://www.youtube.com/watch?v=Xhw5JB7mpxw>
📖 Documentation: https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/learn-wds/module-01-why-wds-matters/module-01-overview.md 📖 Documentation: <https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/learn-wds/module-01-why-wds-matters/module-01-overview.md>
**📚 Full Course Overview:** **📚 Full Course Overview:**
https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/learn-wds/00-course-overview.md <https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/learn-wds/00-course-overview.md>
--- ---

View File

@ -1,7 +1,7 @@
# YouTube Show Notes: Module 01 - Why WDS Matters # YouTube Show Notes: Module 01 - Why WDS Matters
**Video Link:** **Video Link:**
https://www.youtube.com/watch?v=Xhw5JB7mpxw <https://www.youtube.com/watch?v=Xhw5JB7mpxw>
**Video Title:** **Video Title:**
Module 01: Why WDS Matters - Are You a Factory Worker or a Linchpin Designer? Module 01: Why WDS Matters - Are You a Factory Worker or a Linchpin Designer?
@ -55,43 +55,43 @@ _To be added after video production based on transcript_
### **This Module** ### **This Module**
📖 **Module 01 Overview:** Complete lesson structure 📖 **Module 01 Overview:** Complete lesson structure
https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/learn-wds/module-01-why-wds-matters/module-01-overview.md <https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/learn-wds/module-01-why-wds-matters/module-01-overview.md>
### **Get Started with WDS** ### **Get Started with WDS**
🌊 **WDS Presentation Page:** Learn about the methodology 🌊 **WDS Presentation Page:** Learn about the methodology
https://whiteport.com/whiteport-design-studio/ <https://whiteport.com/whiteport-design-studio/>
🛠️ **Installation Guide:** Download IDE, Install WDS 🛠️ **Installation Guide:** Download IDE, Install WDS
https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/getting-started/installation.md <https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/getting-started/installation.md>
📖 **About WDS:** Philosophy and approach 📖 **About WDS:** Philosophy and approach
https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/getting-started/about-wds.md <https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/getting-started/about-wds.md>
### **Recommended Reading** ### **Recommended Reading**
📚 **Book:** "Linchpin: Are You Indispensable?" by Seth Godin (2010) 📚 **Book:** "Linchpin: Are You Indispensable?" by Seth Godin (2010)
https://www.amazon.com/Linchpin-Are-You-Indispensable-ebook/dp/B00354Y9ZU <https://www.amazon.com/Linchpin-Are-You-Indispensable-ebook/dp/B00354Y9ZU>
### **Community & Support** ### **Community & Support**
💬 **BMad Discord:** Join other linchpin designers 💬 **BMad Discord:** Join other linchpin designers
[Discord invite link] [Discord invite link]
📖 **GitHub Discussions:** Ask questions, share your journey 📖 **GitHub Discussions:** Ask questions, share your journey
https://github.com/whiteport-collective/whiteport-design-studio/discussions <https://github.com/whiteport-collective/whiteport-design-studio/discussions>
--- ---
## 🎓 Course Navigation ## 🎓 Course Navigation
**◀️ Previous Module:** Module 00 - Getting Started **◀️ Previous Module:** Module 00 - Getting Started
📺 Video: https://youtu.be/qYPYx01YLUc 📺 Video: <https://youtu.be/qYPYx01YLUc>
📖 Documentation: https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/learn-wds/00-course-overview/00-getting-started-overview.md 📖 Documentation: <https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/learn-wds/00-course-overview/00-getting-started-overview.md>
**▶️ Next Module:** Module 02 - Installation & Setup **▶️ Next Module:** Module 02 - Installation & Setup
📺 Video: https://www.youtube.com/watch?v=tYifpxFVVks 📺 Video: <https://www.youtube.com/watch?v=tYifpxFVVks>
📖 Documentation: https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/learn-wds/module-02-installation-setup/module-02-overview.md 📖 Documentation: <https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/learn-wds/module-02-installation-setup/module-02-overview.md>
**📚 Full Course Overview:** **📚 Full Course Overview:**
https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/learn-wds/00-course-overview.md <https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/learn-wds/00-course-overview.md>
--- ---

View File

@ -1,7 +1,7 @@
# YouTube Show Notes: Module 02 - Installation & Setup # YouTube Show Notes: Module 02 - Installation & Setup
**Video Link:** **Video Link:**
https://www.youtube.com/watch?v=tYifpxFVVks <https://www.youtube.com/watch?v=tYifpxFVVks>
**Video Title:** **Video Title:**
Module 02: Installation & Setup - From Zero to WDS-Ready in Under an Hour Module 02: Installation & Setup - From Zero to WDS-Ready in Under an Hour
@ -121,44 +121,44 @@ Your 8-phase WDS methodology folders:
### **This Module** ### **This Module**
📖 **Module 02 Overview:** Complete lesson structure 📖 **Module 02 Overview:** Complete lesson structure
https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/learn-wds/module-02-installation-setup/module-02-overview.md <https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/learn-wds/module-02-installation-setup/module-02-overview.md>
### **Get Started with WDS** ### **Get Started with WDS**
🌊 **WDS Presentation Page:** Learn about the methodology 🌊 **WDS Presentation Page:** Learn about the methodology
https://whiteport.com/whiteport-design-studio/ <https://whiteport.com/whiteport-design-studio/>
🛠️ **Installation Guide:** Download IDE, Install WDS 🛠️ **Installation Guide:** Download IDE, Install WDS
https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/getting-started/installation.md <https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/getting-started/installation.md>
📖 **Quick Start:** Get up and running fast 📖 **Quick Start:** Get up and running fast
https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/getting-started/quick-start.md <https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/getting-started/quick-start.md>
### **Download Links** ### **Download Links**
📥 **Download Cursor:** https://cursor.sh 📥 **Download Cursor:** <https://cursor.sh>
📥 **Download VS Code:** https://code.visualstudio.com 📥 **Download VS Code:** <https://code.visualstudio.com>
📥 **GitHub:** https://github.com 📥 **GitHub:** <https://github.com>
### **Community & Support** ### **Community & Support**
💬 **BMad Discord:** Real designers helping each other 💬 **BMad Discord:** Real designers helping each other
[Discord invite link] [Discord invite link]
📖 **GitHub Discussions:** Ask questions, share your setup 📖 **GitHub Discussions:** Ask questions, share your setup
https://github.com/whiteport-collective/whiteport-design-studio/discussions <https://github.com/whiteport-collective/whiteport-design-studio/discussions>
--- ---
## 🎓 Course Navigation ## 🎓 Course Navigation
**◀️ Previous Module:** Module 01 - Why WDS Matters **◀️ Previous Module:** Module 01 - Why WDS Matters
📺 Video: https://www.youtube.com/watch?v=Xhw5JB7mpxw 📺 Video: <https://www.youtube.com/watch?v=Xhw5JB7mpxw>
📖 Documentation: https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/learn-wds/module-01-why-wds-matters/module-01-overview.md 📖 Documentation: <https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/learn-wds/module-01-why-wds-matters/module-01-overview.md>
**▶️ Next Module:** Module 03 - Alignment & Signoff **▶️ Next Module:** Module 03 - Alignment & Signoff
📺 Video: https://www.youtube.com/watch?v=TKjOLlU8UCE 📺 Video: <https://www.youtube.com/watch?v=TKjOLlU8UCE>
📖 Documentation: https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/learn-wds/module-03-alignment-signoff/module-03-overview.md 📖 Documentation: <https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/learn-wds/module-03-alignment-signoff/module-03-overview.md>
**📚 Full Course Overview:** **📚 Full Course Overview:**
https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/learn-wds/00-course-overview.md <https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/learn-wds/00-course-overview.md>
--- ---

View File

@ -1,7 +1,7 @@
# YouTube Show Notes: Module 03 - Alignment & Signoff # YouTube Show Notes: Module 03 - Alignment & Signoff
**Video Link:** **Video Link:**
https://www.youtube.com/watch?v=TKjOLlU8UCE <https://www.youtube.com/watch?v=TKjOLlU8UCE>
**Video Title:** **Video Title:**
Module 03: Alignment & Signoff - Get Stakeholder Buy-In for Your Design Projects Module 03: Alignment & Signoff - Get Stakeholder Buy-In for Your Design Projects
@ -58,49 +58,49 @@ _To be added after video production based on transcript_
### **This Module** ### **This Module**
📖 **Module 03 Overview:** Complete lesson structure 📖 **Module 03 Overview:** Complete lesson structure
https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/learn-wds/module-03-alignment-signoff/module-03-overview.md <https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/learn-wds/module-03-alignment-signoff/module-03-overview.md>
📖 **Tutorial 03:** Step-by-step hands-on guide 📖 **Tutorial 03:** Step-by-step hands-on guide
https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/learn-wds/module-03-alignment-signoff/tutorial-03.md <https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/learn-wds/module-03-alignment-signoff/tutorial-03.md>
### **Deliverable Documentation** ### **Deliverable Documentation**
📖 **Project Pitch:** What it is and how to create it 📖 **Project Pitch:** What it is and how to create it
https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/deliverables/project-pitch.md <https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/deliverables/project-pitch.md>
📖 **Service Agreement:** Contract templates and guidance 📖 **Service Agreement:** Contract templates and guidance
https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/deliverables/service-agreement.md <https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/deliverables/service-agreement.md>
### **WDS Workflows** ### **WDS Workflows**
📖 **Alignment & Signoff Workflow:** Complete process guide 📖 **Alignment & Signoff Workflow:** Complete process guide
https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/workflows/1-project-brief/alignment-signoff/workflow.md <https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/workflows/1-project-brief/alignment-signoff/workflow.md>
### **Get Started with WDS** ### **Get Started with WDS**
🌊 **WDS Presentation Page:** Learn about the methodology 🌊 **WDS Presentation Page:** Learn about the methodology
https://whiteport.com/whiteport-design-studio/ <https://whiteport.com/whiteport-design-studio/>
🛠️ **Installation Guide:** Download IDE, Install WDS 🛠️ **Installation Guide:** Download IDE, Install WDS
https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/getting-started/installation.md <https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/getting-started/installation.md>
### **Community & Support** ### **Community & Support**
💬 **BMad Discord:** Share alignment documents, ask questions about contracts 💬 **BMad Discord:** Share alignment documents, ask questions about contracts
[Discord invite link] [Discord invite link]
📖 **GitHub Discussions:** Ask questions, share your journey 📖 **GitHub Discussions:** Ask questions, share your journey
https://github.com/whiteport-collective/whiteport-design-studio/discussions <https://github.com/whiteport-collective/whiteport-design-studio/discussions>
--- ---
## 🎓 Course Navigation ## 🎓 Course Navigation
**◀️ Previous Module:** Module 02 - Installation & Setup **◀️ Previous Module:** Module 02 - Installation & Setup
📺 Video: https://www.youtube.com/watch?v=tYifpxFVVks 📺 Video: <https://www.youtube.com/watch?v=tYifpxFVVks>
📖 Documentation: https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/learn-wds/module-02-installation-setup/module-02-overview.md 📖 Documentation: <https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/learn-wds/module-02-installation-setup/module-02-overview.md>
**▶️ Next Module:** Module 04 - Product Brief (Coming Soon) **▶️ Next Module:** Module 04 - Product Brief (Coming Soon)
📖 Documentation: https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/learn-wds/module-04-product-brief/tutorial-04.md 📖 Documentation: <https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/learn-wds/module-04-product-brief/tutorial-04.md>
**📚 Full Course Overview:** **📚 Full Course Overview:**
https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/learn-wds/00-course-overview.md <https://github.com/whiteport-collective/whiteport-design-studio/blob/main/src/modules/wds/docs/learn-wds/00-course-overview.md>
--- ---

View File

@ -31,7 +31,7 @@ project_structure:
delivery: delivery:
format: "{{delivery_format}}" # prd | wordpress | figma | prototype | direct-code | other format: "{{delivery_format}}" # prd | wordpress | figma | prototype | direct-code | other
target_platform: "{{target_platform}}" # wordpress | react | vue | html | custom target_platform: "{{target_platform}}" # wordpress | react | vue | html | custom
requires_prd: {{requires_prd}} # true | false requires_prd: "{{requires_prd}}" # true | false
description: "{{delivery_description}}" description: "{{delivery_description}}"
# Examples: # Examples:
# - "WordPress page editor code with markup and content sections" # - "WordPress page editor code with markup and content sections"
@ -43,10 +43,10 @@ config:
folder_prefix: "{{folder_prefix}}" # letters or numbers folder_prefix: "{{folder_prefix}}" # letters or numbers
folder_case: "{{folder_case}}" # title or lowercase folder_case: "{{folder_case}}" # title or lowercase
brief_level: "{{brief_level}}" # simplified or complete brief_level: "{{brief_level}}" # simplified or complete
include_design_system: { { include_design_system } } include_design_system: "{{include_design_system}}"
component_library: "{{component_library}}" component_library: "{{component_library}}"
specification_language: "{{specification_language}}" # Language for writing specs (EN, SE, etc.) specification_language: "{{specification_language}}" # Language for writing specs (EN, SE, etc.)
product_languages: { { product_languages } } # Array of languages product supports product_languages: "{{product_languages}}" # Array of languages product supports
# Folder mapping (generated based on config) # Folder mapping (generated based on config)
folders: folders:

View File

@ -8,7 +8,7 @@
--- ---
### 1. The Realization ## 1. The Realization
**Framework**: Problem-Agitate-Solve (PAS) - Start here **Framework**: Problem-Agitate-Solve (PAS) - Start here
@ -45,7 +45,7 @@
--- ---
### 2. Why It Matters ## 2. Why It Matters
**Framework**: Value Proposition Canvas + Impact - Understanding why this matters and who we help **Framework**: Value Proposition Canvas + Impact - Understanding why this matters and who we help
@ -65,7 +65,7 @@
--- ---
### 3. How We See It Working ## 3. How We See It Working
**Questions to explore**: **Questions to explore**:
- "How do you envision this working?" - "How do you envision this working?"
@ -78,7 +78,7 @@
--- ---
### 4. Paths We Explored ## 4. Paths We Explored
**Questions to explore**: **Questions to explore**:
- "What other ways could we approach this?" - "What other ways could we approach this?"
@ -91,7 +91,7 @@
--- ---
### 5. Recommended Solution ## 5. Recommended Solution
**Questions to explore**: **Questions to explore**:
- "Which approach do you prefer?" - "Which approach do you prefer?"
@ -102,7 +102,7 @@
--- ---
### 6. The Path Forward ## 6. The Path Forward
**Purpose**: Explain how the work will be done practically - which WDS phases will be used and the workflow approach. **Purpose**: Explain how the work will be done practically - which WDS phases will be used and the workflow approach.
@ -130,7 +130,7 @@
--- ---
### 7. The Value We'll Create ## 7. The Value We'll Create
**Framework**: Business Case Framework - What's the return? **Framework**: Business Case Framework - What's the return?
@ -157,7 +157,7 @@
--- ---
### 8. Cost of Inaction ## 8. Cost of Inaction
**Framework**: Problem-Agitate-Solve (PAS) - Agitate the problem / Business Case Framework **Framework**: Problem-Agitate-Solve (PAS) - Agitate the problem / Business Case Framework
@ -181,7 +181,7 @@
--- ---
### 9. Our Commitment ## 9. Our Commitment
**Framework**: Business Case Framework - What are we committing to? **Framework**: Business Case Framework - What are we committing to?
@ -201,7 +201,7 @@
--- ---
### 10. Summary ## 10. Summary
**Questions to explore**: **Questions to explore**:
- "What are the key points?" - "What are the key points?"

View File

@ -1,3 +1,6 @@
/* eslint-disable n/no-unsupported-features/node-builtins */
/* global document, window */
/** /**
* PROTOTYPE DEV MODE * PROTOTYPE DEV MODE
* *
@ -40,21 +43,28 @@ let currentHighlightedElement = null;
// ============================================================================ // ============================================================================
function initDevMode() { function initDevMode() {
const toggleButton = document.getElementById('dev-mode-toggle'); const toggleButton = document.querySelector('#dev-mode-toggle');
const tooltip = document.getElementById('dev-mode-tooltip'); const tooltip = document.querySelector('#dev-mode-tooltip');
if (!toggleButton || !tooltip) { if (!toggleButton || !tooltip) {
console.warn('⚠️ Dev Mode: Toggle button or tooltip not found'); console.warn('⚠️ Dev Mode: Toggle button or tooltip not found');
return; return;
} }
setupKeyboardShortcuts(); // Check if user agent supports clipboard API
setupToggleButton(toggleButton, tooltip); if (typeof navigator !== 'undefined' && navigator.clipboard) {
setupHoverHighlight(tooltip); // Clipboard API available
setupClickCopy(); } else {
console.warn('⚠️ Clipboard API not supported in this browser');
return;
}
console.log('%c💡 Dev Mode available: Press Ctrl+E or click the Dev Mode button', setupKeyboardShortcuts();
'color: #0066CC; font-weight: bold;'); setupToggleButton(toggleButton, tooltip);
setupHoverHighlight(tooltip);
setupClickCopy();
console.log('%c💡 Dev Mode available: Press Ctrl+E or click the Dev Mode button', 'color: #0066CC; font-weight: bold;');
} }
// ============================================================================ // ============================================================================
@ -62,39 +72,37 @@ function initDevMode() {
// ============================================================================ // ============================================================================
function setupKeyboardShortcuts() { function setupKeyboardShortcuts() {
// Track Shift key for container selection // Track Shift key for container selection
document.addEventListener('keydown', function(e) { document.addEventListener('keydown', (e) => {
if (e.key === 'Shift') { if (e.key === 'Shift') {
// Don't activate if user is typing in a form field // Don't activate if user is typing in a form field
if (isTypingInField()) { if (isTypingInField()) {
return; return;
} }
shiftKeyPressed = true; shiftKeyPressed = true;
document.body.classList.add('shift-held'); document.body.classList.add('shift-held');
if (devModeActive) { if (devModeActive) {
console.log('%c⬆ Shift held: Click any element to copy its Object ID', console.log('%c⬆ Shift held: Click any element to copy its Object ID', 'color: #10B981; font-weight: bold;');
'color: #10B981; font-weight: bold;'); }
} }
}
// Ctrl+E toggle // Ctrl+E toggle
if (e.ctrlKey && e.key === 'e') { if (e.ctrlKey && e.key === 'e') {
e.preventDefault(); e.preventDefault();
document.getElementById('dev-mode-toggle')?.click(); document.querySelector('#dev-mode-toggle')?.click();
} }
}); });
document.addEventListener('keyup', function(e) { document.addEventListener('keyup', (e) => {
if (e.key === 'Shift') { if (e.key === 'Shift') {
shiftKeyPressed = false; shiftKeyPressed = false;
document.body.classList.remove('shift-held'); document.body.classList.remove('shift-held');
if (devModeActive) { if (devModeActive) {
console.log('%c⬇ Shift released: Prototype works normally (hold Shift to copy)', console.log('%c⬇ Shift released: Prototype works normally (hold Shift to copy)', 'color: #6b7280;');
'color: #6b7280;'); }
} }
} });
});
} }
// ============================================================================ // ============================================================================
@ -102,34 +110,39 @@ function setupKeyboardShortcuts() {
// ============================================================================ // ============================================================================
function setupToggleButton(toggleButton, tooltip) { function setupToggleButton(toggleButton, tooltip) {
toggleButton.addEventListener('click', function(e) { toggleButton.addEventListener('click', function (e) {
e.stopPropagation(); e.stopPropagation();
devModeActive = !devModeActive; if (typeof globalThis !== 'undefined') {
globalThis.devModeActive = true;
} else if (globalThis.window !== undefined) {
globalThis.devModeActive = true;
}
devModeActive = !devModeActive;
// Update UI // Update UI
document.body.classList.toggle('dev-mode-active', devModeActive); document.body.classList.toggle('dev-mode-active', devModeActive);
toggleButton.classList.toggle('active', devModeActive); toggleButton.classList.toggle('active', devModeActive);
const statusText = toggleButton.querySelector('span'); const statusText = toggleButton.querySelector('span');
if (statusText) { if (statusText) {
statusText.textContent = devModeActive ? 'Dev Mode: ON' : 'Dev Mode: OFF'; statusText.textContent = devModeActive ? 'Dev Mode: ON' : 'Dev Mode: OFF';
} }
// Log status // Log status
console.log(`🔧 Dev Mode: ${devModeActive ? 'ACTIVATED' : 'DEACTIVATED'}`); console.log(`🔧 Dev Mode: ${devModeActive ? 'ACTIVATED' : 'DEACTIVATED'}`);
if (devModeActive) { if (devModeActive) {
console.log('%c🔧 DEV MODE ACTIVE', 'color: #0066CC; font-size: 16px; font-weight: bold;'); console.log('%c🔧 DEV MODE ACTIVE', 'color: #0066CC; font-size: 16px; font-weight: bold;');
console.log('%c⚠ Hold SHIFT + Click any element to copy its Object ID', 'color: #FFB800; font-size: 14px; font-weight: bold;'); console.log('%c⚠ Hold SHIFT + Click any element to copy its Object ID', 'color: #FFB800; font-size: 14px; font-weight: bold;');
console.log('%cWithout Shift: Prototype works normally', 'color: #6b7280;'); console.log('%cWithout Shift: Prototype works normally', 'color: #6b7280;');
console.log('%cPress Ctrl+E to toggle Dev Mode', 'color: #6b7280;'); console.log('%cPress Ctrl+E to toggle Dev Mode', 'color: #6b7280;');
} else { } else {
tooltip.style.display = 'none'; tooltip.style.display = 'none';
if (currentHighlightedElement) { if (currentHighlightedElement) {
clearHighlight(); clearHighlight();
} }
} }
}); });
} }
// ============================================================================ // ============================================================================
@ -137,55 +150,55 @@ function setupToggleButton(toggleButton, tooltip) {
// ============================================================================ // ============================================================================
function setupHoverHighlight(tooltip) { function setupHoverHighlight(tooltip) {
// Show tooltip and highlight on hover // Show tooltip and highlight on hover
document.addEventListener('mouseover', function(e) { document.addEventListener('mouseover', function (e) {
if (!devModeActive) return; if (!devModeActive) return;
// Don't highlight if user is typing in a field // Don't highlight if user is typing in a field
if (isTypingInField()) { if (isTypingInField()) {
tooltip.style.display = 'none'; tooltip.style.display = 'none';
clearHighlight(); clearHighlight();
return; return;
} }
clearHighlight(); clearHighlight();
let element = findElementWithId(e.target); let element = findElementWithId(e.target);
if (!element || !element.id || isSystemElement(element.id)) { if (!element || !element.id || isSystemElement(element.id)) {
tooltip.style.display = 'none'; tooltip.style.display = 'none';
return; return;
} }
// Highlight element // Highlight element
highlightElement(element, shiftKeyPressed); highlightElement(element, shiftKeyPressed);
currentHighlightedElement = element; currentHighlightedElement = element;
// Show tooltip // Show tooltip
const prefix = shiftKeyPressed ? '✓ Click to Copy: ' : '⬆️ Hold Shift + Click: '; const prefix = shiftKeyPressed ? '✓ Click to Copy: ' : '⬆️ Hold Shift + Click: ';
tooltip.textContent = prefix + element.id; tooltip.textContent = prefix + element.id;
tooltip.style.display = 'block'; tooltip.style.display = 'block';
tooltip.style.background = shiftKeyPressed ? '#10B981' : '#6b7280'; tooltip.style.background = shiftKeyPressed ? '#10B981' : '#6b7280';
tooltip.style.color = '#fff'; tooltip.style.color = '#fff';
updateTooltipPosition(e, tooltip); updateTooltipPosition(e, tooltip);
}); });
// Update tooltip position on mouse move // Update tooltip position on mouse move
document.addEventListener('mousemove', function(e) { document.addEventListener('mousemove', function (e) {
if (devModeActive && tooltip.style.display === 'block') { if (devModeActive && tooltip.style.display === 'block') {
updateTooltipPosition(e, tooltip); updateTooltipPosition(e, tooltip);
} }
}); });
// Clear highlight on mouse out // Clear highlight on mouse out
document.addEventListener('mouseout', function(e) { document.addEventListener('mouseout', function (e) {
if (!devModeActive) return; if (!devModeActive) return;
if (e.target.id) { if (e.target.id) {
tooltip.style.display = 'none'; tooltip.style.display = 'none';
clearHighlight(); clearHighlight();
} }
}); });
} }
// ============================================================================ // ============================================================================
@ -193,45 +206,49 @@ function setupHoverHighlight(tooltip) {
// ============================================================================ // ============================================================================
function setupClickCopy() { function setupClickCopy() {
// Use capture phase to intercept clicks with Shift // Use capture phase to intercept clicks with Shift
document.addEventListener('click', function(e) { document.addEventListener(
if (!devModeActive) return; 'click',
function (e) {
if (!devModeActive) return;
// Allow toggle button to work normally // Allow toggle button to work normally
if (isToggleButton(e.target)) return; if (isToggleButton(e.target)) return;
// ONLY copy if Shift is held // ONLY copy if Shift is held
if (!shiftKeyPressed) { if (!shiftKeyPressed) {
// Let prototype work normally without Shift // Let prototype work normally without Shift
return; return;
} }
// Don't intercept if user is clicking in/around a form field // Don't intercept if user is clicking in/around a form field
if (isTypingInField() || isFormElement(e.target)) { if (isTypingInField() || isFormElement(e.target)) {
return; return;
} }
// Shift is held and not in a form field - intercept and copy // Shift is held and not in a form field - intercept and copy
e.preventDefault(); e.preventDefault();
e.stopPropagation(); e.stopPropagation();
e.stopImmediatePropagation(); e.stopImmediatePropagation();
let element = findElementWithId(e.target); let element = findElementWithId(e.target);
if (!element || !element.id || isSystemElement(element.id)) {
console.log('❌ No Object ID found');
return false;
}
// Copy to clipboard
const objectId = element.id;
copyToClipboard(objectId);
// Show feedback
showCopyFeedback(element, objectId);
if (!element || !element.id || isSystemElement(element.id)) {
console.log('❌ No Object ID found');
return false; return false;
}, true); // Capture phase }
// Copy to clipboard
const objectId = element.id;
copyToClipboard(objectId);
// Show feedback
showCopyFeedback(element, objectId);
return false;
},
true,
); // Capture phase
} }
// ============================================================================ // ============================================================================
@ -239,175 +256,125 @@ function setupClickCopy() {
// ============================================================================ // ============================================================================
function findElementWithId(element) { function findElementWithId(element) {
let current = element; let current = element;
let attempts = 0; let attempts = 0;
while (current && !current.id && attempts < 10) { while (current && !current.id && attempts < 10) {
current = current.parentElement; current = current.parentElement;
attempts++; attempts++;
} }
return current; return current;
}
function findParentContainer(element) {
let current = element;
const maxLevels = 10;
let level = 0;
// Try to find semantic container parent first
while (current && current.id !== 'app' && level < maxLevels) {
if (current.parentElement && current.parentElement.id) {
const parentId = current.parentElement.id;
const parent = current.parentElement;
// Prefer semantic containers
if (parentId.includes('section') ||
parentId.includes('content') ||
parentId.includes('container') ||
parentId.includes('group') ||
parentId.includes('tabs') ||
parentId.includes('widget') ||
parentId.includes('modal') ||
parent.classList.contains('section') ||
parent.classList.contains('container') ||
parent.classList.contains('group')) {
return parent;
}
}
current = current.parentElement;
level++;
}
// Fallback: find any parent with ID
current = element.parentElement;
level = 0;
while (current && level < maxLevels) {
if (current.id && current.id !== 'app') {
return current;
}
current = current.parentElement;
level++;
}
return element;
} }
function isSystemElement(id) { function isSystemElement(id) {
const systemIds = ['app', 'dev-mode-toggle', 'dev-mode-tooltip']; const systemIds = ['app', 'dev-mode-toggle', 'dev-mode-tooltip'];
return systemIds.includes(id); return systemIds.includes(id);
} }
function isToggleButton(element) { function isToggleButton(element) {
return element.id === 'dev-mode-toggle' || return element.id === 'dev-mode-toggle' || element.closest('#dev-mode-toggle') || element.classList.contains('dev-mode-toggle');
element.closest('#dev-mode-toggle') ||
element.classList.contains('dev-mode-toggle');
} }
function isTypingInField() { function isTypingInField() {
const activeElement = document.activeElement; const activeElement = document.activeElement;
if (!activeElement) return false; if (!activeElement) return false;
const tagName = activeElement.tagName.toLowerCase(); const tagName = activeElement.tagName.toLowerCase();
const isEditable = activeElement.isContentEditable; const isEditable = activeElement.isContentEditable;
// Check if user is currently typing in a form field // Check if user is currently typing in a form field
return tagName === 'input' || return tagName === 'input' || tagName === 'textarea' || tagName === 'select' || isEditable;
tagName === 'textarea' ||
tagName === 'select' ||
isEditable;
} }
function isFormElement(element) { function isFormElement(element) {
if (!element) return false; if (!element) return false;
const tagName = element.tagName.toLowerCase(); const tagName = element.tagName.toLowerCase();
const isEditable = element.isContentEditable; const isEditable = element.isContentEditable;
// Check if the clicked element is a form element // Check if the clicked element is a form element
return tagName === 'input' || return tagName === 'input' || tagName === 'textarea' || tagName === 'select' || isEditable;
tagName === 'textarea' ||
tagName === 'select' ||
isEditable;
} }
function highlightElement(element, isShiftHeld) { function highlightElement(element, isShiftHeld) {
const color = isShiftHeld ? '#10B981' : '#6b7280'; const color = isShiftHeld ? '#10B981' : '#6b7280';
const width = isShiftHeld ? '3px' : '2px'; const width = isShiftHeld ? '3px' : '2px';
const offset = isShiftHeld ? '3px' : '2px'; const offset = isShiftHeld ? '3px' : '2px';
const shadowSpread = isShiftHeld ? '5px' : '2px'; const shadowSpread = isShiftHeld ? '5px' : '2px';
const shadowOpacity = isShiftHeld ? '0.4' : '0.2'; const shadowOpacity = isShiftHeld ? '0.4' : '0.2';
element.style.outline = `${width} solid ${color}`; element.style.outline = `${width} solid ${color}`;
element.style.outlineOffset = offset; element.style.outlineOffset = offset;
element.style.boxShadow = `0 0 0 ${shadowSpread} rgba(${isShiftHeld ? '16, 185, 129' : '107, 114, 128'}, ${shadowOpacity})`; element.style.boxShadow = `0 0 0 ${shadowSpread} rgba(${isShiftHeld ? '16, 185, 129' : '107, 114, 128'}, ${shadowOpacity})`;
} }
function clearHighlight() { function clearHighlight() {
if (currentHighlightedElement) { if (currentHighlightedElement) {
currentHighlightedElement.style.outline = ''; currentHighlightedElement.style.outline = '';
currentHighlightedElement.style.boxShadow = ''; currentHighlightedElement.style.boxShadow = '';
currentHighlightedElement = null; currentHighlightedElement = null;
} }
} }
function updateTooltipPosition(e, tooltip) { function updateTooltipPosition(e, tooltip) {
const offset = 15; const offset = 15;
let x = e.clientX + offset; let x = e.clientX + offset;
let y = e.clientY + offset; let y = e.clientY + offset;
// Keep tooltip on screen // Keep tooltip on screen
const rect = tooltip.getBoundingClientRect(); const rect = tooltip.getBoundingClientRect();
if (x + rect.width > window.innerWidth) { if (x + rect.width > window.innerWidth) {
x = e.clientX - rect.width - offset; x = e.clientX - rect.width - offset;
} }
if (y + rect.height > window.innerHeight) { if (y + rect.height > window.innerHeight) {
y = e.clientY - rect.height - offset; y = e.clientY - rect.height - offset;
} }
tooltip.style.left = x + 'px'; tooltip.style.left = x + 'px';
tooltip.style.top = y + 'px'; tooltip.style.top = y + 'px';
} }
function copyToClipboard(text) { function copyToClipboard(text) {
if (navigator.clipboard && navigator.clipboard.writeText) { if (typeof navigator !== 'undefined' && navigator.clipboard && navigator.clipboard.writeText) {
navigator.clipboard.writeText(text) navigator.clipboard
.then(() => { .writeText(text)
console.log(`📋 Copied to clipboard: ${text}`); .then(() => {
}) console.log(`📋 Copied to clipboard: ${text}`);
.catch(err => { })
console.error('Failed to copy:', err); .catch((error) => {
fallbackCopy(text); console.error('Dev Mode error:', error);
});
} else {
fallbackCopy(text); fallbackCopy(text);
} });
} else {
fallbackCopy(text);
}
} }
function fallbackCopy(text) { function fallbackCopy(text) {
const textarea = document.createElement('textarea'); const textarea = document.createElement('textarea');
textarea.value = text; textarea.value = text;
textarea.style.position = 'fixed'; textarea.style.position = 'fixed';
textarea.style.left = '-999999px'; textarea.style.left = '-999999px';
document.body.appendChild(textarea); document.body.append(textarea);
textarea.focus(); textarea.focus();
textarea.select(); textarea.select();
try { try {
document.execCommand('copy'); document.execCommand('copy');
console.log(`📋 Copied (fallback): ${text}`); console.log(`📋 Copied (fallback): ${text}`);
} catch (err) { } catch (error) {
console.error('Fallback copy failed:', err); console.error('Dev Mode error:', error);
} }
document.body.removeChild(textarea); textarea.remove();
} }
function showCopyFeedback(element, objectId) { function showCopyFeedback(element, objectId) {
// Create feedback overlay // Create feedback overlay
const feedback = document.createElement('div'); const feedback = document.createElement('div');
feedback.textContent = '✓ Copied: ' + objectId; feedback.textContent = '✓ Copied: ' + objectId;
feedback.style.cssText = ` feedback.style.cssText = `
position: fixed; position: fixed;
top: 50%; top: 50%;
left: 50%; left: 50%;
@ -424,18 +391,18 @@ function showCopyFeedback(element, objectId) {
pointer-events: none; pointer-events: none;
`; `;
document.body.appendChild(feedback); document.body.append(feedback);
setTimeout(() => { setTimeout(() => {
document.body.removeChild(feedback); feedback.remove();
}, 1500); }, 1500);
// Flash element // Flash element
const originalOutline = element.style.outline; const originalOutline = element.style.outline;
element.style.outline = '3px solid #10B981'; element.style.outline = '3px solid #10B981';
setTimeout(() => { setTimeout(() => {
element.style.outline = originalOutline; element.style.outline = originalOutline;
}, 300); }, 300);
} }
// Add CSS animation // Add CSS animation
@ -448,17 +415,16 @@ style.textContent = `
100% { opacity: 0; transform: translate(-50%, -50%) scale(0.9); } 100% { opacity: 0; transform: translate(-50%, -50%) scale(0.9); }
} }
`; `;
document.head.appendChild(style); document.head.append(style);
// ============================================================================ // ============================================================================
// EXPORT // EXPORT
// ============================================================================ // ============================================================================
// Make available globally // Make available globally
window.initDevMode = initDevMode; globalThis.initDevMode = initDevMode;
// Auto-initialize if this is included as module // Export for use in other scripts
if (typeof module !== 'undefined' && module.exports) { if (typeof globalThis !== 'undefined' && globalThis.exports) {
module.exports = { initDevMode }; globalThis.exports = { initDevMode };
} }

View File

@ -1,63 +1,63 @@
{ {
"user": { "user": {
"id": "demo-user-001", "id": "demo-user-001",
"firstName": "[First Name]", "firstName": "[First Name]",
"lastName": "[Last Name]", "lastName": "[Last Name]",
"email": "[email@example.com]", "email": "[email@example.com]",
"phoneNumber": "[+1234567890]", "phoneNumber": "[+1234567890]",
"picture": "", "picture": "",
"role": "owner", "role": "owner",
"createdAt": "2024-01-01T00:00:00.000Z", "createdAt": "2024-01-01T00:00:00.000Z",
"updatedAt": "2024-01-01T00:00:00.000Z" "updatedAt": "2024-01-01T00:00:00.000Z"
},
"family": {
"id": "demo-family-001",
"name": "[Family Name]",
"description": "[Brief family description]",
"location": "[City, Country]",
"picture": "",
"ownerId": "demo-user-001",
"createdAt": "2024-01-01T00:00:00.000Z",
"updatedAt": "2024-01-01T00:00:00.000Z"
},
"members": [
{
"id": "demo-member-001",
"familyId": "demo-family-001",
"userId": "demo-user-001",
"firstName": "[Member 1 First Name]",
"lastName": "[Member 1 Last Name]",
"email": "[member1@example.com]",
"role": "owner",
"picture": "",
"createdAt": "2024-01-01T00:00:00.000Z"
}, },
"family": { {
"id": "demo-family-001", "id": "demo-member-002",
"name": "[Family Name]", "familyId": "demo-family-001",
"description": "[Brief family description]", "userId": "demo-user-002",
"location": "[City, Country]", "firstName": "[Member 2 First Name]",
"picture": "", "lastName": "[Member 2 Last Name]",
"ownerId": "demo-user-001", "email": "[member2@example.com]",
"createdAt": "2024-01-01T00:00:00.000Z", "role": "co-owner",
"updatedAt": "2024-01-01T00:00:00.000Z" "picture": "",
}, "createdAt": "2024-01-02T00:00:00.000Z"
"members": [ }
{ ],
"id": "demo-member-001", "dogs": [
"familyId": "demo-family-001", {
"userId": "demo-user-001", "id": "demo-dog-001",
"firstName": "[Member 1 First Name]", "familyId": "demo-family-001",
"lastName": "[Member 1 Last Name]", "name": "[Dog Name]",
"email": "[member1@example.com]", "breed": "[Dog Breed]",
"role": "owner", "gender": "male",
"picture": "", "birthDate": "2020-05-15",
"createdAt": "2024-01-01T00:00:00.000Z" "color": "[Color]",
}, "specialNeeds": "[Any special needs or notes]",
{ "picture": "",
"id": "demo-member-002", "createdAt": "2024-01-01T00:00:00.000Z",
"familyId": "demo-family-001", "updatedAt": "2024-01-01T00:00:00.000Z"
"userId": "demo-user-002", }
"firstName": "[Member 2 First Name]", ],
"lastName": "[Member 2 Last Name]", "comment": "This is demo data that loads automatically when prototype is opened for the first time. Edit this file to change the demo data. All fields with empty strings ('') are optional."
"email": "[member2@example.com]",
"role": "co-owner",
"picture": "",
"createdAt": "2024-01-02T00:00:00.000Z"
}
],
"dogs": [
{
"id": "demo-dog-001",
"familyId": "demo-family-001",
"name": "[Dog Name]",
"breed": "[Dog Breed]",
"gender": "male",
"birthDate": "2020-05-15",
"color": "[Color]",
"specialNeeds": "[Any special needs or notes]",
"picture": "",
"createdAt": "2024-01-01T00:00:00.000Z",
"updatedAt": "2024-01-01T00:00:00.000Z"
}
],
"comment": "This is demo data that loads automatically when prototype is opened for the first time. Edit this file to change the demo data. All fields with empty strings ('') are optional."
} }

View File

@ -28,7 +28,7 @@ metadata:
- width: 428 - width: 428
height: 926 height: 926
device: "iPhone 14 Pro Max" device: "iPhone 14 Pro Max"
breakpoints: [] # For mobile-only, leave empty breakpoints: [] # For mobile-only, leave empty
touch_optimized: true touch_optimized: true
hover_interactions: false hover_interactions: false
@ -51,11 +51,11 @@ design_tokens:
tailwind_config: tailwind_config:
theme_extend: theme_extend:
colors: colors:
'[project-name]': "[project-name]":
50: '#eff6ff' 50: "#eff6ff"
500: '#2563eb' 500: "#2563eb"
600: '#1d4ed8' 600: "#1d4ed8"
700: '#1e40af' 700: "#1e40af"
fontFamily: fontFamily:
sans: "['Inter', 'system-ui', 'sans-serif']" sans: "['Inter', 'system-ui', 'sans-serif']"
@ -200,34 +200,34 @@ navigation:
testing_checklist: testing_checklist:
functionality: functionality:
- [ ] All form fields work - "[ ] All form fields work"
- [ ] Validation shows errors correctly - "[ ] Validation shows errors correctly"
- [ ] Submit button works - "[ ] Submit button works"
- [ ] Loading states display - "[ ] Loading states display"
- [ ] Success feedback shows - "[ ] Success feedback shows"
- [ ] Error handling works - "[ ] Error handling works"
- [ ] Navigation works (back, next) - "[ ] Navigation works (back, next)"
- [ ] Data persists (reload page test) - "[ ] Data persists (reload page test)"
mobile_testing: mobile_testing:
- [ ] Viewport is correct width - "[ ] Viewport is correct width"
- [ ] All tap targets min 44x44px - "[ ] All tap targets min 44x44px"
- [ ] Text is readable (min 16px) - "[ ] Text is readable (min 16px)"
- [ ] No horizontal scroll - "[ ] No horizontal scroll"
- [ ] Touch gestures work (if applicable) - "[ ] Touch gestures work (if applicable)"
code_quality: code_quality:
- [ ] All Object IDs present - "[ ] All Object IDs present"
- [ ] Console logs helpful - "[ ] Console logs helpful"
- [ ] No console errors - "[ ] No console errors"
- [ ] Tailwind classes properly used - "[ ] Tailwind classes properly used"
- [ ] Functions documented - "[ ] Functions documented"
accessibility: accessibility:
- [ ] Keyboard navigation works - "[ ] Keyboard navigation works"
- [ ] Form labels present - "[ ] Form labels present"
- [ ] Error messages clear - "[ ] Error messages clear"
- [ ] Focus states visible - "[ ] Focus states visible"
# ============================================================================ # ============================================================================
# MIGRATION NOTES (for production) # MIGRATION NOTES (for production)
@ -262,4 +262,3 @@ definition_of_done:
- "No console errors" - "No console errors"
- "Code is clean" - "Code is clean"
- "Story files document all sections" - "Story files document all sections"

View File

@ -0,0 +1,18 @@
---
name: UX Design Workflow
description: Transform ideas into detailed visual specifications through scenario-driven design using step-file architecture
main_config: "{project-root}/{bmad_folder}/wds/config.yaml"
web_bundle: true
---
# Workflow configuration for UX Design process
# This workflow handles the complete UX design phase from concept to implementation
phases:
- phase_1_project_brief
- phase_2_trigger_mapping
- phase_3_prd_platform
- phase_4_ux_design
- phase_5_design_system
- phase_6_design_deliveries
- phase_7_testing
- phase_8_ongoing_development

View File

@ -4,4 +4,15 @@ description: Transform ideas into detailed visual specifications through scenari
main_config: "{project-root}/{bmad_folder}/wds/config.yaml" main_config: "{project-root}/{bmad_folder}/wds/config.yaml"
web_bundle: true web_bundle: true
--- ---
# Workflow configuration for UX Design process
# This workflow handles the complete UX design phase from concept to implementation
phases:
- phase_1_project_brief
- phase_2_trigger_mapping
- phase_3_prd_platform
- phase_4_ux_design
- phase_5_design_system
- phase_6_design_deliveries
- phase_7_testing
- phase_8_ongoing_development

View File

@ -8,7 +8,7 @@ vtc:
# ========================================== # ==========================================
business_goal: business_goal:
primary: "500 newsletter signups in Q1" primary: "500 newsletter signups in Q1"
secondary: "" # Optional: Secondary goal this also supports secondary: "" # Optional: Secondary goal this also supports
# ========================================== # ==========================================
# SOLUTION # SOLUTION
@ -25,14 +25,13 @@ vtc:
description: "Hairdresser, ambitious, small-town salon owner" description: "Hairdresser, ambitious, small-town salon owner"
context: "Late evening, researching industry trends online" context: "Late evening, researching industry trends online"
current_state: "Wants to stay ahead of local competitors" current_state: "Wants to stay ahead of local competitors"
priority: "" # Optional: Priority score from Trigger Map priority: "" # Optional: Priority score from Trigger Map
# ========================================== # ==========================================
# DRIVING FORCES # DRIVING FORCES
# What motivates this user? # What motivates this user?
# ========================================== # ==========================================
driving_forces: driving_forces:
# Positive: Wishes, aspirations, what they want to achieve # Positive: Wishes, aspirations, what they want to achieve
positive: positive:
- "Wish to be the local beauty authority" - "Wish to be the local beauty authority"
@ -50,8 +49,8 @@ vtc:
# Where user starts → where we move them # Where user starts → where we move them
# ========================================== # ==========================================
customer_awareness: customer_awareness:
start: "Problem Aware" # Knows: Need to stay current start: "Problem Aware" # Knows: Need to stay current
end: "Product Aware" # Knows: Our newsletter helps end: "Product Aware" # Knows: Our newsletter helps
# Awareness stages: # Awareness stages:
# - Unaware: Doesn't know problem exists # - Unaware: Doesn't know problem exists
@ -70,20 +69,20 @@ metadata:
version: "1.0" version: "1.0"
# Source tracking # Source tracking
source: "creation" # "creation" (from scratch) or "trigger_map" (extracted) source: "creation" # "creation" (from scratch) or "trigger_map" (extracted)
trigger_map_path: "" # If extracted from Trigger Map, path to source trigger_map_path: "" # If extracted from Trigger Map, path to source
# Priorities (if from Trigger Map) # Priorities (if from Trigger Map)
business_goal_priority: "" # e.g., "1" or "High" business_goal_priority: "" # e.g., "1" or "High"
user_priority: "" # e.g., "1" or "High" user_priority: "" # e.g., "1" or "High"
# Usage context # Usage context
purpose: "product_pitch" # "product_pitch", "scenario", "prototype", etc. purpose: "product_pitch" # "product_pitch", "scenario", "prototype", etc.
phase: "Phase 1" # WDS phase where this VTC is used phase: "Phase 1" # WDS phase where this VTC is used
# Related files # Related files
related_documents: related_documents:
- "" # Path to Product Brief, Scenario, etc. - "" # Path to Product Brief, Scenario, etc.
# ========================================== # ==========================================
# NOTES & RATIONALE # NOTES & RATIONALE
@ -116,22 +115,22 @@ notes: |
# Track changes from Trigger Map if applicable # Track changes from Trigger Map if applicable
# ========================================== # ==========================================
refinements: refinements:
- type: "" # "added", "modified", "clarified" - type: "" # "added", "modified", "clarified"
element: "" # What was changed element: "" # What was changed
original: "" # Original from Trigger Map original: "" # Original from Trigger Map
updated: "" # Updated version in this VTC updated: "" # Updated version in this VTC
reason: "" # Why the change was made reason: "" # Why the change was made
# ========================================== # ==========================================
# VALIDATION CHECKLIST # VALIDATION CHECKLIST
# ========================================== # ==========================================
validation: validation:
coherence: false # Does this tell a coherent story? coherence: false # Does this tell a coherent story?
actionable: false # Can designers make decisions from this? actionable: false # Can designers make decisions from this?
specific: false # Are driving forces specific enough? specific: false # Are driving forces specific enough?
realistic: false # Does awareness progression make sense? realistic: false # Does awareness progression make sense?
measurable: false # Is business goal measurable? measurable: false # Is business goal measurable?
focused: false # Is this focused (not trying to serve everyone)? focused: false # Is this focused (not trying to serve everyone)?
# ========================================== # ==========================================
# EXAMPLE APPLICATIONS # EXAMPLE APPLICATIONS

View File

@ -20,12 +20,12 @@ project:
# Design System Configuration # Design System Configuration
design_system: design_system:
enabled: { { DESIGN_SYSTEM_ENABLED } } # true | false enabled: "{{DESIGN_SYSTEM_ENABLED}}" # true | false
mode: "{{DESIGN_SYSTEM_MODE}}" # "none" | "custom" | "library" mode: "{{DESIGN_SYSTEM_MODE}}" # "none" | "custom" | "library"
# If mode: custom # If mode: custom
figma: figma:
enabled: { { FIGMA_ENABLED } } # true | false enabled: "{{FIGMA_ENABLED}}" # true | false
file_url: "{{FIGMA_URL}}" # Figma file URL (if applicable) file_url: "{{FIGMA_URL}}" # Figma file URL (if applicable)
# If mode: library # If mode: library
@ -39,17 +39,17 @@ sketching:
# If tool: excalidraw # If tool: excalidraw
excalidraw: excalidraw:
enabled: { { EXCALIDRAW_ENABLED } } # true | false enabled: "{{EXCALIDRAW_ENABLED}}" # true | false
# Auto-export to PNG/SVG on save # Auto-export to PNG/SVG on save
auto_export: { { AUTO_EXPORT } } # true | false auto_export: "{{AUTO_EXPORT}}" # true | false
# Load WDS component library # Load WDS component library
use_library: { { USE_LIBRARY } } # true | false use_library: "{{USE_LIBRARY}}" # true | false
# Grid settings # Grid settings
grid_size: { { GRID_SIZE } } # pixels (recommended: 20) grid_size: "{{GRID_SIZE}}" # pixels (recommended: 20)
snap_to_grid: { { SNAP_TO_GRID } } # true | false snap_to_grid: "{{SNAP_TO_GRID}}" # true | false
# Default theme # Default theme
theme: "{{THEME}}" # "light" | "dark" theme: "{{THEME}}" # "light" | "dark"
@ -69,13 +69,13 @@ output:
workflow: workflow:
# Phase 4: UX Design # Phase 4: UX Design
ux_design: ux_design:
sketch_first: { { SKETCH_FIRST } } # true | false sketch_first: "{{SKETCH_FIRST}}" # true | false
ai_suggestions: { { AI_SUGGESTIONS } } # true | false ai_suggestions: "{{AI_SUGGESTIONS}}" # true | false
# Phase 5: Design System # Phase 5: Design System
design_system: design_system:
auto_extract: { { AUTO_EXTRACT } } # true | false auto_extract: "{{AUTO_EXTRACT}}" # true | false
similarity_threshold: { { SIMILARITY_THRESHOLD } } # 0.0-1.0 (recommended: 0.7) similarity_threshold: "{{SIMILARITY_THRESHOLD}}" # 0.0-1.0 (recommended: 0.7)
# Team Configuration # Team Configuration
team: team:

View File

@ -108,7 +108,7 @@ phases:
{{USER_INTENT_PHASE_4}} {{USER_INTENT_PHASE_4}}
# Scenario-level tracking # Scenario-level tracking
scenarios: scenarios: []
# Example structure - populated as scenarios are created: # Example structure - populated as scenarios are created:
# - id: "01-customer-onboarding" # - id: "01-customer-onboarding"
# name: "Customer Onboarding" # name: "Customer Onboarding"
@ -267,171 +267,163 @@ update_history:
# phase: "phase_4_ux_design" # phase: "phase_4_ux_design"
# changes: "Started Scenario 01: Customer Onboarding" # changes: "Started Scenario 01: Customer Onboarding"
--- # ============================================================================
# AGENT INSTRUCTIONS FOR USING THIS FILE # AGENT INSTRUCTIONS FOR USING THIS FILE
# ============================================================================
## During Project Initiation (Saga WDS Analyst Agent): # During Project Initiation (Saga WDS Analyst Agent):
#
**When creating the Product Brief**, walk through each phase and ask about user intentions: # When creating the Product Brief, walk through each phase and ask about user intentions:
#
### Phase 1: Project Brief (Always included) # Phase 1: Project Brief (Always included)
*No question - this is where we are now!* # No question - this is where we are now!
#
### Phase 2: Trigger Mapping # Phase 2: Trigger Mapping
**Ask**: "What are your intentions for Trigger Mapping? This phase helps us identify target users, personas, and business goals. # Ask: What are your intentions for Trigger Mapping? This phase helps us identify target users, personas, and business goals.
# Is this a customer-facing product where understanding user triggers is critical? Or an internal tool where we might skip this phase?
Is this a customer-facing product where understanding user triggers is critical? Or an internal tool where we might skip this phase?" #
# Capture: User's answer → {{USER_INTENT_PHASE_2}}
**Capture**: User's answer → `{{USER_INTENT_PHASE_2}}` # Decision: Set active: true or active: false based on answer
**Decision**: Set `active: true` or `active: false` based on answer #
# Phase 3: PRD Platform
### Phase 3: PRD Platform # Ask: What are your intentions for technical foundation? Do you already have a tech stack in mind, or do you need help defining architecture, data model, and infrastructure requirements?
**Ask**: "What are your intentions for the technical foundation? Do you already have a tech stack in mind, or do you need help defining the architecture, data model, and infrastructure requirements?" #
# Capture: User's answer → {{USER_INTENT_PHASE_3}}
**Capture**: User's answer → `{{USER_INTENT_PHASE_3}}` #
# Phase 4: UX Design
### Phase 4: UX Design # Ask: What are your intentions for UX Design? How many user scenarios or flows do you envision? Are you thinking MVP-focused (2-3 core scenarios) or comprehensive (5+ scenarios)?
**Ask**: "What are your intentions for UX Design? How many user scenarios or flows do you envision? Are you thinking MVP-focused (2-3 core scenarios) or comprehensive (5+ scenarios)?" #
# Capture: User's answer → {{USER_INTENT_PHASE_4}}
**Capture**: User's answer → `{{USER_INTENT_PHASE_4}}` # Note: Also capture estimated scenarios_planned number
**Note**: Also capture estimated `scenarios_planned` number #
# Phase 5: Design System
### Phase 5: Design System # Ask: What are your intentions for a Design System? Are you:
**Ask**: "What are your intentions for a Design System? Are you: # - Using an existing component library (shadcn/ui, MUI)?
- Using an existing component library (shadcn/ui, MUI)? # - Building custom components?
- Building custom components? # - Creating a multi-product design system?
- Creating a multi-product design system? # - Skipping this for MVP?
- Skipping this for MVP?" #
# Capture: User's answer → {{USER_INTENT_PHASE_5}}
**Capture**: User's answer → `{{USER_INTENT_PHASE_5}}` # Decision: Set active: false if skipping, add skip_reason
**Decision**: Set `active: false` if skipping, add `skip_reason` #
# Phase 6: Design Deliveries
### Phase 6: Design Deliveries # Ask: What are your intentions for design deliveries? Will you be handing off to a development team, or implementing directly from specifications?
**Ask**: "What are your intentions for design deliveries? Will you be handing off to a development team, or implementing directly from specifications?" #
# Capture: User's answer → {{USER_INTENT_PHASE_6}}
**Capture**: User's answer → `{{USER_INTENT_PHASE_6}}` #
# Phase 7: Testing
### Phase 7: Testing # Ask: What are your intentions for testing? Do you want to validate implementation against design specs, or handle testing separately?
**Ask**: "What are your intentions for testing? Do you want to validate the implementation against design specs, or handle testing separately?" #
# Capture: User's answer → {{USER_INTENT_PHASE_7}}
**Capture**: User's answer → `{{USER_INTENT_PHASE_7}}` #
# Phase 8: Ongoing Development
### Phase 8: Ongoing Development # Ask: Is this a new product or an existing product needing improvements?
**Ask**: "Is this a new product or an existing product needing improvements?" #
# Capture: User's answer → {{USER_INTENT_PHASE_8}}
**Capture**: User's answer → `{{USER_INTENT_PHASE_8}}` # Decision: Set active: false for new products
**Decision**: Set `active: false` for new products #
# ---------------------------------------------------------------------------
--- #
# On Agent Activation (ALL WDS Agents):
## On Agent Activation (ALL WDS Agents): #
# 1. CHECK if .wds-project-outline.yaml exists in docs/ or project root
1. **CHECK** if `.wds-project-outline.yaml` exists in docs/ or project root # 2. READ the outline to understand:
2. **READ** the outline to understand: # - Which phases are active
- Which phases are active # - User's intentions for each phase
- User's intentions for each phase # - Current status of each phase
- Current status of each phase # - What work has been completed
- What work has been completed # - What work is next
- What work is next # 3. SKIP analysis of inactive phases (active: false)
3. **SKIP** analysis of inactive phases (active: false) # 4. REPORT status based on outline (much faster than folder scanning)
4. **REPORT** status based on outline (much faster than folder scanning) #
# ---------------------------------------------------------------------------
--- #
# When Starting Scenario Work (Freya WDS Designer Agent):
## When Starting Scenario Work (Freya WDS Designer Agent): #
# Add new scenario to the outline:
Add new scenario to the outline: #
# yaml
```yaml # scenarios:
scenarios: # - id: "01-customer-onboarding"
- id: "01-customer-onboarding" # name: "Customer Onboarding"
name: "Customer Onboarding" # status: "in_progress"
status: "in_progress" # pages_planned: 9
pages_planned: 9 # pages_specified: 0
pages_specified: 0 # pages_implemented: 0
pages_implemented: 0 # started_date: "2024-12-10"
started_date: "2024-12-10" # completed_date: null
completed_date: null # intent: "Onboard new users from landing page to active family"
intent: "Onboard new users from landing page to active family" # artifacts: []
artifacts: [] #
``` # ---------------------------------------------------------------------------
#
--- # When Completing Scenario Work (Freya WDS Designer Agent):
#
## When Completing Scenario Work (Freya WDS Designer Agent): # Update scenario status:
#
Update scenario status: # yaml
# - id: "01-customer-onboarding"
```yaml # name: "Customer Onboarding"
- id: "01-customer-onboarding" # status: "complete"
name: "Customer Onboarding" # pages_planned: 9
status: "complete" # pages_specified: 9
pages_planned: 9 # pages_implemented: 5
pages_specified: 9 # started_date: "2024-12-01"
pages_implemented: 5 # completed_date: "2024-12-08"
started_date: "2024-12-01" # intent: "Onboard new users from landing page to active family"
completed_date: "2024-12-08" # artifacts:
intent: "Onboard new users from landing page to active family" # - "docs/4-ux-design/01-customer-onboarding/00-scenario-overview.md"
artifacts: # - "docs/4-ux-design/01-customer-onboarding/1.1-start-page.md"
- "docs/4-ux-design/01-customer-onboarding/00-scenario-overview.md" # - "docs/4-ux-design/01-customer-onboarding/sketches/*.excalidraw"
- "docs/4-ux-design/01-customer-onboarding/1.1-start-page.md" #
- "docs/4-ux-design/01-customer-onboarding/sketches/*.excalidraw" # Update phase-level counters:
``` # yaml
# scenarios_complete: 1 # Increment
Update phase-level counters: #
```yaml # ---------------------------------------------------------------------------
scenarios_complete: 1 # Increment #
``` # When Starting/Completing Phase Work (ALL Agents):
#
--- # Starting:
# yaml
## When Starting/Completing Phase Work (ALL Agents): # status: "in_progress"
# started_date: "2024-12-10"
**Starting:** #
```yaml # Completing:
status: "in_progress" # yaml
started_date: "2024-12-10" # status: "complete"
``` # completed_date: "2024-12-10"
# completed_by: "Freya WDS Designer Agent"
**Completing:** # artifacts:
```yaml # - "docs/4-ux-design/01-onboarding/*.md"
status: "complete" #
completed_date: "2024-12-10" # Add update history entry:
completed_by: "Freya WDS Designer Agent" # yaml
artifacts: # update_history:
- "docs/4-ux-design/01-onboarding/*.md" # - date: "2024-12-10"
``` # agent: "freya-designer"
# action: "completed"
Add update history entry: # phase: "phase_4_ux_design"
```yaml # changes: "Completed Scenario 01: 9 pages specified with prototypes"
update_history: #
- date: "2024-12-10" # ---------------------------------------------------------------------------
agent: "freya-designer" #
action: "completed" # Benefits:
phase: "phase_4_ux_design" #
changes: "Completed Scenario 01: 9 pages specified with prototypes" # ✅ User-driven planning - captures intentions upfront during project initiation
``` # ✅ 5x faster agent activation - no folder scanning needed
# ✅ Scenario-level tracking - granular progress visibility within UX Design phase
--- # ✅ Always up to date - agents update as they work
# ✅ Clear intent - explains WHY phases are skipped AND user's goals for each phase
## Benefits: # ✅ Project memory - tracks who did what and when
# ✅ Better recommendations - agents know exactly what's next
✅ **User-driven planning** - captures intentions upfront during project initiation #
✅ **5x faster agent activation** - no folder scanning needed # ---------------------------------------------------------------------------
✅ **Scenario-level tracking** - granular progress visibility within UX Design phase #
✅ **Always up to date** - agents update as they work # File Location:
✅ **Clear intent** - explains WHY phases are skipped AND user's goals for each phase #
✅ **Project memory** - tracks who did what and when # - Preferred: docs/.wds-project-outline.yaml
✅ **Better recommendations** - agents know exactly what's next # - Fallback: .wds-project-outline.yaml (project root)
# - Created by: Saga WDS Analyst Agent during Project Brief phase
--- # - Updated by: ALL WDS agents as work progresses
## File Location:
- Preferred: `docs/.wds-project-outline.yaml`
- Fallback: `.wds-project-outline.yaml` (project root)
- Created by: Saga WDS Analyst Agent during Project Brief phase
- Updated by: ALL WDS agents as work progresses