whiteport-design-studio 0.1.0

package/src/workflows/project-analysis/validation/deep-validation-before-work.md

@@ -0,0 +1,235 @@
+# Deep Validation Before Work (Tier 2)
+
+**Purpose**: Thoroughly validate selected section before starting work  
+**When**: User has selected a task, before agent begins working  
+**Time**: 5-10 seconds  
+**Scope**: ONLY the selected phase/scenario
+
+---
+
+## Why Deep Validation?
+
+**Problem**: User selects "Continue Scenario 03" but:
+
+- Outline says 8 pages, reality has 6
+- 2 pages deleted since outline update
+- Files modified recently, outline outdated
+- Dependencies changed
+
+**Solution**: Deep check ensures agent has accurate context before work starts.
+
+---
+
+## What to Check
+
+### 1. File Existence & Completeness
+
+**Check ALL files** claimed by outline for this section:
+
+```
+Outline claims for Scenario 03:
+  - 00-Scenario-Overview.md
+  - 3.1-Landing-Page.md
+  - 3.2-Feature-List.md
+  - 3.3-Pricing.md
+  - 3.4-FAQ.md
+  - Prototypes/sketch-landing.html
+
+Reality check:
+✅ 00-Scenario-Overview.md exists (2.3 KB)
+✅ 3.1-Landing-Page.md exists (15 KB)
+⚠️  3.2-Feature-List.md MISSING
+✅ 3.3-Pricing.md exists (8 KB)
+❌ 3.4-FAQ.md exists but EMPTY (0 KB)
+✅ Prototypes/ folder exists
+❌ sketch-landing.html MISSING from Prototypes/
+```
+
+### 2. File Count & Unexpected Files
+
+**Check for NEW files** not in outline:
+
+```
+Scanning docs/4-ux-design/03-pricing-page/...
+
+Found 7 files, outline claims 6:
+✅ Expected: 6 files
+⚠️  Found: 7 files
+📄 NEW: 3.5-Contact-Form.md (not in outline)
+```
+
+### 3. Modification Dates
+
+**Compare outline update vs file changes**:
+
+```
+Outline last updated: 2024-11-15
+Files modified:
+  - 3.1-Landing-Page.md: 2024-12-01 (AFTER outline)
+  - 3.3-Pricing.md: 2024-12-08 (AFTER outline)
+
+⚠️  Files changed since outline updated
+```
+
+### 4. Dependencies
+
+**For scenarios, check**:
+
+- Related scenarios referenced
+- Shared components mentioned
+- Design system dependencies
+
+```
+Scenario 03 references:
+  - Component: PricingCard (from Design System)
+  - Dependency: Scenario 01 (User auth flow)
+
+Checking dependencies:
+✅ docs/5-design-system/components/PricingCard.md exists
+⚠️  Scenario 01 shows "in_progress" but outline claims "complete"
+```
+
+---
+
+## Report Format
+
+```
+🎨 Freya WDS Designer Agent
+
+You selected: "Continue Scenario 03"
+
+Deep validation of Scenario 03... ⚠️ Issues found
+
+Validation Results:
+
+📁 Folder: docs/4-ux-design/03-pricing-page/
+✅ Folder exists and accessible
+
+📄 Files (Outline claims 6, found 7):
+✅ 00-Scenario-Overview.md (complete, 2.3 KB)
+✅ 3.1-Landing-Page.md (complete, 15 KB)
+❌ 3.2-Feature-List.md MISSING
+✅ 3.3-Pricing.md (complete, 8 KB, modified after outline)
+⚠️  3.4-FAQ.md exists but EMPTY (0 KB)
+📄 3.5-Contact-Form.md NEW (not in outline)
+
+🔗 Dependencies:
+✅ PricingCard component (Design System)
+⚠️  Scenario 01 dependency shows mismatch
+
+🕒 Timeline:
+Outline updated: 2024-11-15
+Files modified: 2024-12-01, 2024-12-08 (2 files changed after)
+
+💡 Before we continue, would you like to:
+
+1. **Update outline first** (recommended)
+   - Add 3.5-Contact-Form.md to outline
+   - Mark 3.2-Feature-List.md as missing/deleted
+   - Update page count (6 → 5 existing + 1 new)
+   - Refresh last_updated date
+
+2. **Fix missing/empty files**
+   - Recreate 3.2-Feature-List.md
+   - Complete 3.4-FAQ.md content
+   - Then continue work
+
+3. **Proceed anyway**
+   - I'll work with current state
+   - Update outline after work complete
+
+Which approach would you prefer?
+```
+
+---
+
+## Decision Tree
+
+```
+After deep validation:
+
+All valid? ✅
+    ↓
+Start work immediately
+
+Minor issues? ⚠️
+    ↓
+Ask user:
+  - Update outline?
+  - Proceed anyway?
+    ↓
+User chooses → Continue
+
+Major issues? ❌
+    ↓
+Strongly recommend:
+  - Fix missing files
+  - Update outline
+  - Review dependencies
+    ↓
+Don't start work until resolved
+```
+
+---
+
+## After Validation
+
+**If user chooses "Update outline first"**:
+
+1. Agent updates `.wds-project-outline.yaml`
+2. Reflects current reality
+3. Then starts work
+
+**If user chooses "Fix missing files"**:
+
+1. Agent helps recreate/complete files
+2. Updates outline
+3. Then continues with original task
+
+**If user chooses "Proceed anyway"**:
+
+1. Agent works with current state
+2. Updates outline AFTER work complete
+3. Documents what was found vs expected
+
+---
+
+## Example: Freya Deep Validation
+
+```
+User: "Continue Scenario 03"
+
+Freya: "Let me validate Scenario 03 before we start..."
+
+[5 seconds of checking]
+
+Freya: "I found the scenario folder with 5 pages:
+- Landing page (complete)
+- Pricing tiers (complete)
+- FAQ (in progress)
+- Contact form (not in outline - did you add this recently?)
+- Missing: Feature comparison page
+
+The outline expected 6 pages but I found 5 (one missing, one new).
+
+Before designing more pages, shall I:
+1. Update the outline to reflect these 5 pages?
+2. Recreate the missing feature comparison page?
+3. Continue with existing pages as-is?
+
+What would work best for you?"
+```
+
+---
+
+## Benefits
+
+✅ **Prevents wasted work** - Agent knows true state  
+✅ **Catches drift early** - Before it compounds  
+✅ **Keeps outline accurate** - Forces sync with reality  
+✅ **User stays informed** - Knows what's actually there  
+✅ **Reduces confusion** - No surprises mid-work
+
+---
+
+**This is the second safety net after Tier 1 fast check!** 🛡️

package/src/workflows/project-analysis/work-types/strategy-work.md

@@ -0,0 +1,88 @@
+# Strategy & Research Work
+
+**You were routed here because**: User selected strategy/research work (Product Brief or Trigger Map)
+
+---
+
+## What This Work Involves
+
+**Strategy and research work** includes:
+
+- Product vision and positioning
+- Market and competitive analysis
+- User research and personas
+- Business goals and success metrics
+- Trigger mapping and user journeys
+
+---
+
+## Recommended Agent
+
+**Saga WDS Analyst Agent** specializes in this type of work (Phases 1-2).
+
+**If you're NOT Saga**, here's how to hand over:
+
+---
+
+## Seamless Handoff to Saga
+
+"I can see you want to work on **[Product Brief/Trigger Map]** - strategic foundation work.
+
+**Saga WDS Analyst Agent** specializes in strategy and research. She's brilliant at:
+
+- Defining product vision and positioning
+- Market intelligence and competitive analysis
+- User research and persona development
+- Business strategy and success metrics
+
+Let me hand over to Saga who can help you best with this..."
+
+**Then activate Saga** but skip project analysis:
+
+→ Load: `getting-started/agent-activation/wds-saga-analyst.md`  
+→ Saga shows: Full presentation ✅  
+→ Saga skips: Project analysis (already shown)  
+→ Saga continues: Directly to the specific work
+
+**Task context to pass**: "User wants to work on: [Product Brief/Trigger Map]"
+
+---
+
+## If You ARE Saga
+
+**Context aware handoff**: The user already selected a specific task, so you don't need to re-analyze the project.
+
+Continue directly with the work:
+
+"Great! Let's work on the **[specific task user selected]** together.
+
+[Ask clarifying questions specific to their selection]
+[Engage directly with the work]
+[Offer specific next steps]"
+
+**For Product Brief review**:
+"Let's review the Product Brief together.
+
+What aspect would you like to focus on?
+
+- Vision and positioning - Is it still aligned with where you're heading?
+- Competitive landscape - Has anything changed in the market?
+- Success metrics - Are we measuring the right things?
+- Target users - Do we need to refine our understanding?
+
+Tell me what you'd like to explore!"
+
+**For Trigger Map work**:
+"Let's dive into the Trigger Map!
+
+What would you like to work on?
+
+- Refining user personas - Add depth or new segments?
+- Updating journey maps - Has user behavior changed?
+- Feature prioritization - What should we focus on?
+
+Tell me what you'd like to explore!"
+
+---
+
+**The goal**: Get the right agent working on the right work, seamlessly.

package/src/workflows/project-analysis/workflow.yaml

@@ -0,0 +1,82 @@
+---
+name: project-analysis
+description: Systematic analysis of project structure and completion status
+author: "Whiteport Design Studio"
+web_bundle: true
+standalone: true
+primary_agent: "freya-ux"
+
+trigger:
+    on_activation: true
+    keywords: ["analyze", "status", "where are we", "project overview"]
+
+  phases:
+    - phase: identify
+      name: Identify Project Structure
+      task: identify-project-structure
+      output: project_structure
+      # Detects: v6 (WDS numbered workflows) | v4 (WPS2C letter folders) | unknown
+
+    - phase: analyze_v6
+      name: Analyze WDS v6 Project
+      depends_on: identify
+      condition: project_structure == "wds_v6"
+      tasks:
+        - check-phase-1-project-brief
+        - check-phase-2-trigger-mapping
+        - check-phase-3-prd-platform
+        - check-phase-4-ux-design
+        - check-phase-5-design-system
+        - check-phase-6-design-deliveries
+        - check-phase-7-testing
+        - check-phase-8-ongoing-development
+      output: project_status
+
+    - phase: analyze_v4
+      name: Analyze WPS2C v4 Project
+      depends_on: identify
+      condition: project_structure == "wps2c_v4"
+      action: fetch_wps2c_instructions
+      github_repo: "whiteport-sketch-to-code-bmad-expansion"
+      github_path: "docs/agents/freya-ux.md"
+      output: project_status
+
+    - phase: recommend
+      name: Recommend Next Actions
+      depends_on: analyze
+      output: recommendations
+
+  presentation:
+    style: branded
+    greeting: "🎨 Freya - WDS Designer Agent"
+    working: "Analyzing your workspace..."
+    format:
+      complete: "✅"
+      in_progress: "🔄"
+      not_started: "📋"
+      suggestion: "💡"
+    max_lines: 20
+
+  agent_handoffs:
+    empty_project:
+      agent: saga-analyst
+      reason: "Saga WDS Analyst Agent - Project needs initial Product Brief"
+    phase_1_project_brief:
+      agent: saga-analyst
+      reason: "Saga WDS Analyst Agent - Specializes in stakeholder interviews and requirements"
+    phase_2_trigger_mapping:
+      agent: saga-analyst
+      reason: "Saga WDS Analyst Agent - Specializes in user research and persona development"
+    phase_3_prd_platform:
+      agent: idunn-pm
+      reason: "Idunn WDS PM Agent - Handles PRD and technical architecture"
+    phase_4_ux_design:
+      agent: freya-ux
+      reason: "Freya WDS Designer Agent - Specializes in UX design and scenario creation"
+    phase_5_design_system:
+      agent: freya-ux
+      reason: "Freya WDS Designer Agent - Manages design system development"
+    phase_6_7_8_development:
+      agent: idunn-pm
+      reason: "Idunn WDS PM Agent - Handles deliveries, testing, and ongoing development"
+---