whiteport-design-studio 0.2.2 → 0.3.0

package/src/workflows/_agent-dialogs/templates/dialog.template.md

@@ -1,200 +0,0 @@
-# {DATE} {Feature Name}
-
-## Meta
-
-| Field | Value |
-|-------|-------|
-| **Date** | {YYYY-MM-DD} |
-| **Agent** | {Agent name, e.g., Freya (UX Designer)} |
-| **Feature** | {Feature name} |
-| **Specification** | [{Spec name}]({path-to-spec}) |
-| **Status** | {Not Started / In Progress / Blocked / Complete} |
-
----
-
-## Purpose
-
-{1-3 sentences describing what this dialog accomplishes}
-
----
-
-## About This Dialog
-
-This dialog **bridges the gap** between the page specification and the development work.
-
-```
-┌─────────────────────┐         ┌─────────────────────┐         ┌─────────────────────┐
-│   SPECIFICATION     │         │    THIS DIALOG      │         │   DEVELOPMENT       │
-│                     │         │                     │         │                     │
-│ • What to build     │────────▶│ • What's in scope   │────────▶│ • How to build      │
-│ • Object IDs        │         │ • Step breakdown    │         │ • Code files        │
-│ • Requirements      │         │ • Traceability      │         │ • Components        │
-│ • Translations      │         │ • Progress tracking │         │ • Tests             │
-└─────────────────────┘         └─────────────────────┘         └─────────────────────┘
-     Single Source                   Navigation                    Implementation
-      of Truth                         Layer
-```
-
-**The specification is the single source of truth.** This dialog does not duplicate spec content — it maps implementation tasks to spec sections.
-
----
-
-## Where to Find What
-
-| I need... | Go to... |
-|-----------|----------|
-| Complete requirements for an Object ID | [{Spec name}]({path-to-spec}) |
-| Translation keys and strings | Specification → each Object ID section |
-| What's in scope for this implementation | This file → [Scope](#scope) section |
-| Step-by-step implementation instructions | [steps/](steps/) folder |
-| Which Object IDs belong to which step | Each step file → Object ID Implementation Map |
-| Design system component patterns | {path-to-design-system} |
-| Existing code to modify | This file → [Relevant Files](#relevant-files) table |
-
----
-
-## Setup Context
-
-{Everything an agent needs to understand the project and start working. Include:}
-
-### Project Context
-
-- **Project:** {Project name}
-- **Tech Stack:** {e.g., React 19, Next.js 15, TypeScript, Tailwind CSS}
-- **Repository:** {path or URL}
-
-### Relevant Files
-
-| File | Purpose |
-|------|---------|
-| `{path/to/file}` | {What this file does} |
-| `{path/to/file}` | {What this file does} |
-
-### Existing Patterns
-
-{Describe any patterns the agent should follow, e.g.:}
-
-- Component structure: {describe}
-- Styling approach: {describe}
-- State management: {describe}
-
-### Current State
-
-{What exists already that this work builds on}
-
----
-
-## Scope
-
-### In Scope
-
-- {Feature/change 1}
-- {Feature/change 2}
-- {Feature/change 3}
-
-### Out of Scope
-
-- {Explicitly excluded item 1}
-- {Explicitly excluded item 2}
-
-### Dependencies
-
-- {Dependency 1 — describe what must exist first}
-- {Dependency 2}
-
----
-
-## Implementation Workflow
-
-### Step-by-Step Process
-
-1. **Build step** — Implement the code
-2. **Test step** — Verify against spec
-3. **User approval** — Confirm it's correct
-4. **CW status check** — Verify context window has room for next step
-5. **Next step** — Move forward
-
-### Context Window (CW) Status Check
-
-At the end of each completed step, perform a CW status check to ensure the AI session can handle the next step without losing important context.
-
-| Check | Action |
-|-------|--------|
-| **Session length** | If conversation is very long, consider starting fresh for next step |
-| **Context clarity** | Can the agent still reference earlier decisions accurately? |
-| **Handoff summary** | If starting new session, document: completed steps, key decisions, current file states |
-
-**Recommendation thresholds:**
-- **Continue** — Session is manageable, context is clear
-- **Consider fresh start** — Session is long but context is still intact
-- **Fresh start recommended** — Context overflow risk, or major architectural shift in next step
-
----
-
-## Steps Overview
-
-| # | Step | Status | Notes |
-|---|------|--------|-------|
-| 1 | [{Step name}](steps/01-{step-name}.md) | 🔲 | |
-| 2 | [{Step name}](steps/02-{step-name}.md) | 🔲 | |
-| 3 | [{Step name}](steps/03-{step-name}.md) | 🔲 | |
-
-**Status Legend:** 🔲 Not Started | 🔄 In Progress | ✅ Complete | ⏸️ Blocked | ❌ Skipped
-
----
-
-## Progress Log
-
-### {YYYY-MM-DD}
-
-- Created dialog structure
-- {Other activities}
-
-<!--
-Add entries as work progresses:
-
-### {YYYY-MM-DD}
-- Completed Step 1: {description}
-- Started Step 2
-- {Issues or discoveries}
--->
-
----
-
-## Spec Changes Discovered
-
-<!--
-Document any specification changes or clarifications discovered during implementation.
-These should be fed back to the specification files.
--->
-
-_None yet._
-
-<!--
-Example:
-| Issue | Resolution | Spec Updated? |
-|-------|------------|---------------|
-| Missing error state | Added to spec | ✅ |
-| Unclear button label | Clarified as "Close" | 🔲 |
--->
-
----
-
-## Learnings
-
-<!--
-Capture learnings for future dialogs.
--->
-
-_None yet._
-
-<!--
-Example:
-- Pattern X works well for this type of component
-- Should have broken step 3 into smaller pieces
-- Dependency on Y wasn't documented
--->
-
----
-
-_Created using WDS Agent Dialog Workflow_

package/src/workflows/_agent-dialogs/templates/dream-up-agent-dialog.template.md

@@ -1,271 +0,0 @@
-# Agent Dialog: Dream Up - {{task_name}}
-
-**Created:** {{date}} {{time}}
-**Mode:** {{mode}} <!-- Workshop / Suggest / Dream -->
-**Phase:** {{phase}} <!-- 1 / 2 / 3 / 4 / 5 / 6 -->
-**Task:** {{task_description}}
-**Project:** {{project_name}}
-**Status:** {{status}} <!-- in_progress / complete -->
-
----
-
-## User Request
-
-{{user_initial_request}}
-
----
-
-## Mode Selection
-
-**User chose:** {{mode}}
-
-**Rationale:** {{why_this_mode}}
-
----
-
-## Layer 1: WDS Form Learned
-
-### WDS Guides Loaded
-
-- `{{guide_1_path}}` - {{guide_1_purpose}}
-- `{{guide_2_path}}` - {{guide_2_purpose}}
-- `{{guide_3_path}}` - {{guide_3_purpose}}
-- `{{rubric_path}}` - Quality standards
-
-### Key Learnings
-
-#### Structure
-{{how_to_organize_artifact}}
-
-#### Quality Criteria
-{{what_makes_quality_output}}
-
-#### Common Mistakes
-{{what_to_avoid}}
-
-#### Best Practices
-{{what_to_aspire_to}}
-
-### Quality Threshold
-
-**Minimum to present to user:**
-{{minimum_threshold}}
-
-**Excellence criteria:**
-{{excellence_criteria}}
-
----
-
-## Layer 2: Project Context (Cumulative)
-
-### Initial Load - From Product Brief
-
-**Business Context:**
-{{business_what_who_why}}
-
-**Users:**
-{{user_archetypes_mentioned}}
-
-**Constraints:**
-- Technical: {{technical_constraints}}
-- Business: {{business_constraints}}
-- Timeline: {{timeline_constraints}}
-
-**Strategic Direction:**
-{{goals_positioning_priorities}}
-
-### Cumulative Growth
-
-_Layer 2 grows as each artifact is completed:_
-
-```
-Initial: Product Brief
-  ↓ (after Business Goals generated)
-+ Business Goals
-  ↓ (after Target Groups generated)
-+ Target Groups
-  ↓ (after Driving Forces generated)
-+ Driving Forces
-  ↓ (after Prioritization generated)
-+ Prioritization
-```
-
-**Current Layer 2 Contents:**
-{{list_all_completed_artifacts_in_layer_2}}
-
----
-
-## Layer 3: Domain Research
-
-### Research Per Step
-
-_Agent researches domain insights as needed for each step_
-
-#### Research for {{step_name}}
-
-**Research Questions:**
-- {{research_question_1}}
-- {{research_question_2}}
-
-**Findings:**
-- {{finding_1_with_source}}
-- {{finding_2_with_source}}
-
-**Implications:**
-{{how_research_informs_generation}}
-
----
-
-## Layer 4 & 5: Generation & Self-Review Log
-
-### Iteration 1
-
-**Timestamp:** {{iteration_1_timestamp}}
-
-**Generated:**
-{{iteration_1_content_summary}}
-
-**Self-Review:**
-```markdown
-## Completeness Check
-{{iteration_1_completeness}}
-
-## Quality Criteria
-{{iteration_1_quality_check}}
-
-## Common Mistakes
-{{iteration_1_mistakes_check}}
-
-## Best Practices
-{{iteration_1_practices_check}}
-
-## Overall Score
-- Completeness: {{score}}/10
-- Quality: {{score}}/{{max}}
-- Mistakes Avoided: {{score}}/{{max}}
-- Best Practices: {{score}}/{{max}}
-
-**Assessment:** {{meets_threshold_yes_no}}
-```
-
-**Gaps Identified:**
-{{iteration_1_gaps}}
-
-**Outcome:** {{refine_or_complete}}
-
-{{user_checkpoint_if_suggest_mode}}
-
----
-
-### Iteration 2 (if needed)
-
-**Timestamp:** {{iteration_2_timestamp}}
-
-**Refinement Plan:**
-{{what_will_be_changed_and_why}}
-
-**Refined:**
-{{iteration_2_content_summary}}
-
-**Self-Review:**
-```markdown
-[Same structure as Iteration 1]
-```
-
-**Outcome:** {{refine_or_complete}}
-
-{{user_checkpoint_if_suggest_mode}}
-
----
-
-### Iteration 3 (if needed)
-
-[Same structure...]
-
----
-
-### Iteration N - COMPLETE
-
-**Timestamp:** {{iteration_n_timestamp}}
-
-**Final Self-Review:**
-```markdown
-## All Criteria Met ✅
-
-### Completeness: {{score}}/10
-[All required sections present]
-
-### Quality Standards: {{score}}/{{max}}
-[All criteria met]
-
-### Common Mistakes: 0
-[All mistakes avoided]
-
-### Best Practices: {{score}}/{{max}}
-[Practices followed]
-
-## Overall Quality: {{excellent_or_good}}
-
-**Confidence:** {{high_or_medium}}
-**Recommendation:** Present to user for approval
-```
-
----
-
-## Final Output
-
-**Artifact Location:** {{path_to_generated_file}}
-
-**Summary:**
-{{brief_description_of_output}}
-
-**Key Decisions:**
-{{key_decisions_made}}
-
-**What's Next:**
-{{next_phase_or_step}}
-
----
-
-## User Feedback
-
-**Approved:** {{yes_no_pending}}
-
-**User Notes:**
-{{user_feedback_on_output}}
-
-**Changes Requested:**
-{{changes_if_any}}
-
----
-
-## Completion Summary
-
-**Total Iterations:** {{count}}
-**Time Spent:** {{duration}}
-**Quality Score:** {{final_score}}/10
-
-**Success Metrics:**
-- Met quality threshold: {{yes_no}}
-- User approved: {{yes_no}}
-- Within iteration limit (5): {{yes_no}}
-
-**Lessons Learned:**
-{{what_worked_what_didnt}}
-
----
-
-## Handoff Context
-
-**For Next Phase:**
-{{context_for_next_agent_or_phase}}
-
-**Open Questions:**
-{{unresolved_questions_if_any}}
-
-**Recommendations:**
-{{suggestions_for_next_steps}}
-
----
-
-*Dream Up session complete. Generated artifact follows WDS standards and methodology.*

package/src/workflows/_agent-dialogs/templates/step.template.md

@@ -1,138 +0,0 @@
-# Step {##}: {Step Name}
-
-## Meta
-
-| Field | Value |
-|-------|-------|
-| **Agent** | {Agent name — e.g., Freya (UX Designer)} |
-| **Step** | {#} of {total} |
-| **Focus** | {Brief description of step focus} |
-
----
-
-## Single Source of Truth
-
-⚠️ **READ THE SPECIFICATION BEFORE IMPLEMENTING.**
-
-📄 **Specification:** [{Spec name}]({path-to-spec})
-
-The specification contains the complete requirements. This step file maps Object IDs to their spec locations — do not implement without reading the full spec sections.
-
----
-
-## Object ID Implementation Map
-
-| Object ID | Spec Section | Lines |
-|-----------|--------------|-------|
-| `{object-id-1}` | {Section name} | L{start}-L{end} |
-| `{object-id-2}` | {Section name} | L{start}-L{end} |
-| `{object-id-3}` | {Section name} | L{start}-L{end} |
-
-### Design System References
-
-| Component | Location |
-|-----------|----------|
-| {Component name} | `{path-to-design-system-component}` |
-
----
-
-## Task
-
-{Clear description of what to implement in this step}
-
----
-
-## Files to Modify
-
-| File | Action |
-|------|--------|
-| `{path/to/file}` | {Create / Modify} |
-
----
-
-## Implementation Checklist
-
-For **each Object ID**, read the spec section and implement:
-
-| Object ID | Read Spec | Implement | Verify |
-|-----------|-----------|-----------|--------|
-| `{object-id-1}` | [ ] | [ ] | [ ] |
-| `{object-id-2}` | [ ] | [ ] | [ ] |
-| `{object-id-3}` | [ ] | [ ] | [ ] |
-
----
-
-## Verification Process
-
-After implementation, self-verify using Puppeteer before presenting to the user.
-
-See: [Inline Testing Guide](../../4-ux-design/agentic-development/guides/INLINE-TESTING-GUIDE.md) for full methodology.
-
-```
-For each Object ID:
-  1. Open page in browser (Puppeteer)
-  2. Find element: document.querySelector('[data-object-id="{id}"]')
-  3. Verify measurable properties against spec:
-     - Text content matches translation keys
-     - Computed styles match spec values (colors, sizes, spacing)
-     - Dimensions meet requirements (touch targets >= 44px)
-     - Visibility conditions work correctly
-     - State transitions behave as specified
-     - Accessibility attributes present
-  4. Narrate each finding with ✓/✗ (actual vs expected)
-  5. Fix any failures before presenting to user
-```
-
-**If modifying existing features:** Capture baseline state with Puppeteer before implementation. Compare after to confirm only intended changes.
-
----
-
-## Acceptance Criteria
-
-### Agent-Verifiable (Puppeteer)
-
-- [ ] All Object IDs present as `data-object-id` attributes
-- [ ] Each element's text content matches specification
-- [ ] Each element's styling matches specification values
-- [ ] Touch targets meet minimum 44px requirement
-- [ ] State-specific visibility/behavior works correctly
-- [ ] Translations work (SE/EN) using Translation Keys from spec
-- [ ] No TypeScript errors
-- [ ] No console errors
-
-### User-Evaluable (Qualitative)
-
-- [ ] Interaction flow feels natural
-- [ ] Visual hierarchy is clear
-- [ ] Section is consistent with overall design
-
----
-
-## Notes
-
-{Any additional notes, discoveries, or issues found during implementation}
-
----
-
-## CW Status Check
-
-At step completion, assess context window status:
-
-| Indicator | Status |
-|-----------|--------|
-| Session length | {Short / Medium / Long} |
-| Context clarity | {Clear / Degraded} |
-| Recommendation | {Continue / Consider fresh start / Fresh start recommended} |
-
-**If starting fresh session for next step, include handoff summary:**
-
-```
-Completed: Step {#} - {Step Name}
-Key decisions: {list any important decisions made}
-File states: {list modified files and their current state}
-Next: Step {#+1} - {Next Step Name}
-```
-
----
-
-_Step {#} of {total} — {Feature Name} Implementation_