whiteport-design-studio 0.1.0

package/src/workflows/paths/feature-enhancement.yaml

@@ -0,0 +1,93 @@
+---
+path_name: "Feature Enhancement"
+path_id: "feature-enhancement"
+description: "Design workflow for adding features to existing products"
+
+# Context + Phases 2, 4, 6 - for adding features to existing products
+
+phases:
+  - phase: 1
+    name: "Project Brief"
+    artifact: "Project Brief"
+    folder_letter: "A"
+    folder_number: "01"
+    folder_name: "Product-Brief"
+    required: true
+    brief_options:
+      - level: "simplified"
+        workflows:
+          - id: "simplified-brief"
+            required: true
+            agent: "saga-analyst"
+            command: "simplified-brief"
+            output: "Simplified brief: feature scope, challenge, opportunity, goals"
+            note: "5-10 minutes - establish context for the feature"
+      - level: "complete"
+        workflows:
+          - id: "product-exploration"
+            required: true
+            agent: "saga-analyst"
+            command: "product-exploration"
+            output: "Complete Project Brief"
+            note: "When feature is strategically significant"
+
+  - phase: 2
+    name: "Trigger Mapping"
+    artifact: "Trigger Map"
+    folder_letter: "B"
+    folder_number: "02"
+    folder_name: "Trigger-Map"
+    required: true
+    workflows:
+      - id: "trigger-mapping"
+        required: true
+        agent: "saga-analyst"
+        command: "trigger-mapping"
+        output: "Feature-focused Trigger Map with user goals and priorities"
+        note: "Focus on the specific user needs this feature addresses"
+
+  - phase: 4
+    name: "UX Design"
+    artifact: "Scenarios"
+    folder_letter: "C"
+    folder_number: "02"
+    folder_name: "Scenarios"
+    required: true
+    workflows:
+      - id: "ux-design"
+        required: true
+        agent: "freya-wds-designer"
+        command: "ux-design"
+        output: "Feature specifications, prototypes, functional requirements"
+        note: "Design the new feature flows"
+
+  - phase: 5
+    name: "Design System"
+    artifact: "Component Library"
+    folder_letter: "D"
+    folder_number: "03"
+    folder_name: "Design-System"
+    conditional: "include_design_system"
+    workflows:
+      - id: "design-system"
+        conditional: "include_design_system"
+        agent: "freya-wds-designer"
+        command: "design-system"
+        output: "New components for the feature"
+        note: "Only if feature introduces new component patterns"
+
+  - phase: 6
+    name: "PRD Finalization"
+    artifact: "Feature PRD"
+    folder_letter: "E"
+    folder_number: "04"
+    folder_name: "PRD-Finalization"
+    required: true
+    workflows:
+      - id: "prd-finalization"
+        required: true
+        agent: "idunn-wds-pm"
+        command: "prd-finalization"
+        output: "Feature requirements, integration notes, handoff"
+        note: "Compile feature requirements for development"
+---

package/src/workflows/paths/full-product.yaml

@@ -0,0 +1,96 @@
+---
+path_name: "Full Product"
+path_id: "full-product"
+description: "Complete design methodology for new products, platforms, and complex applications"
+
+# All 6 phases - complete design journey from vision to handoff
+
+phases:
+  - phase: 1
+    name: "Project Brief"
+    artifact: "Project Brief"
+    folder_letter: "A"
+    folder_number: "01"
+    folder_name: "Product-Brief"
+    required: true
+    brief_level: "complete"
+    workflows:
+      - id: "product-exploration"
+        required: true
+        agent: "saga-analyst"
+        command: "product-exploration"
+        output: "Complete Project Brief with vision, positioning, success criteria"
+
+  - phase: 2
+    name: "Trigger Mapping"
+    artifact: "Trigger Map"
+    folder_letter: "B"
+    folder_number: "02"
+    folder_name: "Trigger-Map"
+    required: true
+    workflows:
+      - id: "trigger-mapping"
+        required: true
+        agent: "saga-analyst"
+        command: "trigger-mapping"
+        output: "Trigger Map with personas, goals, Feature Impact Analysis"
+
+  - phase: 3
+    name: "PRD Platform"
+    artifact: "Technical Foundation"
+    folder_letter: "C"
+    folder_number: "03"
+    folder_name: "Platform-Requirements"
+    required: true
+    workflows:
+      - id: "prd-platform"
+        required: true
+        agent: "idunn-wds-pm"
+        command: "prd-platform"
+        output: "Platform architecture, data model, proofs of concept"
+
+  - phase: 4
+    name: "UX Design"
+    artifact: "Scenarios"
+    folder_letter: "C"
+    folder_number: "03"
+    folder_name: "Scenarios"
+    required: true
+    workflows:
+      - id: "ux-design"
+        required: true
+        agent: "freya-wds-designer"
+        command: "ux-design"
+        output: "Page specifications, prototypes, functional requirements"
+        note: "Run iteratively for each scenario. Step 4E updates PRD."
+
+  - phase: 5
+    name: "Design System"
+    artifact: "Component Library"
+    folder_letter: "D"
+    folder_number: "04"
+    folder_name: "Design-System"
+    conditional: "include_design_system"
+    workflows:
+      - id: "design-system"
+        conditional: "include_design_system"
+        agent: "freya-wds-designer"
+        command: "design-system"
+        output: "Component documentation, HTML showcase"
+        note: "Runs in parallel with Phase 4"
+
+  - phase: 6
+    name: "PRD Finalization"
+    artifact: "Complete PRD"
+    folder_letter: "E"
+    folder_number: "05"
+    folder_name: "PRD-Finalization"
+    required: true
+    workflows:
+      - id: "prd-finalization"
+        required: true
+        agent: "idunn-wds-pm"
+        command: "prd-finalization"
+        output: "Complete PRD, development roadmap, handoff package"
+        note: "Can run multiple times as design progresses"
+---

package/src/workflows/paths/landing-page.yaml

@@ -0,0 +1,54 @@
+---
+path_name: "Landing Page"
+path_id: "landing-page"
+description: "Streamlined design for marketing sites, single-page apps, and simple projects"
+
+# Context + Phases 4, optional 5 - streamlined for simple projects
+
+phases:
+  - phase: 1
+    name: "Project Brief"
+    artifact: "Project Brief"
+    folder_letter: "A"
+    folder_number: "01"
+    folder_name: "Product-Brief"
+    required: true
+    brief_level: "simplified"
+    workflows:
+      - id: "simplified-brief"
+        required: true
+        agent: "saga-analyst"
+        command: "simplified-brief"
+        output: "Simplified brief: scope, challenge, opportunity, goals"
+        note: "5-10 minutes - perfect for simple landing pages"
+
+  - phase: 4
+    name: "UX Design"
+    artifact: "Scenarios"
+    folder_letter: "C"
+    folder_number: "02"
+    folder_name: "Scenarios"
+    required: true
+    workflows:
+      - id: "ux-design"
+        required: true
+        agent: "freya-wds-designer"
+        command: "ux-design"
+        output: "Page specifications, prototypes"
+        note: "Usually just 1-3 pages for landing page projects"
+
+  - phase: 5
+    name: "Design System"
+    artifact: "Component Library"
+    folder_letter: "D"
+    folder_number: "03"
+    folder_name: "Design-System"
+    conditional: "include_design_system"
+    workflows:
+      - id: "design-system"
+        conditional: "include_design_system"
+        agent: "freya-wds-designer"
+        command: "design-system"
+        output: "Component documentation"
+        note: "Optional - skip for truly simple one-off pages"
+---

package/src/workflows/paths/quick-prototype.yaml

@@ -0,0 +1,39 @@
+---
+path_name: "Quick Prototype"
+path_id: "quick-prototype"
+description: "Rapid prototyping with essential context"
+
+# Context + Phase 4 - rapid prototyping with context
+
+phases:
+  - phase: 1
+    name: "Project Brief"
+    artifact: "Project Brief"
+    folder_letter: "A"
+    folder_number: "01"
+    folder_name: "Product-Brief"
+    required: true
+    brief_level: "simplified"
+    workflows:
+      - id: "simplified-brief"
+        required: true
+        agent: "saga-analyst"
+        command: "simplified-brief"
+        output: "Simplified brief: scope, challenge, opportunity, goals"
+        note: "5-10 minutes to establish context for agents"
+
+  - phase: 4
+    name: "UX Design"
+    artifact: "Prototype"
+    folder_letter: "C"
+    folder_number: "02"
+    folder_name: "Scenarios"
+    required: true
+    workflows:
+      - id: "ux-design"
+        required: true
+        agent: "freya-wds-designer"
+        command: "ux-design"
+        output: "Quick specifications and HTML prototypes"
+        note: "Focus on getting something visible fast"
+---

package/src/workflows/project-analysis/AGENT-INITIATION-FLOW.md

@@ -0,0 +1,295 @@
+# Agent Initiation Flow - Complete Diagram
+
+## 🎬 **Full Agent Activation Sequence**
+
+```
+┌─────────────────────────────────────────┐
+│  USER ACTIVATES FREYA                    │
+│  @freya-ux.agent.yaml                  │
+│  "Help me with Dog Week design"         │
+└──────────────┬──────────────────────────┘
+               │
+               ▼
+┌─────────────────────────────────────────┐
+│  STEP 0: CHECK FOR PROJECT OUTLINE      │
+│  Look for: docs/.wds-project-outline.yaml│
+└──────────────┬──────────────────────────┘
+               │
+        ┌──────┴──────┐
+        │             │
+    FOUND         NOT FOUND
+        │             │
+        ▼             ▼
+┌───────────────┐  ┌────────────────────┐
+│  FAST PATH    │  │  FALLBACK PATH     │
+│  (< 5 sec)    │  │  (30-60 sec)       │
+└───┬───────────┘  └────┬───────────────┘
+    │                   │
+    │                   ▼
+    │            ┌────────────────────────┐
+    │            │ STEP 1: Branded        │
+    │            │ "🎨 Freya WDS         │
+    │            │  Designer Agent"       │
+    │            └────┬───────────────────┘
+    │                 │
+    │                 ▼
+    │            ┌────────────────────────┐
+    │            │ STEP 2: Identify       │
+    │            │ Project Structure      │
+    │            │ • Check for numbered   │
+    │            │   folders (WDS v6)     │
+    │            │ • Check for letter     │
+    │            │   folders (WPS2C v4)   │
+    │            │ • Detect methodology   │
+    │            └────┬───────────────────┘
+    │                 │
+    │                 ▼
+    │            ┌────────────────────────┐
+    │            │ STEP 3: Scan Folders   │
+    │            │ • List each phase      │
+    │            │ • Count files          │
+    │            │ • Check completion     │
+    │            │ (SLOW - many I/O ops)  │
+    │            └────┬───────────────────┘
+    │                 │
+    │                 ▼
+    │            ┌────────────────────────┐
+    │            │ STEP 4: Generate Report│
+    │            │ Based on folder scan   │
+    │            └────┬───────────────────┘
+    │                 │
+    ▼                 │
+┌───────────────────────────────────┐
+│ STEP 1.5: PROCESS OUTLINE DATA    │◀──┘
+│                                   │
+│ Read from outline:                │
+│ ┌───────────────────────────────┐ │
+│ │ methodology:                  │ │
+│ │   type: "wps2c-v4"            │ │
+│ │                               │ │
+│ │ phases:                       │ │
+│ │   phase_4_ux_design:          │ │
+│ │     active: true              │ │
+│ │     status: "in_progress"     │ │
+│ │     folder: "C-Scenarios"     │ │
+│ │     intent: "3 MVP scenarios" │ │
+│ │     scenarios:                │ │
+│ │       - id: "01-onboarding"   │ │
+│ │         status: "complete"    │ │
+│ │         pages_specified: 9    │ │
+│ │         pages_implemented: 5  │ │
+│ └───────────────────────────────┘ │
+│                                   │
+│ Load methodology instructions:    │
+│ • wps2c-v4-instructions.md        │
+│ • Know folder pattern: {letter}-  │
+│ • Know phase structure: A-G       │
+└───────────────┬───────────────────┘
+                │
+                ▼
+┌─────────────────────────────────────────┐
+│  GENERATE SMART STATUS REPORT           │
+│                                         │
+│  ✅ Phase 2: Trigger Map (Complete)     │
+│     └─ Intent: Swedish families focus   │
+│                                         │
+│  🔄 Phase 4: UX Design (In Progress)    │
+│     ├─ Intent: 3 MVP scenarios          │
+│     ├─ Scenario 01: Complete            │
+│     │   (9 pages, 5 implemented)        │
+│     └─ Scenario 03: In progress         │
+│                                         │
+│  📋 Phase 5: Design System (Skipped)    │
+│     └─ Reason: Using shadcn/ui          │
+│                                         │
+│  💡 Recommendations:                    │
+│  1. Complete Scenario 03 implementation │
+│  2. Test pages 1.1-1.5 against specs    │
+│  3. Start Scenario 02 if needed         │
+│                                         │
+│  Which would you like to work on?       │
+└─────────────────────────────────────────┘
+```
+
+---
+
+## 🔑 **Key Improvements from Methodology Integration**
+
+### **1. Methodology Detection**
+
+**FAST PATH (with outline):**
+
+```yaml
+# Reads from outline
+methodology.type: "wps2c-v4"
+→ Loads: wps2c-v4-instructions.md
+→ Knows: Folders are {letter}-{name}
+→ Knows: C-Scenarios is Phase 4
+```
+
+**FALLBACK PATH (no outline):**
+
+```python
+# Scans folders
+if folders match "1-*", "2-*", "4-*":
+    methodology = "wds-v6"
+elif folders match "A-*", "B-*", "C-*":
+    methodology = "wps2c-v4"
+else:
+    ask_user_which_methodology()
+```
+
+---
+
+### **2. User Intentions Display**
+
+**FROM OUTLINE:**
+
+```yaml
+phase_4_ux_design:
+  intent: |
+    Create 3 core MVP scenarios:
+    - Customer onboarding
+    - Profile management  
+    - Calendar booking
+```
+
+**IN REPORT:**
+
+```
+🔄 Phase 4: UX Design (In Progress)
+   └─ Intent: Create 3 core MVP scenarios
+```
+
+**USER SEES THEIR OWN WORDS!** ✨
+
+---
+
+### **3. Scenario-Level Tracking**
+
+**FROM OUTLINE:**
+
+```yaml
+scenarios:
+  - id: '01-customer-onboarding'
+    status: 'complete'
+    pages_specified: 9
+    pages_implemented: 5
+    intent: 'Onboard users to active family'
+```
+
+**IN REPORT:**
+
+```
+├─ Scenario 01: Customer Onboarding (Complete)
+│   ├─ 9 pages specified
+│   ├─ 5 pages implemented
+│   └─ Next: Implement pages 1.6-1.9
+```
+
+**GRANULAR PROGRESS!** 📊
+
+---
+
+### **4. Skip Reasons**
+
+**FROM OUTLINE:**
+
+```yaml
+phase_5_design_system:
+  active: false
+  skip_reason: 'Using shadcn/ui component library'
+```
+
+**IN REPORT:**
+
+```
+📋 Phase 5: Design System (Skipped)
+   └─ Reason: Using shadcn/ui component library
+```
+
+**CONTEXT PRESERVED!** 🎯
+
+---
+
+## ⚡ **Performance Comparison**
+
+| Operation            | Without Outline | With Outline |
+| -------------------- | --------------- | ------------ |
+| **Check outline**    | -               | <1s          |
+| **Load methodology** | -               | <1s          |
+| **Scan folders**     | 10-20s          | SKIPPED      |
+| **Read files**       | 10-20s          | SKIPPED      |
+| **Count lines**      | 5-10s           | SKIPPED      |
+| **Generate report**  | 5-10s           | <2s          |
+| **TOTAL**            | **30-60s**      | **<5s**      |
+
+**Result**: **6-12x FASTER** activation! ⚡
+
+---
+
+## 🎨 **Example: Dog Week Project**
+
+### **Outline Contents:**
+
+```yaml
+methodology:
+  type: 'wps2c-v4'
+
+phases:
+  phase_4_ux_design:
+    folder: 'C-Scenarios'
+    intent: 'Mobile-first Swedish family dog coordination'
+    scenarios:
+      - id: '01-customer-onboarding'
+        pages_specified: 9
+        pages_implemented: 5
+      - id: '03-booking-dog-walks'
+        pages_specified: 1
+        pages_implemented: 0
+```
+
+### **Freya's Response:**
+
+```
+🎨 Freya WDS Designer Agent
+
+Reading project outline... ✅ (WPS2C v4 methodology detected)
+
+🔄 Phase 4: UX Design (In Progress)
+   Intent: Mobile-first Swedish family dog coordination
+
+   Scenario 01: Customer Onboarding (Partially Implemented)
+   ├─ 9 pages specified with object IDs
+   ├─ 5 pages implemented (1.1-1.5)
+   └─ 📋 Ready: Pages 1.6-1.9 (Add Dog, Add Family Member)
+
+   Scenario 03: Dog Calendar Booking (Specified)
+   ├─ Complete spec with Swedish week system
+   ├─ Interactive HTML prototype exists
+   └─ 📋 Ready for implementation
+
+💡 I can help you with:
+1. Implement pages 1.6-1.9 (complete onboarding flow)
+2. Implement Scenario 03 (calendar booking system)
+3. Review/refine existing specifications
+4. Design additional scenarios if needed
+
+What would you like to focus on?
+```
+
+**Time taken: <5 seconds**
+**User sees their intentions + granular progress + smart recommendations!**
+
+---
+
+**Does this flow make sense now?** 🎯
+
+The key is:
+
+1. ✅ Agent checks for outline FIRST
+2. ✅ Outline contains methodology + intentions + status
+3. ✅ Agent loads methodology instructions
+4. ✅ Agent uses outline data (doesn't scan folders)
+5. ✅ Agent generates smart, contextual report
+6. ✅ If no outline: fallback to folder scanning + suggest creating one