whiteport-design-studio 0.1.0

package/src/workflows/9-agent-dialogs/steps/step-05-complete-dialog.md

@@ -0,0 +1,177 @@
+# Step 5: Complete Dialog
+
+## CONTEXT
+
+All implementation steps are complete. Now we finalize the dialog, capture learnings, and close it out.
+
+---
+
+## VERIFY COMPLETION
+
+<action>
+**Review the Steps Overview table:**
+
+Confirm all steps have status:
+- ✅ Complete
+- ❌ Skipped (with documented reason)
+
+No steps should be:
+- 🔲 Not Started
+- 🔄 In Progress
+- ⏸️ Blocked
+</action>
+
+<check if="incomplete_steps_exist">
+  <ask>**Some steps are not complete:**
+
+  {{#each step in incomplete_steps}}
+  - Step {{step.number}}: {{step.name}} — {{step.status}}
+  {{/each}}
+
+  How should we proceed?
+
+  [A] Complete remaining steps first
+  [B] Mark as skipped and continue
+  [C] Leave dialog "In Progress"
+
+  Choice:</ask>
+</check>
+
+---
+
+## UPDATE SPEC CHANGES
+
+<action>
+**Review "Spec Changes Discovered" section:**
+
+For each discovered issue:
+1. Determine if spec should be updated
+2. If yes, create a note or task to update the spec
+3. Mark the spec update status
+</action>
+
+<ask>**Were any specification changes discovered?**
+
+[A] Yes — Review and document updates needed
+[B] No — No spec changes needed
+
+Choice:</ask>
+
+<check if="choice == A">
+  <action>
+  Update the dialog file:
+
+  | Issue | Resolution | Spec Updated? |
+  |-------|------------|---------------|
+  {{#each change in spec_changes}}
+  | {{change.issue}} | {{change.resolution}} | {{change.updated}} |
+  {{/each}}
+
+  If specs need updating, either:
+  1. Update them now
+  2. Create a task/dialog to update them later
+  </action>
+</check>
+
+---
+
+## CAPTURE LEARNINGS
+
+<ask>**What did we learn from this implementation?**
+
+Consider:
+- What worked well?
+- What was harder than expected?
+- What patterns emerged?
+- What would you do differently?
+
+Learnings:</ask>
+
+<action>
+Add to the Learnings section:
+
+{{#each learning in learnings}}
+- {{learning}}
+{{/each}}
+</action>
+
+---
+
+## FINAL PROGRESS LOG ENTRY
+
+<action>
+Add final entry to Progress Log:
+
+```markdown
+### {YYYY-MM-DD} — COMPLETED
+- All steps complete
+- Spec changes: {summary}
+- Learnings captured
+- Dialog closed
+```
+</action>
+
+---
+
+## UPDATE FINAL STATUS
+
+<action>
+Update the Meta section:
+
+| Field | Value |
+|-------|-------|
+| **Status** | **Complete** |
+</action>
+
+---
+
+## SUMMARY
+
+<output>
+✅ **Dialog Complete!**
+
+**Feature:** {feature_name}
+**Date Started:** {start_date}
+**Date Completed:** {today}
+
+**Steps Completed:** {completed_count} / {total_count}
+**Spec Changes:** {spec_changes_count}
+**Learnings:** {learnings_count}
+
+---
+
+**The dialog is now closed.**
+
+The folder remains at:
+`docs/F-Agent-Dialogs/{date}-{feature_slug}/`
+
+This serves as documentation of:
+- What was implemented
+- How it was done
+- What was learned
+
+---
+
+**What's next?**
+
+[A] Start a new dialog for related work
+[B] Return to main menu
+[C] Review the completed dialog
+
+Choice:
+</output>
+
+---
+
+## ROUTING
+
+<action>
+Based on user choice:
+- [A] → Return to step-01-initialize-dialog.md
+- [B] → End workflow
+- [C] → Display dialog file contents
+</action>
+
+---
+
+_Agent Dialog Workflow — Step 5: Complete Dialog_

package/src/workflows/9-agent-dialogs/templates/dialog-capture.template.md

@@ -0,0 +1,75 @@
+# {DATE} {Feature Name} — Capture
+
+## Meta
+
+| Field | Value |
+|-------|-------|
+| **Date** | {YYYY-MM-DD} |
+| **Type** | 💾 Capture |
+| **Agent** | {Agent name} |
+| **Feature** | {Feature name} |
+| **Specification** | [{Spec name}]({path-to-spec}) |
+| **Status** | Not Started |
+
+---
+
+## Purpose
+
+{1-3 sentences describing what this dialog will accomplish}
+
+---
+
+## Captured Thoughts
+
+{Capture your thinking while it's fresh:}
+
+### The Idea
+
+{What do you want to build/change/fix?}
+
+### Why
+
+{Why is this needed? What problem does it solve?}
+
+### Rough Approach
+
+{Any initial thoughts on how to approach this?}
+
+### Notes
+
+{Anything else to remember}
+
+---
+
+## Context for Next Agent
+
+{Help the agent that continues this work:}
+
+### Current Thinking
+
+{What's your current understanding or hypothesis?}
+
+### Open Questions
+
+{What questions should be explored or clarified?}
+
+### Concerns
+
+{Any potential issues, risks, or things to watch out for?}
+
+### Suggestions
+
+{Any specific approaches or patterns you'd recommend?}
+
+---
+
+## When I Return
+
+1. Read the specification: {spec_path}
+2. Complete Setup Context section
+3. Analyze scope and create steps
+4. Start implementing
+
+---
+
+_Capture Agent Dialog — to be expanded later_

package/src/workflows/9-agent-dialogs/templates/dialog-types/INDEX.md

@@ -0,0 +1,142 @@
+# Dialog Type Templates
+
+Choose the template that matches your work type.
+
+---
+
+## Naming Convention
+
+```
+docs/F-Agent-Dialogs/
+└── {YYYY-MM-DD}-{agent}-{feature-name}/
+    └── {YYYY-MM-DD}-{agent}-{feature-name}-dialog.md
+```
+
+**Example:** `2026-01-23-freya-booking-details-overlay-dialog.md`
+
+---
+
+## Available Types
+
+| Type | Icon | Template | Use When |
+|------|------|----------|----------|
+| **Prototype Implementation** | 🔧 | [prototype-implementation.template.md](prototype-implementation.template.md) | Building UI from specifications |
+| **Stitch UI Generation** | 🪡 | [stitch-generation.template.md](stitch-generation.template.md) | AI-assisted UI design with Google Stitch |
+| **Bug Fix** | 🐛 | [bug-fix.template.md](bug-fix.template.md) | Fixing issues and defects |
+| **Design Exploration** | 🎨 | [design-exploration.template.md](design-exploration.template.md) | Exploring visual/UX directions |
+| **Capture** | 💾 | [../dialog-capture.template.md](../dialog-capture.template.md) | Saving ideas for later |
+| **Generic** | 📋 | [../dialog.template.md](../dialog.template.md) | Anything else |
+
+---
+
+## Type Details
+
+### 🔧 Prototype Implementation
+
+**Best for:**
+- Implementing features from WDS specifications
+- Building UI components section-by-section
+- Following design system patterns
+
+**Key sections:**
+- Specification summary with Object IDs
+- Section-by-section approval flow
+- Design system component mapping
+
+---
+
+### 🪡 Stitch UI Generation
+
+**Best for:**
+- Generating UI designs from specifications using Google Stitch AI
+- Rapid visual design iteration
+- Creating production-quality screens from sketches
+
+**Key sections:**
+- Input formula: Visual Reference + Sketch + Specification
+- Screen-by-screen generation tracking
+- Export and integration workflow
+
+**Input Formula:**
+```
+Visual Reference + Sketch + Specification (as prompt) = Stitch Generation
+```
+
+---
+
+### 🐛 Bug Fix
+
+**Best for:**
+- Fixing reported issues
+- Investigating unexpected behavior
+- Quick targeted fixes
+
+**Key sections:**
+- Symptoms and reproduction steps
+- Investigation hypotheses
+- Root cause and solution documentation
+
+---
+
+### 🎨 Design Exploration
+
+**Best for:**
+- Exploring visual directions
+- Comparing design approaches
+- Making design decisions
+
+**Key sections:**
+- Multiple exploration directions
+- Pros/cons analysis
+- Artifact outputs (moodboards, sketches)
+
+---
+
+### 💾 Capture
+
+**Best for:**
+- Saving ideas when you don't have time
+- Capturing context for later
+- Minimal documentation
+
+**Key sections:**
+- Just purpose and initial thoughts
+- "When I Return" checklist
+
+---
+
+### 📋 Generic
+
+**Best for:**
+- Work that doesn't fit other types
+- Custom workflows
+- Flexible structure
+
+**Key sections:**
+- Full setup context
+- Custom step breakdown
+- Standard progress tracking
+
+---
+
+## Choosing a Template
+
+```
+Start here:
+    │
+    ├── Building code from spec? → 🔧 Prototype Implementation
+    │
+    ├── Generating UI designs with AI? → 🪡 Stitch UI Generation
+    │
+    ├── Fixing something broken? → 🐛 Bug Fix
+    │
+    ├── Exploring design options? → 🎨 Design Exploration
+    │
+    ├── No time now, save for later? → 💾 Capture
+    │
+    └── Something else? → 📋 Generic
+```
+
+---
+
+_Dialog Type Templates — WDS Agent Dialog Workflow_

package/src/workflows/9-agent-dialogs/templates/dialog-types/bug-fix.template.md

@@ -0,0 +1,164 @@
+# {DATE} {Bug Name} — Bug Fix
+
+## Meta
+
+| Field | Value |
+|-------|-------|
+| **Date** | {YYYY-MM-DD} |
+| **Type** | 🐛 Bug Fix |
+| **Agent** | {Agent name} |
+| **Issue** | {Brief description} |
+| **Reported By** | {Who reported} |
+| **Priority** | {Critical / High / Medium / Low} |
+| **Status** | Not Started |
+
+---
+
+## Purpose
+
+Fix: {One sentence description of the bug}
+
+---
+
+## Bug Details
+
+### Symptoms
+
+{What the user sees / what's happening wrong}
+
+### Expected Behavior
+
+{What should happen instead}
+
+### Steps to Reproduce
+
+1. {Step 1}
+2. {Step 2}
+3. {Step 3}
+4. **Result:** {What happens}
+5. **Expected:** {What should happen}
+
+### Environment
+
+- **Browser/Device:** {e.g., Chrome 120, iPhone 14}
+- **OS:** {e.g., macOS, iOS 17}
+- **User Type:** {e.g., Authenticated, Admin}
+
+### Evidence
+
+- Screenshot: {path or description}
+- Console errors: {if any}
+- Network issues: {if any}
+
+---
+
+## Setup Context
+
+### Relevant Files
+
+| File | Purpose | Likely Cause? |
+|------|---------|---------------|
+| `{path/to/file}` | {What it does} | {Yes/No/Maybe} |
+
+### Related Code
+
+```typescript
+// Suspected problematic code
+{code snippet if known}
+```
+
+---
+
+## Investigation
+
+### Hypotheses
+
+1. **{Hypothesis 1}** — {Why you think this might be the cause}
+2. **{Hypothesis 2}** — {Alternative explanation}
+
+### Investigation Steps
+
+- [ ] Reproduce the issue locally
+- [ ] Check console for errors
+- [ ] Review recent changes to related files
+- [ ] Add debugging/logging
+- [ ] Identify root cause
+
+---
+
+## Steps Overview
+
+| # | Step | Status | Notes |
+|---|------|--------|-------|
+| 1 | [Reproduce Issue](steps/01-reproduce.md) | 🔲 | |
+| 2 | [Identify Root Cause](steps/02-investigate.md) | 🔲 | |
+| 3 | [Implement Fix](steps/03-fix.md) | 🔲 | |
+| 4 | [Test Fix](steps/04-test.md) | 🔲 | |
+| 5 | [Verify No Regression](steps/05-verify.md) | 🔲 | |
+
+---
+
+## The Fix
+
+### Root Cause
+
+{Discovered root cause — fill in after investigation}
+
+### Solution
+
+{Description of the fix — fill in after implementing}
+
+### Files Changed
+
+| File | Change |
+|------|--------|
+| `{path}` | {What was changed} |
+
+---
+
+## Testing
+
+### Verification Steps
+
+1. {How to verify the fix works}
+2. {Step 2}
+3. {Expected result}
+
+### Regression Testing
+
+- [ ] Original bug is fixed
+- [ ] Related functionality still works
+- [ ] No new console errors
+- [ ] Other states/flows unaffected
+
+---
+
+## Progress Log
+
+### {YYYY-MM-DD}
+
+- Created bug fix dialog
+- Initial investigation
+
+<!--
+### {YYYY-MM-DD}
+- Reproduced issue
+- Identified root cause: {description}
+- Implemented fix
+- Verified fix works
+-->
+
+---
+
+## Learnings
+
+<!--
+What can we learn to prevent similar bugs?
+-->
+
+- {Pattern that caused this}
+- {How to prevent in future}
+
+---
+
+_Bug Fix Dialog — WDS Agent Dialog Workflow_

package/src/workflows/9-agent-dialogs/templates/dialog-types/design-exploration.template.md

@@ -0,0 +1,180 @@
+# {DATE} {Exploration Name} — Design Exploration
+
+## Meta
+
+| Field | Value |
+|-------|-------|
+| **Date** | {YYYY-MM-DD} |
+| **Type** | 🎨 Design Exploration |
+| **Agent** | Eira (Visual Designer) / Freya (UX Designer) |
+| **Topic** | {What we're exploring} |
+| **Tool** | {Magic Patterns / Figma / Excalidraw / Code} |
+| **Status** | Not Started |
+
+---
+
+## Purpose
+
+Explore {design direction / visual approach / interaction pattern} for {feature/page}.
+
+---
+
+## Exploration Context
+
+### What We're Exploring
+
+{Describe the design challenge or opportunity}
+
+### Why
+
+{What prompted this exploration? What decision needs to be made?}
+
+### Constraints
+
+- {Constraint 1 — e.g., must match brand}
+- {Constraint 2 — e.g., mobile-first}
+- {Constraint 3 — e.g., accessibility}
+
+### Success Criteria
+
+{How will we know if we've found a good solution?}
+
+- {Criterion 1}
+- {Criterion 2}
+
+---
+
+## Setup Context
+
+### Brand Guidelines
+
+- **Colors:** {Primary, secondary, accent}
+- **Typography:** {Font family, sizes}
+- **Tone:** {Warm, professional, playful, etc.}
+
+### Existing Patterns
+
+| Pattern | Where Used | Notes |
+|---------|------------|-------|
+| {Pattern} | {Location} | {How it works} |
+
+### Inspiration
+
+| Reference | What to Take | Link |
+|-----------|--------------|------|
+| {Source} | {What's inspiring} | {URL} |
+
+---
+
+## Exploration Directions
+
+### Direction A: {Name}
+
+**Concept:** {Brief description}
+
+**Pros:**
+- {Pro 1}
+- {Pro 2}
+
+**Cons:**
+- {Con 1}
+- {Con 2}
+
+**Status:** 🔲 Not Explored | 🔄 In Progress | ✅ Complete
+
+---
+
+### Direction B: {Name}
+
+**Concept:** {Brief description}
+
+**Pros:**
+- {Pro 1}
+- {Pro 2}
+
+**Cons:**
+- {Con 1}
+- {Con 2}
+
+**Status:** 🔲 Not Explored | 🔄 In Progress | ✅ Complete
+
+---
+
+### Direction C: {Name}
+
+**Concept:** {Brief description}
+
+**Pros:**
+- {Pro 1}
+- {Pro 2}
+
+**Cons:**
+- {Con 1}
+- {Con 2}
+
+**Status:** 🔲 Not Explored | 🔄 In Progress | ✅ Complete
+
+---
+
+## Steps Overview
+
+| # | Step | Status | Output |
+|---|------|--------|--------|
+| 1 | [Gather Inspiration](steps/01-inspiration.md) | 🔲 | Moodboard |
+| 2 | [Explore Direction A](steps/02-direction-a.md) | 🔲 | Sketches |
+| 3 | [Explore Direction B](steps/03-direction-b.md) | 🔲 | Sketches |
+| 4 | [Compare & Evaluate](steps/04-evaluate.md) | 🔲 | Analysis |
+| 5 | [Refine Winner](steps/05-refine.md) | 🔲 | Final design |
+| 6 | [Document Decision](steps/06-document.md) | 🔲 | Specification |
+
+---
+
+## Outputs
+
+### Artifacts Created
+
+| Artifact | Location | Status |
+|----------|----------|--------|
+| Moodboard | `{path}` | 🔲 |
+| Sketches | `{path}` | 🔲 |
+| Final Design | `{path}` | 🔲 |
+
+### Decision
+
+**Chosen Direction:** {To be determined}
+
+**Rationale:** {Why this direction was chosen}
+
+---
+
+## Progress Log
+
+### {YYYY-MM-DD}
+
+- Started design exploration
+- Gathered initial constraints
+
+<!--
+### {YYYY-MM-DD}
+- Explored Direction A
+- Created 3 sketch variations
+- User feedback: prefer X approach
+
+### {YYYY-MM-DD}
+- Refined Direction A based on feedback
+- Final design approved
+-->
+
+---
+
+## Learnings
+
+<!--
+Capture design insights for future explorations.
+-->
+
+_None yet._
+
+---
+
+_Design Exploration Dialog — WDS Agent Dialog Workflow_