diff --git a/src/modules/wds/agents/freyja-ux.agent.yaml b/src/modules/wds/agents/freyja-ux.agent.yaml index 0c09383d..deaf102c 100644 --- a/src/modules/wds/agents/freyja-ux.agent.yaml +++ b/src/modules/wds/agents/freyja-ux.agent.yaml @@ -37,7 +37,7 @@ agent: - **On activation**: Check for active conversations using src/modules/wds/workflows/project-analysis/conversation-persistence/check-conversations.md - **Before starting ANY work**: Check task appropriateness using src/modules/wds/workflows/project-analysis/task-reflection.md - **When context full or session closing**: Save conversation using src/modules/wds/workflows/project-analysis/conversation-persistence/save-conversation.md - - **On activation**: Show presentation from src/modules/wds/agents/presentations/freyja-presentation.md + - **On activation**: Show presentation from src/modules/wds/data/presentations/freyja-presentation.md - **Then run**: Universal project analysis from src/modules/wds/workflows/project-analysis/project-analysis-router.md - **If task in my domain (Phases 4, 5, 7)**: Continue in same conversation after confirming understanding - **If task in another domain**: Hand over seamlessly to specialized agent diff --git a/src/modules/wds/agents/idunn-pm.agent.yaml b/src/modules/wds/agents/idunn-pm.agent.yaml index 5f1f45b6..c14a6a9b 100644 --- a/src/modules/wds/agents/idunn-pm.agent.yaml +++ b/src/modules/wds/agents/idunn-pm.agent.yaml @@ -34,7 +34,7 @@ agent: - **On activation**: Check for active conversations using src/modules/wds/workflows/project-analysis/conversation-persistence/check-conversations.md - **Before starting ANY work**: Check task appropriateness using src/modules/wds/workflows/project-analysis/task-reflection.md - **When context full or session closing**: Save conversation using src/modules/wds/workflows/project-analysis/conversation-persistence/save-conversation.md - - **On activation**: Show presentation from src/modules/wds/agents/presentations/idunn-presentation.md + - **On activation**: Show presentation from src/modules/wds/data/presentations/idunn-presentation.md - **Then run**: Universal project analysis from src/modules/wds/workflows/project-analysis/instructions.md - **If task in my domain (Phases 3, 6)**: Continue in same conversation after confirming understanding - **If task in another domain**: Hand over seamlessly to specialized agent diff --git a/src/modules/wds/MIMIR-WDS-ORCHESTRATOR.md b/src/modules/wds/agents/mimir-orchestrator.md similarity index 100% rename from src/modules/wds/MIMIR-WDS-ORCHESTRATOR.md rename to src/modules/wds/agents/mimir-orchestrator.md diff --git a/src/modules/wds/agents/saga-analyst.agent.yaml b/src/modules/wds/agents/saga-analyst.agent.yaml index d26d138b..55f434ae 100644 --- a/src/modules/wds/agents/saga-analyst.agent.yaml +++ b/src/modules/wds/agents/saga-analyst.agent.yaml @@ -62,7 +62,7 @@ agent: - **On activation**: Check for active conversations using src/modules/wds/workflows/project-analysis/conversation-persistence/check-conversations.md - **Before starting ANY work**: Check task appropriateness using src/modules/wds/workflows/project-analysis/task-reflection.md - **When context full or session closing**: Save conversation using src/modules/wds/workflows/project-analysis/conversation-persistence/save-conversation.md - - **On activation**: Show presentation from src/modules/wds/agents/presentations/saga-presentation.md + - **On activation**: Show presentation from src/modules/wds/data/presentations/saga-presentation.md - **Then run**: Universal project analysis from src/modules/wds/workflows/project-analysis/instructions.md - **If task in my domain (Phases 1, 2)**: Continue in same conversation after confirming understanding - **If task in another domain**: Hand over seamlessly to specialized agent diff --git a/src/modules/wds/agents/presentations/freyja-presentation.md b/src/modules/wds/data/presentations/freyja-presentation.md similarity index 100% rename from src/modules/wds/agents/presentations/freyja-presentation.md rename to src/modules/wds/data/presentations/freyja-presentation.md diff --git a/src/modules/wds/agents/presentations/idunn-presentation.md b/src/modules/wds/data/presentations/idunn-presentation.md similarity index 100% rename from src/modules/wds/agents/presentations/idunn-presentation.md rename to src/modules/wds/data/presentations/idunn-presentation.md diff --git a/src/modules/wds/agents/presentations/mimir-presentation.md b/src/modules/wds/data/presentations/mimir-presentation.md similarity index 100% rename from src/modules/wds/agents/presentations/mimir-presentation.md rename to src/modules/wds/data/presentations/mimir-presentation.md diff --git a/src/modules/wds/agents/presentations/saga-presentation.md b/src/modules/wds/data/presentations/saga-presentation.md similarity index 100% rename from src/modules/wds/agents/presentations/saga-presentation.md rename to src/modules/wds/data/presentations/saga-presentation.md diff --git a/src/modules/wds/docs/README.md b/src/modules/wds/docs/README.md new file mode 100644 index 00000000..4ce7c2c0 --- /dev/null +++ b/src/modules/wds/docs/README.md @@ -0,0 +1,170 @@ +# WDS Documentation + +Complete documentation for Whiteport Design Studio - a design-first methodology for creating software that people love. + +--- + +## 🚀 Getting Started + +**New to WDS?** Start here: + +- **[About WDS](getting-started/about-wds.md)** - What WDS is and why it exists (5 min) +- **[Installation](getting-started/installation.md)** - Set up WDS in your project (5 min) +- **[Quick Start](getting-started/quick-start.md)** - Your first 5 minutes with WDS +- **[Where to Go Next](getting-started/where-to-go-next.md)** - Choose your learning path + +**Quick Path:** Install → Quick Start → Choose your path + +--- + +## 📖 The WDS Method + +**What WDS is:** A design-focused methodology that can be done with pen & paper, design tools, or with WDS agents. + +- **[WDS Method Overview](method/wds-method-guide.md)** - Complete methodology guide +- **[Phase 1: Product Exploration](method/phase-1-product-exploration-guide.md)** - Strategic foundation +- **[Phase 2: Trigger Mapping](method/phase-2-trigger-mapping-guide.md)** - User psychology & business goals +- **[Phase 3: PRD Platform](method/phase-3-prd-platform-guide.md)** - Technical foundation +- **[Phase 4: UX Design](method/phase-4-ux-design-guide.md)** - Scenarios & specifications +- **[Phase 5: Design System](method/phase-5-design-system-guide.md)** - Component library (optional) +- **[Phase 6: Integration](method/phase-6-integration-guide.md)** - PRD finalization & handoff + +**These guides are tool-agnostic** - explaining the methodology regardless of how you apply it. + +--- + +## 🎓 Learn WDS + +**How to use WDS with AI agents:** Step-by-step course using WDS agents + Cursor/Windsurf. + +- **[Complete WDS Course](learn-wds/)** - Sequential learning path +- **[Course Overview](learn-wds/00-course-overview.md)** - What you'll learn +- **[Module 01: Why WDS Matters](learn-wds/module-01-why-wds-matters/)** - The problem & solution +- **[Module 02: Installation & Setup](learn-wds/module-02-installation-setup/)** - Get WDS running +- **[Module 03: Alignment & Signoff](learn-wds/module-03-alignment-signoff/)** - Stakeholder alignment +- **[Module 04: Product Brief](learn-wds/module-04-product-brief/)** - Create strategic foundation +- **[Module 05: Trigger Mapping](learn-wds/module-05-map-triggers-outcomes/)** - Map user psychology +- **[Module 06+](learn-wds/)** - Continue through all phases + +**This course is WDS-specific** - teaching you to use Saga, Freyja, and Idunn agents. + +--- + +## 📋 Deliverables + +**What you create with WDS:** Specifications for each deliverable. + +- **[Product Brief](deliverables/product-brief.md)** - Strategic vision & positioning +- **[Trigger Map](deliverables/trigger-map.md)** - User psychology & business goals +- **[Platform PRD](deliverables/platform-prd.md)** - Technical requirements +- **[Page Specifications](deliverables/page-specifications.md)** - Detailed page specs +- **[Design System](deliverables/design-system.md)** - Component library +- **[Design Delivery PRD](deliverables/design-delivery-prd.md)** - Complete handoff package +- **[Project Pitch](deliverables/project-pitch.md)** - External presentations +- **[Service Agreement](deliverables/service-agreement.md)** - Client contracts + +**These specs are universal** - defining structure regardless of how you create them. + +--- + +## 🎨 Examples + +**See WDS in action:** Real projects showing complete WDS folder structures. + +- **[WDS Presentation](examples/wds-presentation/)** - Marketing website example + - Complete docs/ folder structure + - Product brief, trigger map, scenarios + - Shows real WDS deliverables + +**These are reference implementations** - copy structure for your projects. + +--- + +## 🤖 Agent Activation + +**Using WDS agents:** Quick activation guides for Saga, Freyja, and Idunn. + +- **[Agent Launchers](getting-started/agent-activation/agent-launchers.md)** - Quick reference +- **[Saga WDS Analyst](getting-started/agent-activation/wds-saga-analyst.md)** - Business analysis +- **[Freyja WDS Designer](getting-started/agent-activation/wds-freyja-ux.md)** - UX design +- **[Idunn WDS PM](getting-started/agent-activation/wds-idunn-pm.md)** - Product management +- **[Mimir Orchestrator](getting-started/agent-activation/wds-mimir.md)** - Workflow coordination + +--- + +## 📚 Reference + +**Additional documentation:** + +- **[Workflows Guide](wds-workflows-guide.md)** - Complete workflow reference +- **[Agent Activation Flow](getting-started/agent-activation/activation/)** - How agents initialize + +--- + +## 🎯 Choose Your Path + +### I need to... + +**Understand the methodology (tool-agnostic)** +→ Start with [WDS Method Overview](method/wds-method-guide.md) +→ Read phase guides as needed + +**Learn to use WDS with AI agents** +→ Take the [Complete WDS Course](learn-wds/) +→ Follow sequential modules + +**See what WDS creates** +→ Browse [Deliverables](deliverables/) +→ Check [Examples](examples/) + +**Start using WDS now** +→ Follow [Getting Started](getting-started/getting-started-overview.md) +→ Activate an agent and go! + +**Reference specific information** +→ Use [Workflows Guide](wds-workflows-guide.md) +→ Jump to relevant phase guide + +--- + +## 💡 Documentation Structure + +``` +docs/ +├── getting-started/ # Quick start guides (15 min total) +├── method/ # Tool-agnostic methodology guides +├── learn-wds/ # WDS-specific course (agent-driven) +├── deliverables/ # Specifications for what you create +├── examples/ # Real project examples +└── README.md # This navigation hub +``` + +**Three clear purposes:** + +1. **method/** → "How does the design methodology work?" (universal) +2. **learn-wds/** → "How do I use WDS agents?" (WDS-specific) +3. **examples/** → "Show me a real project" (reference implementation) + +--- + +## 🌐 External Resources + +### Community and Support + +- **[Discord Community](https://discord.gg/gk8jAdXWmj)** - Get help from the community +- **[GitHub Issues](https://github.com/whiteport-collective/whiteport-design-studio/issues)** - Report bugs or request features +- **[YouTube Channel](https://www.youtube.com/@WhiteportCollective)** - Video tutorials + +### Additional Documentation + +- **[BMad Method Documentation](../../bmm/docs/)** - Development workflows (BMM integrates with WDS) +- **[IDE Setup Guides](../../../../docs/ide-info/)** - Configure your development environment + +--- + +**Ready to begin?** → [Start with Getting Started](getting-started/getting-started-overview.md) + +--- + +_Whiteport Design Studio - Providing a thinking partner to every designer on the planet_ + diff --git a/src/modules/wds/course/deliverables/design-delivery-prd.md b/src/modules/wds/docs/deliverables/design-delivery-prd.md similarity index 100% rename from src/modules/wds/course/deliverables/design-delivery-prd.md rename to src/modules/wds/docs/deliverables/design-delivery-prd.md diff --git a/src/modules/wds/course/deliverables/design-system.md b/src/modules/wds/docs/deliverables/design-system.md similarity index 100% rename from src/modules/wds/course/deliverables/design-system.md rename to src/modules/wds/docs/deliverables/design-system.md diff --git a/src/modules/wds/course/deliverables/page-specifications.md b/src/modules/wds/docs/deliverables/page-specifications.md similarity index 100% rename from src/modules/wds/course/deliverables/page-specifications.md rename to src/modules/wds/docs/deliverables/page-specifications.md diff --git a/src/modules/wds/course/deliverables/platform-prd.md b/src/modules/wds/docs/deliverables/platform-prd.md similarity index 100% rename from src/modules/wds/course/deliverables/platform-prd.md rename to src/modules/wds/docs/deliverables/platform-prd.md diff --git a/src/modules/wds/course/deliverables/product-brief.md b/src/modules/wds/docs/deliverables/product-brief.md similarity index 100% rename from src/modules/wds/course/deliverables/product-brief.md rename to src/modules/wds/docs/deliverables/product-brief.md diff --git a/src/modules/wds/course/deliverables/project-pitch.md b/src/modules/wds/docs/deliverables/project-pitch.md similarity index 100% rename from src/modules/wds/course/deliverables/project-pitch.md rename to src/modules/wds/docs/deliverables/project-pitch.md diff --git a/src/modules/wds/course/deliverables/service-agreement.md b/src/modules/wds/docs/deliverables/service-agreement.md similarity index 100% rename from src/modules/wds/course/deliverables/service-agreement.md rename to src/modules/wds/docs/deliverables/service-agreement.md diff --git a/src/modules/wds/course/deliverables/trigger-map.md b/src/modules/wds/docs/deliverables/trigger-map.md similarity index 100% rename from src/modules/wds/course/deliverables/trigger-map.md rename to src/modules/wds/docs/deliverables/trigger-map.md diff --git a/src/modules/wds/examples/WDS-Presentation/Resources/1764688965752.jfif b/src/modules/wds/docs/examples/WDS-Presentation/Resources/1764688965752.jfif similarity index 100% rename from src/modules/wds/examples/WDS-Presentation/Resources/1764688965752.jfif rename to src/modules/wds/docs/examples/WDS-Presentation/Resources/1764688965752.jfif diff --git a/src/modules/wds/examples/WDS-Presentation/Resources/HeroSection.jpg b/src/modules/wds/docs/examples/WDS-Presentation/Resources/HeroSection.jpg similarity index 100% rename from src/modules/wds/examples/WDS-Presentation/Resources/HeroSection.jpg rename to src/modules/wds/docs/examples/WDS-Presentation/Resources/HeroSection.jpg diff --git a/src/modules/wds/examples/WDS-Presentation/Resources/WhiteportLegacyPage.jpg b/src/modules/wds/docs/examples/WDS-Presentation/Resources/WhiteportLegacyPage.jpg similarity index 100% rename from src/modules/wds/examples/WDS-Presentation/Resources/WhiteportLegacyPage.jpg rename to src/modules/wds/docs/examples/WDS-Presentation/Resources/WhiteportLegacyPage.jpg diff --git a/src/modules/wds/examples/WDS-Presentation/docs/1-project-brief/01-product-brief.md b/src/modules/wds/docs/examples/WDS-Presentation/docs/1-project-brief/01-product-brief.md similarity index 100% rename from src/modules/wds/examples/WDS-Presentation/docs/1-project-brief/01-product-brief.md rename to src/modules/wds/docs/examples/WDS-Presentation/docs/1-project-brief/01-product-brief.md diff --git a/src/modules/wds/examples/WDS-Presentation/docs/1-project-brief/02-content-strategy.md b/src/modules/wds/docs/examples/WDS-Presentation/docs/1-project-brief/02-content-strategy.md similarity index 100% rename from src/modules/wds/examples/WDS-Presentation/docs/1-project-brief/02-content-strategy.md rename to src/modules/wds/docs/examples/WDS-Presentation/docs/1-project-brief/02-content-strategy.md diff --git a/src/modules/wds/examples/WDS-Presentation/docs/2-trigger-map/00-trigger-map.md b/src/modules/wds/docs/examples/WDS-Presentation/docs/2-trigger-map/00-trigger-map.md similarity index 100% rename from src/modules/wds/examples/WDS-Presentation/docs/2-trigger-map/00-trigger-map.md rename to src/modules/wds/docs/examples/WDS-Presentation/docs/2-trigger-map/00-trigger-map.md diff --git a/src/modules/wds/examples/WDS-Presentation/docs/2-trigger-map/01-Business-Goals.md b/src/modules/wds/docs/examples/WDS-Presentation/docs/2-trigger-map/01-Business-Goals.md similarity index 100% rename from src/modules/wds/examples/WDS-Presentation/docs/2-trigger-map/01-Business-Goals.md rename to src/modules/wds/docs/examples/WDS-Presentation/docs/2-trigger-map/01-Business-Goals.md diff --git a/src/modules/wds/examples/WDS-Presentation/docs/2-trigger-map/02-Stina-the-Strategist.md b/src/modules/wds/docs/examples/WDS-Presentation/docs/2-trigger-map/02-Stina-the-Strategist.md similarity index 100% rename from src/modules/wds/examples/WDS-Presentation/docs/2-trigger-map/02-Stina-the-Strategist.md rename to src/modules/wds/docs/examples/WDS-Presentation/docs/2-trigger-map/02-Stina-the-Strategist.md diff --git a/src/modules/wds/examples/WDS-Presentation/docs/2-trigger-map/03-Lars-the-Leader.md b/src/modules/wds/docs/examples/WDS-Presentation/docs/2-trigger-map/03-Lars-the-Leader.md similarity index 100% rename from src/modules/wds/examples/WDS-Presentation/docs/2-trigger-map/03-Lars-the-Leader.md rename to src/modules/wds/docs/examples/WDS-Presentation/docs/2-trigger-map/03-Lars-the-Leader.md diff --git a/src/modules/wds/examples/WDS-Presentation/docs/2-trigger-map/04-Felix-the-Full-Stack.md b/src/modules/wds/docs/examples/WDS-Presentation/docs/2-trigger-map/04-Felix-the-Full-Stack.md similarity index 100% rename from src/modules/wds/examples/WDS-Presentation/docs/2-trigger-map/04-Felix-the-Full-Stack.md rename to src/modules/wds/docs/examples/WDS-Presentation/docs/2-trigger-map/04-Felix-the-Full-Stack.md diff --git a/src/modules/wds/examples/WDS-Presentation/docs/2-trigger-map/05-Key-Insights.md b/src/modules/wds/docs/examples/WDS-Presentation/docs/2-trigger-map/05-Key-Insights.md similarity index 100% rename from src/modules/wds/examples/WDS-Presentation/docs/2-trigger-map/05-Key-Insights.md rename to src/modules/wds/docs/examples/WDS-Presentation/docs/2-trigger-map/05-Key-Insights.md diff --git a/src/modules/wds/examples/WDS-Presentation/docs/2-trigger-map/06-Feature-Impact.md b/src/modules/wds/docs/examples/WDS-Presentation/docs/2-trigger-map/06-Feature-Impact.md similarity index 100% rename from src/modules/wds/examples/WDS-Presentation/docs/2-trigger-map/06-Feature-Impact.md rename to src/modules/wds/docs/examples/WDS-Presentation/docs/2-trigger-map/06-Feature-Impact.md diff --git a/src/modules/wds/examples/WDS-Presentation/docs/2-trigger-map/resources/felix-the-full-stack.png b/src/modules/wds/docs/examples/WDS-Presentation/docs/2-trigger-map/resources/felix-the-full-stack.png similarity index 100% rename from src/modules/wds/examples/WDS-Presentation/docs/2-trigger-map/resources/felix-the-full-stack.png rename to src/modules/wds/docs/examples/WDS-Presentation/docs/2-trigger-map/resources/felix-the-full-stack.png diff --git a/src/modules/wds/examples/WDS-Presentation/docs/2-trigger-map/resources/lars-the-leader.png b/src/modules/wds/docs/examples/WDS-Presentation/docs/2-trigger-map/resources/lars-the-leader.png similarity index 100% rename from src/modules/wds/examples/WDS-Presentation/docs/2-trigger-map/resources/lars-the-leader.png rename to src/modules/wds/docs/examples/WDS-Presentation/docs/2-trigger-map/resources/lars-the-leader.png diff --git a/src/modules/wds/examples/WDS-Presentation/docs/2-trigger-map/resources/stina-the-desginer.png b/src/modules/wds/docs/examples/WDS-Presentation/docs/2-trigger-map/resources/stina-the-desginer.png similarity index 100% rename from src/modules/wds/examples/WDS-Presentation/docs/2-trigger-map/resources/stina-the-desginer.png rename to src/modules/wds/docs/examples/WDS-Presentation/docs/2-trigger-map/resources/stina-the-desginer.png diff --git a/src/modules/wds/examples/WDS-Presentation/docs/4-scenarios/1.1-wds-presentation/1.1-wds-presentation.md b/src/modules/wds/docs/examples/WDS-Presentation/docs/4-scenarios/1.1-wds-presentation/1.1-wds-presentation.md similarity index 100% rename from src/modules/wds/examples/WDS-Presentation/docs/4-scenarios/1.1-wds-presentation/1.1-wds-presentation.md rename to src/modules/wds/docs/examples/WDS-Presentation/docs/4-scenarios/1.1-wds-presentation/1.1-wds-presentation.md diff --git a/src/modules/wds/examples/WDS-Presentation/docs/4-scenarios/1.1-wds-presentation/benefits-workshop.md b/src/modules/wds/docs/examples/WDS-Presentation/docs/4-scenarios/1.1-wds-presentation/benefits-workshop.md similarity index 100% rename from src/modules/wds/examples/WDS-Presentation/docs/4-scenarios/1.1-wds-presentation/benefits-workshop.md rename to src/modules/wds/docs/examples/WDS-Presentation/docs/4-scenarios/1.1-wds-presentation/benefits-workshop.md diff --git a/src/modules/wds/examples/WDS-Presentation/docs/4-scenarios/1.1-wds-presentation/sketches/1-1-wds-presentation-desktop-concept.jpg b/src/modules/wds/docs/examples/WDS-Presentation/docs/4-scenarios/1.1-wds-presentation/sketches/1-1-wds-presentation-desktop-concept.jpg similarity index 100% rename from src/modules/wds/examples/WDS-Presentation/docs/4-scenarios/1.1-wds-presentation/sketches/1-1-wds-presentation-desktop-concept.jpg rename to src/modules/wds/docs/examples/WDS-Presentation/docs/4-scenarios/1.1-wds-presentation/sketches/1-1-wds-presentation-desktop-concept.jpg diff --git a/src/modules/wds/examples/WDS-Presentation/wds-workflow-status.yaml b/src/modules/wds/docs/examples/WDS-Presentation/wds-workflow-status.yaml similarity index 100% rename from src/modules/wds/examples/WDS-Presentation/wds-workflow-status.yaml rename to src/modules/wds/docs/examples/WDS-Presentation/wds-workflow-status.yaml diff --git a/src/modules/wds/getting-started/MANUAL-INIT-GUIDE.md b/src/modules/wds/docs/getting-started/MANUAL-INIT-GUIDE.md similarity index 100% rename from src/modules/wds/getting-started/MANUAL-INIT-GUIDE.md rename to src/modules/wds/docs/getting-started/MANUAL-INIT-GUIDE.md diff --git a/src/modules/wds/getting-started/about-wds.md b/src/modules/wds/docs/getting-started/about-wds.md similarity index 100% rename from src/modules/wds/getting-started/about-wds.md rename to src/modules/wds/docs/getting-started/about-wds.md diff --git a/src/modules/wds/getting-started/agent-activation/activation/step-01-load-agent-definition.md b/src/modules/wds/docs/getting-started/agent-activation/activation/step-01-load-agent-definition.md similarity index 92% rename from src/modules/wds/getting-started/agent-activation/activation/step-01-load-agent-definition.md rename to src/modules/wds/docs/getting-started/agent-activation/activation/step-01-load-agent-definition.md index 7a7e7bf2..eecb0daf 100644 --- a/src/modules/wds/getting-started/agent-activation/activation/step-01-load-agent-definition.md +++ b/src/modules/wds/docs/getting-started/agent-activation/activation/step-01-load-agent-definition.md @@ -10,7 +10,7 @@ Read and fully embody the persona from your agent definition file. **Your agent definition file**: - Saga: `src/modules/wds/agents/saga-analyst.agent.yaml` -- Freya: `src/modules/wds/agents/freyja-ux.agent.yaml` +- Freyja: `src/modules/wds/agents/freyja-ux.agent.yaml` - Idunn: `src/modules/wds/agents/idunn-pm.agent.yaml` - Mimir: `src/modules/wds/MIMIR-WDS-ORCHESTRATOR.md` (orchestrator file) diff --git a/src/modules/wds/getting-started/agent-activation/activation/step-02-check-conversations.md b/src/modules/wds/docs/getting-started/agent-activation/activation/step-02-check-conversations.md similarity index 100% rename from src/modules/wds/getting-started/agent-activation/activation/step-02-check-conversations.md rename to src/modules/wds/docs/getting-started/agent-activation/activation/step-02-check-conversations.md diff --git a/src/modules/wds/getting-started/agent-activation/activation/step-03-check-activation-context.md b/src/modules/wds/docs/getting-started/agent-activation/activation/step-03-check-activation-context.md similarity index 100% rename from src/modules/wds/getting-started/agent-activation/activation/step-03-check-activation-context.md rename to src/modules/wds/docs/getting-started/agent-activation/activation/step-03-check-activation-context.md diff --git a/src/modules/wds/getting-started/agent-activation/activation/step-04-handoff-presentation.md b/src/modules/wds/docs/getting-started/agent-activation/activation/step-04-handoff-presentation.md similarity index 74% rename from src/modules/wds/getting-started/agent-activation/activation/step-04-handoff-presentation.md rename to src/modules/wds/docs/getting-started/agent-activation/activation/step-04-handoff-presentation.md index 476f972f..67958772 100644 --- a/src/modules/wds/getting-started/agent-activation/activation/step-04-handoff-presentation.md +++ b/src/modules/wds/docs/getting-started/agent-activation/activation/step-04-handoff-presentation.md @@ -11,9 +11,9 @@ Show your full presentation even though this is a handoff. **Why**: Human connection is important, even in handoffs **Your presentation file**: -- Saga: `src/modules/wds/agents/presentations/saga-presentation.md` -- Freya: `src/modules/wds/agents/presentations/freyja-presentation.md` -- Idunn: `src/modules/wds/agents/presentations/idunn-presentation.md` +- Saga: `src/modules/wds/data/presentations/saga-presentation.md` +- Freyja: `src/modules/wds/data/presentations/freyja-presentation.md` +- Idunn: `src/modules/wds/data/presentations/idunn-presentation.md` - Mimir: `src/modules/wds/agents/presentations/mimir-presentation.md` **What to do**: diff --git a/src/modules/wds/getting-started/agent-activation/activation/step-04-standard-presentation.md b/src/modules/wds/docs/getting-started/agent-activation/activation/step-04-standard-presentation.md similarity index 68% rename from src/modules/wds/getting-started/agent-activation/activation/step-04-standard-presentation.md rename to src/modules/wds/docs/getting-started/agent-activation/activation/step-04-standard-presentation.md index c2fab9dd..421db94d 100644 --- a/src/modules/wds/getting-started/agent-activation/activation/step-04-standard-presentation.md +++ b/src/modules/wds/docs/getting-started/agent-activation/activation/step-04-standard-presentation.md @@ -9,9 +9,9 @@ Show your full presentation to introduce yourself. **Your presentation file**: -- Saga: `src/modules/wds/agents/presentations/saga-presentation.md` -- Freya: `src/modules/wds/agents/presentations/freyja-presentation.md` -- Idunn: `src/modules/wds/agents/presentations/idunn-presentation.md` +- Saga: `src/modules/wds/data/presentations/saga-presentation.md` +- Freyja: `src/modules/wds/data/presentations/freyja-presentation.md` +- Idunn: `src/modules/wds/data/presentations/idunn-presentation.md` **What to do**: 1. Load and show your full presentation diff --git a/src/modules/wds/getting-started/agent-activation/activation/step-05-handoff-acknowledge.md b/src/modules/wds/docs/getting-started/agent-activation/activation/step-05-handoff-acknowledge.md similarity index 100% rename from src/modules/wds/getting-started/agent-activation/activation/step-05-handoff-acknowledge.md rename to src/modules/wds/docs/getting-started/agent-activation/activation/step-05-handoff-acknowledge.md diff --git a/src/modules/wds/getting-started/agent-activation/activation/step-05-standard-analysis.md b/src/modules/wds/docs/getting-started/agent-activation/activation/step-05-standard-analysis.md similarity index 100% rename from src/modules/wds/getting-started/agent-activation/activation/step-05-standard-analysis.md rename to src/modules/wds/docs/getting-started/agent-activation/activation/step-05-standard-analysis.md diff --git a/src/modules/wds/getting-started/agent-activation/agent-launchers.md b/src/modules/wds/docs/getting-started/agent-activation/agent-launchers.md similarity index 83% rename from src/modules/wds/getting-started/agent-activation/agent-launchers.md rename to src/modules/wds/docs/getting-started/agent-activation/agent-launchers.md index 742a11b4..7efbc927 100644 --- a/src/modules/wds/getting-started/agent-activation/agent-launchers.md +++ b/src/modules/wds/docs/getting-started/agent-activation/agent-launchers.md @@ -8,9 +8,9 @@ Simply reference one of these files in your IDE chat to activate the corresponding WDS agent: -### Freya - UX/UI Designer 🎨 +### Freyja - UX/UI Designer 🎨 -**File**: `@wds-freya-ux.md` +**File**: `@wds-freyja-ux.md` **Specializes in**: UX Design, Design Systems, Testing **Phases**: 4, 5, 7 @@ -30,7 +30,7 @@ Simply reference one of these files in your IDE chat to activate the correspondi ## How It Works -When you reference one of these files (e.g., `@wds-freya-ux.md`), the agent will: +When you reference one of these files (e.g., `@wds-freyja-ux.md`), the agent will: 1. **Load their persona** from their agent definition file 2. **Execute project analysis** using the router workflow @@ -65,11 +65,11 @@ All agents use a **router pattern** for predictable behavior: Each agent focuses on specific WDS phases: -| Agent | Primary Phases | Key Expertise | -| --------- | -------------- | ---------------------------- | -| **Saga** | 1-2 | Strategy, research, personas | -| **Freya** | 4-5, 7 | Design, prototypes, testing | -| **Idunn** | 3, 6 | Architecture, delivery, PM | +| Agent | Primary Phases | Key Expertise | +| ----------- | -------------- | ---------------------------- | +| **Saga** | 1-2 | Strategy, research, personas | +| **Freyja** | 4-5, 7 | Design, prototypes, testing | +| **Idunn** | 3, 6 | Architecture, delivery, PM | If you select a task outside the current agent's domain, they'll seamlessly hand over to the specialist. @@ -78,12 +78,12 @@ If you select a task outside the current agent's domain, they'll seamlessly hand ## Example Usage ``` -User: @wds-freya-ux.md help me with my project +User: @wds-freyja-ux.md help me with my project -Freya: -🎨 Freya WDS Designer Agent +Freyja: +🎨 Freyja WDS Designer Agent -I'm Freya, your UX design partner... +I'm Freyja, your UX design partner... Analyzing your project... diff --git a/src/modules/wds/getting-started/agent-activation/wds-freya-ux.md b/src/modules/wds/docs/getting-started/agent-activation/wds-freyja-ux.md similarity index 82% rename from src/modules/wds/getting-started/agent-activation/wds-freya-ux.md rename to src/modules/wds/docs/getting-started/agent-activation/wds-freyja-ux.md index da2e1049..6320c9df 100644 --- a/src/modules/wds/getting-started/agent-activation/wds-freya-ux.md +++ b/src/modules/wds/docs/getting-started/agent-activation/wds-freyja-ux.md @@ -9,10 +9,10 @@ I guide you through the creative heart of the WDS journey - from scenarios and u ## 🎯 What I Help You Create **Phase 4: Design the Experience** -- [Page Specifications & Prototypes](../../course/deliverables/page-specifications.md) - Turn sketches into complete conceptual specifications +- [Page Specifications & Prototypes](../../deliverables/page-specifications.md) - Turn sketches into complete conceptual specifications **Phase 5: Build Your Design System** -- [Component Library & Design Tokens](../../course/deliverables/design-system.md) - Create consistency across your entire product +- [Component Library & Design Tokens](../../deliverables/design-system.md) - Create consistency across your entire product **My Expertise:** - UX/UI design and interaction patterns @@ -30,15 +30,15 @@ I guide you through the creative heart of the WDS journey - from scenarios and u --- -# Freya WDS Designer Agent - Quick Launcher +# Freyja WDS Designer Agent - Quick Launcher -**Purpose**: Activate Freya with a short, memorable command +**Purpose**: Activate Freyja with a short, memorable command --- ## Agent Activation -You are **Freya WDS Designer Agent**. +You are **Freyja WDS Designer Agent**. **Activation Flow**: Follow these steps sequentially. Each step loads the next instruction file. @@ -56,7 +56,7 @@ You are **Freya WDS Designer Agent**. ## Your Role -You are Freya, the UX/UI Designer specializing in: +You are Freyja, the UX/UI Designer specializing in: - **Phase 4**: UX Design (scenarios, user flows, prototypes) - **Phase 5**: Design System (tokens, components, style guides) diff --git a/src/modules/wds/getting-started/agent-activation/wds-idunn-pm.md b/src/modules/wds/docs/getting-started/agent-activation/wds-idunn-pm.md similarity index 89% rename from src/modules/wds/getting-started/agent-activation/wds-idunn-pm.md rename to src/modules/wds/docs/getting-started/agent-activation/wds-idunn-pm.md index 970c7ee3..3494f885 100644 --- a/src/modules/wds/getting-started/agent-activation/wds-idunn-pm.md +++ b/src/modules/wds/docs/getting-started/agent-activation/wds-idunn-pm.md @@ -9,10 +9,10 @@ I guide you through the technical architecture and handoff phases - from platfor ## 🎯 What I Help You Create **Phase 3: Nail Down the Platform Requirements** -- [Platform PRD & Architecture](../../course/deliverables/platform-prd.md) - Define technical foundation and system architecture +- [Platform PRD & Architecture](../../deliverables/platform-prd.md) - Define technical foundation and system architecture **Phase 6: Hand Off to Development** -- [Design Delivery PRD](../../course/deliverables/design-delivery-prd.md) - Package organized PRD documents with epics and stories +- [Design Delivery PRD](../../deliverables/design-delivery-prd.md) - Package organized PRD documents with epics and stories **My Expertise:** - Platform architecture and technical planning diff --git a/src/modules/wds/getting-started/agent-activation/wds-mimir.md b/src/modules/wds/docs/getting-started/agent-activation/wds-mimir.md similarity index 100% rename from src/modules/wds/getting-started/agent-activation/wds-mimir.md rename to src/modules/wds/docs/getting-started/agent-activation/wds-mimir.md diff --git a/src/modules/wds/getting-started/agent-activation/wds-saga-analyst.md b/src/modules/wds/docs/getting-started/agent-activation/wds-saga-analyst.md similarity index 83% rename from src/modules/wds/getting-started/agent-activation/wds-saga-analyst.md rename to src/modules/wds/docs/getting-started/agent-activation/wds-saga-analyst.md index 05e73c4f..ad216278 100644 --- a/src/modules/wds/getting-started/agent-activation/wds-saga-analyst.md +++ b/src/modules/wds/docs/getting-started/agent-activation/wds-saga-analyst.md @@ -9,12 +9,12 @@ I work at the very beginning of your journey - where vision meets reality. Toget ## 🎯 What I Help You Create **Phase 1: Win Client Buy-In** -- [Project Pitch](../../course/deliverables/project-pitch.md) - Present your vision in business language -- [Service Agreement](../../course/deliverables/service-agreement.md) - Get everyone aligned before you start -- [Product Brief](../../course/deliverables/product-brief.md) - Define vision, goals, and success criteria +- [Project Pitch](../../deliverables/project-pitch.md) - Present your vision in business language +- [Service Agreement](../../deliverables/service-agreement.md) - Get everyone aligned before you start +- [Product Brief](../../deliverables/product-brief.md) - Define vision, goals, and success criteria **Phase 2: Map Business Goals & User Needs** -- [Trigger Map & Personas](../../course/deliverables/trigger-map.md) - Connect business goals to user psychology +- [Trigger Map & Personas](../../deliverables/trigger-map.md) - Connect business goals to user psychology **My Expertise:** - Strategic business analysis and market positioning diff --git a/src/modules/wds/getting-started/getting-started-overview.md b/src/modules/wds/docs/getting-started/getting-started-overview.md similarity index 100% rename from src/modules/wds/getting-started/getting-started-overview.md rename to src/modules/wds/docs/getting-started/getting-started-overview.md diff --git a/src/modules/wds/getting-started/installation.md b/src/modules/wds/docs/getting-started/installation.md similarity index 85% rename from src/modules/wds/getting-started/installation.md rename to src/modules/wds/docs/getting-started/installation.md index 8e472177..0dc319a6 100644 --- a/src/modules/wds/getting-started/installation.md +++ b/src/modules/wds/docs/getting-started/installation.md @@ -45,7 +45,7 @@ You should see: - [About WDS](about-wds.md) - Understand what WDS is and why it exists - [Quick Start Guide](quick-start.md) - Your first 5 minutes -- [Course](../course/00-course-overview.md) - Learn the concepts deeply +- [Learn WDS Course](../learn-wds/00-course-overview.md) - Learn the concepts deeply --- @@ -59,4 +59,4 @@ You should see: --- -[← Back to WDS](../WDS-WORKFLOWS-GUIDE.md) +[← Back to Getting Started](getting-started-overview.md) diff --git a/src/modules/wds/getting-started/quick-start.md b/src/modules/wds/docs/getting-started/quick-start.md similarity index 93% rename from src/modules/wds/getting-started/quick-start.md rename to src/modules/wds/docs/getting-started/quick-start.md index f8f7676c..66f30bd5 100644 --- a/src/modules/wds/getting-started/quick-start.md +++ b/src/modules/wds/docs/getting-started/quick-start.md @@ -110,11 +110,11 @@ You created **conceptual specifications** in 5 minutes: ### Learn the Concepts -[Course](../course/00-course-overview.md) - Deep dive into WDS methodology +[Learn WDS Course](../learn-wds/00-course-overview.md) - Deep dive into WDS methodology ### Start Your Project -[Workflows Guide](../WDS-WORKFLOWS-GUIDE.md) - Full workflow documentation +[Workflows Guide](../wds-workflows-guide.md) - Full workflow documentation ### Get Help diff --git a/src/modules/wds/getting-started/where-to-go-next.md b/src/modules/wds/docs/getting-started/where-to-go-next.md similarity index 70% rename from src/modules/wds/getting-started/where-to-go-next.md rename to src/modules/wds/docs/getting-started/where-to-go-next.md index bdefb664..e75d4c00 100644 --- a/src/modules/wds/getting-started/where-to-go-next.md +++ b/src/modules/wds/docs/getting-started/where-to-go-next.md @@ -8,13 +8,13 @@ ### 🎓 Take the Course -**[WDS Course: From Designer to Linchpin](../course/00-course-overview.md)** +**[WDS Course: From Designer to Linchpin](../learn-wds/00-course-overview.md)** Complete training from project brief to AI-ready specifications: **Module 01: Why WDS Matters** Learn how to be indispensable in the AI era. Understand the paradigm shift where design becomes specification. -→ [Start Module 01](../course/module-01-why-wds-matters/module-01-overview.md) +→ [Start Module 01](../learn-wds/module-01-why-wds-matters/module-01-overview.md) **Modules 02-16: Complete WDS Workflow** Master every phase from trigger mapping through design system to development handoff. Each module includes: @@ -23,7 +23,7 @@ Master every phase from trigger mapping through design system to development han - **Tutorials** - Step-by-step hands-on guides - **Practice** - Apply to your own project -→ [View All Modules](../course/00-course-overview.md) +→ [View All Modules](../learn-wds/00-course-overview.md) **Best for:** Comprehensive learning with structured curriculum @@ -33,29 +33,29 @@ Master every phase from trigger mapping through design system to development han ### 🚀 Start Your Project -**[Workflows Guide](../WDS-WORKFLOWS-GUIDE.md)** +**[Workflows Guide](../wds-workflows-guide.md)** Step-by-step workflows for: **Phase 1: Project Brief** Define vision, goals, stakeholders, and constraints that guide all design decisions. -→ [Tutorial: Create Project Brief](../course/module-02-project-brief/tutorial-02.md) +→ [Tutorial: Create Project Brief](../learn-wds/module-04-product-brief/tutorial-04.md) **Phase 2: Trigger Mapping** Understand WHO your users are, WHAT triggers their needs, and WHY your business exists. Create a Trigger Map that connects user psychology to business value. -→ [Tutorial: Map Triggers & Outcomes](../course/module-04-map-triggers-outcomes/tutorial-04.md) +→ [Tutorial: Map Triggers & Outcomes](../learn-wds/module-05-map-triggers-outcomes/tutorial-04.md) **Phase 3: Platform Requirements** Document technical constraints, integrations, and infrastructure needs. -→ [Workflows Guide](../WDS-WORKFLOWS-GUIDE.md) +→ [Workflows Guide](../wds-workflows-guide.md) **Phase 4: UX Design** Transform ideas into conceptual specifications that preserve your design intent. AI agents help you think through solutions, then capture your brilliance in specifications that give your designs eternal life. -→ [Tutorial: Initialize Scenario](../course/module-08-initialize-scenario/tutorial-08.md) | [Tutorial: Conceptual Specs](../course/module-12-conceptual-specs/tutorial-12.md) +→ [Tutorial: Initialize Scenario](../learn-wds/module-08-initialize-scenario/tutorial-08.md) | [Tutorial: Conceptual Specs](../learn-wds/module-12-conceptual-specs/tutorial-12.md) **Phase 5: Design System** Extract design tokens, create reusable components, and generate interactive HTML catalog. -→ [Workflows Guide](../WDS-WORKFLOWS-GUIDE.md) +→ [Workflows Guide](../wds-workflows-guide.md) **Best for:** Hands-on learning with a real project @@ -123,14 +123,14 @@ Join the WDS community for: ## Quick Links -- [Course](../course/00-course-overview.md) -- [Workflows](../WDS-WORKFLOWS-GUIDE.md) -- [Modular Architecture](../workflows/4-ux-design/modular-architecture/00-MODULAR-ARCHITECTURE-GUIDE.md) -- [Conceptual Specifications](../workflows/4-ux-design/CONCEPTUAL-SPECIFICATIONS.md) +- [Course](../learn-wds/00-course-overview.md) +- [Workflows](../wds-workflows-guide.md) +- [Modular Architecture](../../workflows/4-ux-design/modular-architecture/00-MODULAR-ARCHITECTURE-GUIDE.md) +- [Conceptual Specifications](../../workflows/4-ux-design/CONCEPTUAL-SPECIFICATIONS.md) --- -**Ready to dive deeper? Start with the [Course](../course/00-course-overview.md)!** +**Ready to dive deeper? Start with the [Course](../learn-wds/00-course-overview.md)!** --- diff --git a/src/modules/wds/course/00-course-overview.md b/src/modules/wds/docs/learn-wds/00-course-overview.md similarity index 100% rename from src/modules/wds/course/00-course-overview.md rename to src/modules/wds/docs/learn-wds/00-course-overview.md diff --git a/src/modules/wds/course/00-course-overview/00-getting-started-overview.md b/src/modules/wds/docs/learn-wds/00-course-overview/00-getting-started-overview.md similarity index 100% rename from src/modules/wds/course/00-course-overview/00-getting-started-overview.md rename to src/modules/wds/docs/learn-wds/00-course-overview/00-getting-started-overview.md diff --git a/src/modules/wds/course/00-course-overview/01-prerequisites.md b/src/modules/wds/docs/learn-wds/00-course-overview/01-prerequisites.md similarity index 100% rename from src/modules/wds/course/00-course-overview/01-prerequisites.md rename to src/modules/wds/docs/learn-wds/00-course-overview/01-prerequisites.md diff --git a/src/modules/wds/course/00-course-overview/02-learning-paths.md b/src/modules/wds/docs/learn-wds/00-course-overview/02-learning-paths.md similarity index 100% rename from src/modules/wds/course/00-course-overview/02-learning-paths.md rename to src/modules/wds/docs/learn-wds/00-course-overview/02-learning-paths.md diff --git a/src/modules/wds/course/00-course-overview/03-support.md b/src/modules/wds/docs/learn-wds/00-course-overview/03-support.md similarity index 100% rename from src/modules/wds/course/00-course-overview/03-support.md rename to src/modules/wds/docs/learn-wds/00-course-overview/03-support.md diff --git a/src/modules/wds/course/course-explainers/00-getting-started-NOTEBOOKLM-PROMPT.md b/src/modules/wds/docs/learn-wds/course-explainers/00-getting-started-NOTEBOOKLM-PROMPT.md similarity index 100% rename from src/modules/wds/course/course-explainers/00-getting-started-NOTEBOOKLM-PROMPT.md rename to src/modules/wds/docs/learn-wds/course-explainers/00-getting-started-NOTEBOOKLM-PROMPT.md diff --git a/src/modules/wds/course/course-explainers/00-getting-started-YOUTUBE-SHOW-NOTES.md b/src/modules/wds/docs/learn-wds/course-explainers/00-getting-started-YOUTUBE-SHOW-NOTES.md similarity index 100% rename from src/modules/wds/course/course-explainers/00-getting-started-YOUTUBE-SHOW-NOTES.md rename to src/modules/wds/docs/learn-wds/course-explainers/00-getting-started-YOUTUBE-SHOW-NOTES.md diff --git a/src/modules/wds/course/course-explainers/module-01-NOTEBOOKLM-PROMPT.md b/src/modules/wds/docs/learn-wds/course-explainers/module-01-NOTEBOOKLM-PROMPT.md similarity index 100% rename from src/modules/wds/course/course-explainers/module-01-NOTEBOOKLM-PROMPT.md rename to src/modules/wds/docs/learn-wds/course-explainers/module-01-NOTEBOOKLM-PROMPT.md diff --git a/src/modules/wds/course/course-explainers/module-01-YOUTUBE-SHOW-NOTES.md b/src/modules/wds/docs/learn-wds/course-explainers/module-01-YOUTUBE-SHOW-NOTES.md similarity index 100% rename from src/modules/wds/course/course-explainers/module-01-YOUTUBE-SHOW-NOTES.md rename to src/modules/wds/docs/learn-wds/course-explainers/module-01-YOUTUBE-SHOW-NOTES.md diff --git a/src/modules/wds/course/course-explainers/module-02-NOTEBOOKLM-PROMPT.md b/src/modules/wds/docs/learn-wds/course-explainers/module-02-NOTEBOOKLM-PROMPT.md similarity index 100% rename from src/modules/wds/course/course-explainers/module-02-NOTEBOOKLM-PROMPT.md rename to src/modules/wds/docs/learn-wds/course-explainers/module-02-NOTEBOOKLM-PROMPT.md diff --git a/src/modules/wds/course/course-explainers/module-02-YOUTUBE-SHOW-NOTES.md b/src/modules/wds/docs/learn-wds/course-explainers/module-02-YOUTUBE-SHOW-NOTES.md similarity index 100% rename from src/modules/wds/course/course-explainers/module-02-YOUTUBE-SHOW-NOTES.md rename to src/modules/wds/docs/learn-wds/course-explainers/module-02-YOUTUBE-SHOW-NOTES.md diff --git a/src/modules/wds/course/course-explainers/module-03-NOTEBOOKLM-PROMPT.md b/src/modules/wds/docs/learn-wds/course-explainers/module-03-NOTEBOOKLM-PROMPT.md similarity index 100% rename from src/modules/wds/course/course-explainers/module-03-NOTEBOOKLM-PROMPT.md rename to src/modules/wds/docs/learn-wds/course-explainers/module-03-NOTEBOOKLM-PROMPT.md diff --git a/src/modules/wds/course/course-explainers/module-03-YOUTUBE-SHOW-NOTES.md b/src/modules/wds/docs/learn-wds/course-explainers/module-03-YOUTUBE-SHOW-NOTES.md similarity index 100% rename from src/modules/wds/course/course-explainers/module-03-YOUTUBE-SHOW-NOTES.md rename to src/modules/wds/docs/learn-wds/course-explainers/module-03-YOUTUBE-SHOW-NOTES.md diff --git a/src/modules/wds/course/module-01-why-wds-matters/lesson-01-the-problem.md b/src/modules/wds/docs/learn-wds/module-01-why-wds-matters/lesson-01-the-problem.md similarity index 100% rename from src/modules/wds/course/module-01-why-wds-matters/lesson-01-the-problem.md rename to src/modules/wds/docs/learn-wds/module-01-why-wds-matters/lesson-01-the-problem.md diff --git a/src/modules/wds/course/module-01-why-wds-matters/lesson-02-the-solution.md b/src/modules/wds/docs/learn-wds/module-01-why-wds-matters/lesson-02-the-solution.md similarity index 100% rename from src/modules/wds/course/module-01-why-wds-matters/lesson-02-the-solution.md rename to src/modules/wds/docs/learn-wds/module-01-why-wds-matters/lesson-02-the-solution.md diff --git a/src/modules/wds/course/module-01-why-wds-matters/lesson-03-the-path-forward.md b/src/modules/wds/docs/learn-wds/module-01-why-wds-matters/lesson-03-the-path-forward.md similarity index 100% rename from src/modules/wds/course/module-01-why-wds-matters/lesson-03-the-path-forward.md rename to src/modules/wds/docs/learn-wds/module-01-why-wds-matters/lesson-03-the-path-forward.md diff --git a/src/modules/wds/course/module-01-why-wds-matters/module-01-overview.md b/src/modules/wds/docs/learn-wds/module-01-why-wds-matters/module-01-overview.md similarity index 100% rename from src/modules/wds/course/module-01-why-wds-matters/module-01-overview.md rename to src/modules/wds/docs/learn-wds/module-01-why-wds-matters/module-01-overview.md diff --git a/src/modules/wds/course/module-02-installation-setup/lesson-01-git-setup/01-lesson.md b/src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-01-git-setup/01-lesson.md similarity index 100% rename from src/modules/wds/course/module-02-installation-setup/lesson-01-git-setup/01-lesson.md rename to src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-01-git-setup/01-lesson.md diff --git a/src/modules/wds/course/module-02-installation-setup/lesson-01-git-setup/01-quick-checklist.md b/src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-01-git-setup/01-quick-checklist.md similarity index 100% rename from src/modules/wds/course/module-02-installation-setup/lesson-01-git-setup/01-quick-checklist.md rename to src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-01-git-setup/01-quick-checklist.md diff --git a/src/modules/wds/course/module-02-installation-setup/lesson-01-git-setup/02-full-lesson.md b/src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-01-git-setup/02-full-lesson.md similarity index 100% rename from src/modules/wds/course/module-02-installation-setup/lesson-01-git-setup/02-full-lesson.md rename to src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-01-git-setup/02-full-lesson.md diff --git a/src/modules/wds/course/module-02-installation-setup/lesson-01-github-and-ide-setup/checklist.md b/src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-01-github-and-ide-setup/checklist.md similarity index 100% rename from src/modules/wds/course/module-02-installation-setup/lesson-01-github-and-ide-setup/checklist.md rename to src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-01-github-and-ide-setup/checklist.md diff --git a/src/modules/wds/course/module-02-installation-setup/lesson-01-github-and-ide-setup/lesson.md b/src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-01-github-and-ide-setup/lesson.md similarity index 100% rename from src/modules/wds/course/module-02-installation-setup/lesson-01-github-and-ide-setup/lesson.md rename to src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-01-github-and-ide-setup/lesson.md diff --git a/src/modules/wds/course/module-02-installation-setup/lesson-01-setting-up-github/checklist.md b/src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-01-setting-up-github/checklist.md similarity index 100% rename from src/modules/wds/course/module-02-installation-setup/lesson-01-setting-up-github/checklist.md rename to src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-01-setting-up-github/checklist.md diff --git a/src/modules/wds/course/module-02-installation-setup/lesson-02-git-configuration/checklist.md b/src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-02-git-configuration/checklist.md similarity index 100% rename from src/modules/wds/course/module-02-installation-setup/lesson-02-git-configuration/checklist.md rename to src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-02-git-configuration/checklist.md diff --git a/src/modules/wds/course/module-02-installation-setup/lesson-02-ide-installation/01-quick-checklist.md b/src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-02-ide-installation/01-quick-checklist.md similarity index 100% rename from src/modules/wds/course/module-02-installation-setup/lesson-02-ide-installation/01-quick-checklist.md rename to src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-02-ide-installation/01-quick-checklist.md diff --git a/src/modules/wds/course/module-02-installation-setup/lesson-02-ide-installation/02-full-lesson.md b/src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-02-ide-installation/02-full-lesson.md similarity index 100% rename from src/modules/wds/course/module-02-installation-setup/lesson-02-ide-installation/02-full-lesson.md rename to src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-02-ide-installation/02-full-lesson.md diff --git a/src/modules/wds/course/module-02-installation-setup/lesson-02-ide-installation/02-lesson.md b/src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-02-ide-installation/02-lesson.md similarity index 100% rename from src/modules/wds/course/module-02-installation-setup/lesson-02-ide-installation/02-lesson.md rename to src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-02-ide-installation/02-lesson.md diff --git a/src/modules/wds/course/module-02-installation-setup/lesson-02-ide-installation/02-quick-checklist.md b/src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-02-ide-installation/02-quick-checklist.md similarity index 100% rename from src/modules/wds/course/module-02-installation-setup/lesson-02-ide-installation/02-quick-checklist.md rename to src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-02-ide-installation/02-quick-checklist.md diff --git a/src/modules/wds/course/module-02-installation-setup/lesson-02-install-ide/checklist.md b/src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-02-install-ide/checklist.md similarity index 100% rename from src/modules/wds/course/module-02-installation-setup/lesson-02-install-ide/checklist.md rename to src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-02-install-ide/checklist.md diff --git a/src/modules/wds/course/module-02-installation-setup/lesson-02-install-ide/tutorial.md b/src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-02-install-ide/tutorial.md similarity index 100% rename from src/modules/wds/course/module-02-installation-setup/lesson-02-install-ide/tutorial.md rename to src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-02-install-ide/tutorial.md diff --git a/src/modules/wds/course/module-02-installation-setup/lesson-03-git-cloning/01-quick-checklist.md b/src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-03-git-cloning/01-quick-checklist.md similarity index 100% rename from src/modules/wds/course/module-02-installation-setup/lesson-03-git-cloning/01-quick-checklist.md rename to src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-03-git-cloning/01-quick-checklist.md diff --git a/src/modules/wds/course/module-02-installation-setup/lesson-03-git-cloning/02-full-lesson.md b/src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-03-git-cloning/02-full-lesson.md similarity index 100% rename from src/modules/wds/course/module-02-installation-setup/lesson-03-git-cloning/02-full-lesson.md rename to src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-03-git-cloning/02-full-lesson.md diff --git a/src/modules/wds/course/module-02-installation-setup/lesson-03-git-cloning/03-lesson.md b/src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-03-git-cloning/03-lesson.md similarity index 100% rename from src/modules/wds/course/module-02-installation-setup/lesson-03-git-cloning/03-lesson.md rename to src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-03-git-cloning/03-lesson.md diff --git a/src/modules/wds/course/module-02-installation-setup/lesson-03-git-cloning/03-quick-checklist.md b/src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-03-git-cloning/03-quick-checklist.md similarity index 100% rename from src/modules/wds/course/module-02-installation-setup/lesson-03-git-cloning/03-quick-checklist.md rename to src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-03-git-cloning/03-quick-checklist.md diff --git a/src/modules/wds/course/module-02-installation-setup/lesson-03-git-setup/checklist.md b/src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-03-git-setup/checklist.md similarity index 100% rename from src/modules/wds/course/module-02-installation-setup/lesson-03-git-setup/checklist.md rename to src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-03-git-setup/checklist.md diff --git a/src/modules/wds/course/module-02-installation-setup/lesson-03-git-setup/tutorial.md b/src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-03-git-setup/tutorial.md similarity index 100% rename from src/modules/wds/course/module-02-installation-setup/lesson-03-git-setup/tutorial.md rename to src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-03-git-setup/tutorial.md diff --git a/src/modules/wds/course/module-02-installation-setup/lesson-04-clone-and-wds/checklist.md b/src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-04-clone-and-wds/checklist.md similarity index 100% rename from src/modules/wds/course/module-02-installation-setup/lesson-04-clone-and-wds/checklist.md rename to src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-04-clone-and-wds/checklist.md diff --git a/src/modules/wds/course/module-02-installation-setup/lesson-04-clone-and-wds/tutorial.md b/src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-04-clone-and-wds/tutorial.md similarity index 100% rename from src/modules/wds/course/module-02-installation-setup/lesson-04-clone-and-wds/tutorial.md rename to src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-04-clone-and-wds/tutorial.md diff --git a/src/modules/wds/course/module-02-installation-setup/lesson-04-wds-initialization/01-quick-checklist.md b/src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-04-wds-initialization/01-quick-checklist.md similarity index 100% rename from src/modules/wds/course/module-02-installation-setup/lesson-04-wds-initialization/01-quick-checklist.md rename to src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-04-wds-initialization/01-quick-checklist.md diff --git a/src/modules/wds/course/module-02-installation-setup/lesson-04-wds-initialization/02-full-lesson.md b/src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-04-wds-initialization/02-full-lesson.md similarity index 100% rename from src/modules/wds/course/module-02-installation-setup/lesson-04-wds-initialization/02-full-lesson.md rename to src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-04-wds-initialization/02-full-lesson.md diff --git a/src/modules/wds/course/module-02-installation-setup/lesson-04-wds-initialization/04-lesson.md b/src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-04-wds-initialization/04-lesson.md similarity index 100% rename from src/modules/wds/course/module-02-installation-setup/lesson-04-wds-initialization/04-lesson.md rename to src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-04-wds-initialization/04-lesson.md diff --git a/src/modules/wds/course/module-02-installation-setup/lesson-04-wds-initialization/04-quick-checklist.md b/src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-04-wds-initialization/04-quick-checklist.md similarity index 100% rename from src/modules/wds/course/module-02-installation-setup/lesson-04-wds-initialization/04-quick-checklist.md rename to src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-04-wds-initialization/04-quick-checklist.md diff --git a/src/modules/wds/course/module-02-installation-setup/lesson-05-initiate-mimir/checklist.md b/src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-05-initiate-mimir/checklist.md similarity index 100% rename from src/modules/wds/course/module-02-installation-setup/lesson-05-initiate-mimir/checklist.md rename to src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-05-initiate-mimir/checklist.md diff --git a/src/modules/wds/course/module-02-installation-setup/lesson-05-initiate-mimir/tutorial.md b/src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-05-initiate-mimir/tutorial.md similarity index 100% rename from src/modules/wds/course/module-02-installation-setup/lesson-05-initiate-mimir/tutorial.md rename to src/modules/wds/docs/learn-wds/module-02-installation-setup/lesson-05-initiate-mimir/tutorial.md diff --git a/src/modules/wds/course/module-02-installation-setup/module-02-overview.md b/src/modules/wds/docs/learn-wds/module-02-installation-setup/module-02-overview.md similarity index 100% rename from src/modules/wds/course/module-02-installation-setup/module-02-overview.md rename to src/modules/wds/docs/learn-wds/module-02-installation-setup/module-02-overview.md diff --git a/src/modules/wds/course/module-03-alignment-signoff/lesson-01-understanding-alignment.md b/src/modules/wds/docs/learn-wds/module-03-alignment-signoff/lesson-01-understanding-alignment.md similarity index 100% rename from src/modules/wds/course/module-03-alignment-signoff/lesson-01-understanding-alignment.md rename to src/modules/wds/docs/learn-wds/module-03-alignment-signoff/lesson-01-understanding-alignment.md diff --git a/src/modules/wds/course/module-03-alignment-signoff/lesson-02-creating-alignment-document.md b/src/modules/wds/docs/learn-wds/module-03-alignment-signoff/lesson-02-creating-alignment-document.md similarity index 100% rename from src/modules/wds/course/module-03-alignment-signoff/lesson-02-creating-alignment-document.md rename to src/modules/wds/docs/learn-wds/module-03-alignment-signoff/lesson-02-creating-alignment-document.md diff --git a/src/modules/wds/course/module-03-alignment-signoff/lesson-03-negotiation-acceptance.md b/src/modules/wds/docs/learn-wds/module-03-alignment-signoff/lesson-03-negotiation-acceptance.md similarity index 100% rename from src/modules/wds/course/module-03-alignment-signoff/lesson-03-negotiation-acceptance.md rename to src/modules/wds/docs/learn-wds/module-03-alignment-signoff/lesson-03-negotiation-acceptance.md diff --git a/src/modules/wds/course/module-03-alignment-signoff/lesson-04-external-contracts.md b/src/modules/wds/docs/learn-wds/module-03-alignment-signoff/lesson-04-external-contracts.md similarity index 100% rename from src/modules/wds/course/module-03-alignment-signoff/lesson-04-external-contracts.md rename to src/modules/wds/docs/learn-wds/module-03-alignment-signoff/lesson-04-external-contracts.md diff --git a/src/modules/wds/course/module-03-alignment-signoff/lesson-05-internal-signoff.md b/src/modules/wds/docs/learn-wds/module-03-alignment-signoff/lesson-05-internal-signoff.md similarity index 100% rename from src/modules/wds/course/module-03-alignment-signoff/lesson-05-internal-signoff.md rename to src/modules/wds/docs/learn-wds/module-03-alignment-signoff/lesson-05-internal-signoff.md diff --git a/src/modules/wds/course/module-03-alignment-signoff/module-03-overview.md b/src/modules/wds/docs/learn-wds/module-03-alignment-signoff/module-03-overview.md similarity index 100% rename from src/modules/wds/course/module-03-alignment-signoff/module-03-overview.md rename to src/modules/wds/docs/learn-wds/module-03-alignment-signoff/module-03-overview.md diff --git a/src/modules/wds/course/module-03-alignment-signoff/tutorial-03.md b/src/modules/wds/docs/learn-wds/module-03-alignment-signoff/tutorial-03.md similarity index 100% rename from src/modules/wds/course/module-03-alignment-signoff/tutorial-03.md rename to src/modules/wds/docs/learn-wds/module-03-alignment-signoff/tutorial-03.md diff --git a/src/modules/wds/course/module-04-project-brief/tutorial-04.md b/src/modules/wds/docs/learn-wds/module-04-product-brief/tutorial-04.md similarity index 100% rename from src/modules/wds/course/module-04-project-brief/tutorial-04.md rename to src/modules/wds/docs/learn-wds/module-04-product-brief/tutorial-04.md diff --git a/src/modules/wds/course/module-04-map-triggers-outcomes/tutorial-04.md b/src/modules/wds/docs/learn-wds/module-05-map-triggers-outcomes/tutorial-04.md similarity index 100% rename from src/modules/wds/course/module-04-map-triggers-outcomes/tutorial-04.md rename to src/modules/wds/docs/learn-wds/module-05-map-triggers-outcomes/tutorial-04.md diff --git a/src/modules/wds/course/module-06-platform-architecture/tutorial-06.md b/src/modules/wds/docs/learn-wds/module-06-platform-architecture/tutorial-06.md similarity index 100% rename from src/modules/wds/course/module-06-platform-architecture/tutorial-06.md rename to src/modules/wds/docs/learn-wds/module-06-platform-architecture/tutorial-06.md diff --git a/src/modules/wds/course/module-08-initialize-scenario/tutorial-08.md b/src/modules/wds/docs/learn-wds/module-08-initialize-scenario/tutorial-08.md similarity index 100% rename from src/modules/wds/course/module-08-initialize-scenario/tutorial-08.md rename to src/modules/wds/docs/learn-wds/module-08-initialize-scenario/tutorial-08.md diff --git a/src/modules/wds/course/module-09-design-system/tutorial-09.md b/src/modules/wds/docs/learn-wds/module-09-design-system/tutorial-09.md similarity index 100% rename from src/modules/wds/course/module-09-design-system/tutorial-09.md rename to src/modules/wds/docs/learn-wds/module-09-design-system/tutorial-09.md diff --git a/src/modules/wds/course/module-10-design-delivery/tutorial-10.md b/src/modules/wds/docs/learn-wds/module-10-design-delivery/tutorial-10.md similarity index 100% rename from src/modules/wds/course/module-10-design-delivery/tutorial-10.md rename to src/modules/wds/docs/learn-wds/module-10-design-delivery/tutorial-10.md diff --git a/src/modules/wds/course/module-12-conceptual-specs/tutorial-12.md b/src/modules/wds/docs/learn-wds/module-12-conceptual-specs/tutorial-12.md similarity index 100% rename from src/modules/wds/course/module-12-conceptual-specs/tutorial-12.md rename to src/modules/wds/docs/learn-wds/module-12-conceptual-specs/tutorial-12.md diff --git a/src/modules/wds/WDS-WORKFLOWS-GUIDE.md b/src/modules/wds/docs/wds-workflows-guide.md similarity index 100% rename from src/modules/wds/WDS-WORKFLOWS-GUIDE.md rename to src/modules/wds/docs/wds-workflows-guide.md diff --git a/src/modules/wds/tasks/check-phase-a-product-brief.md b/src/modules/wds/tasks/check-phase-a-product-brief.md deleted file mode 100644 index 9f417747..00000000 --- a/src/modules/wds/tasks/check-phase-a-product-brief.md +++ /dev/null @@ -1,166 +0,0 @@ -# Task: Check Phase A - Product Brief - -**Purpose**: Analyze Product Brief completion status - -**Agent**: Freyja (WDS Designer) -**Workflow**: project-analysis -**Phase**: analyze - ---- - -## What to Check - -### Folder Structure - -``` -docs/A-Product-Brief/ -├── 00-* or 01-* Main Product Brief (required) -├── Additional documents (optional) -└── Assets/images (optional) -``` - ---- - -## Execution Steps - -### Step 1: Check folder exists - -```javascript -const folder = 'docs/A-Product-Brief/'; -const exists = await checkFolder(folder); -``` - -**If FALSE**: - -- Status: `📋 Ready to start` -- Message: "Product Brief folder not found" -- Recommendation: "Saga WDS Analyst Agent can help create Product Brief" -- **STOP**: This is a foundational phase, other phases build on this - ---- - -### Step 2: Count documents - -**Look for**: - -- `.md` files in root folder -- Main brief usually: `00-*.md` or `01-*.md` - -**Count**: - -- Total markdown files -- Images/assets (if any) - ---- - -### Step 3: Assess completeness - -**Complete if**: - -- At least 1 `.md` file exists -- Main file has >100 lines (substantial content) - -**In Progress if**: - -- Folder exists with <100 lines of content -- Or only placeholder files - -**Missing if**: - -- Folder doesn't exist -- OR folder exists but completely empty - ---- - -## Key Content to Note - -**If reading main brief**, look for these sections: - -- Executive Summary / Vision -- Problem Statement -- Target Users / Market -- Goals & Success Metrics -- Constraints & Assumptions - -**Don't need to verify all sections** - just note if major sections present - ---- - -## Output Format - -```yaml -phase: A -name: "Product Brief" -status: "complete" | "in_progress" | "not_started" -folder_exists: boolean -files_found: number -main_brief: "filename" | null -estimated_completion: "0%" | "50%" | "100%" -notes: "Brief observations" -``` - ---- - -## Response Templates - -### Complete - -``` -✅ Phase A: Product Brief - └─ Complete: [filename] ([line_count] lines) -``` - -### In Progress - -``` -🔄 Phase A: Product Brief - └─ Started: [filename] (draft stage) -``` - -### Not Started Yet - -``` -📋 Phase A: Product Brief - └─ Ready to start: Foundation phase - -💡 **Foundation Phase**: Other phases build on Product Brief - -Recommendation: Activate **Saga WDS Analyst Agent** to create Product Brief through: -- Stakeholder interviews -- Requirement gathering -- Vision definition -``` - ---- - -## Agent Handoff Logic - -**If Phase A is not started**: - -- Suggest: Saga WDS Analyst Agent -- Reason: "Saga specializes in creating Product Briefs through systematic stakeholder interviews and requirement elicitation" -- Action: "Would you like me to hand over to Saga to begin?" - -**If Phase A is in progress**: - -- Suggest: Continue with Saga WDS Analyst Agent OR review with user -- Action: "Would you like to complete the Product Brief or proceed with what exists?" - -**If Phase A is complete**: - -- Continue to Phase B analysis -- No handoff needed - ---- - -## Performance Target - -**Execution time**: <3 seconds -**File operations**: Folder check + file list + optional line count -**Output**: 2-4 lines - ---- - -## Next Task - -Proceed to: `check-phase-b-trigger-map` diff --git a/src/modules/wds/tasks/identify-project-type.md b/src/modules/wds/tasks/identify-project-type.md deleted file mode 100644 index 5f8bc7c6..00000000 --- a/src/modules/wds/tasks/identify-project-type.md +++ /dev/null @@ -1,176 +0,0 @@ -# Task: Identify Project Structure - -**Purpose**: Determine if project uses WDS v6, WPS2C v4, or is new/unknown - -**Agent**: Freyja (WDS Designer) -**Workflow**: project-analysis -**Phase**: identify - ---- - -## Execution Steps - -### Step 1: Check for docs/ folder - -```javascript -const docsExists = await checkFolder('docs/'); -``` - -**If FALSE**: - -- Return: `project_structure: "empty"` -- Message: "No docs/ folder found" -- Recommendation: "Suggest project setup with Saga (Analyst)" - ---- - -### Step 2: Check for WDS v6 structure (numbered workflows) - -**Look for numbered workflow folders in docs/:** - -```javascript -const v6Indicators = [ - 'docs/1-project-brief/', - 'docs/2-trigger-mapping/', - 'docs/3-prd-platform/', - 'docs/4-ux-design/', - 'docs/5-design-system/', -]; -``` - -**If 3+ folders found**: - -- Return: `project_structure: "wds_v6"` -- Continue to: v6 phase analysis - ---- - -### Step 3: Check for WPS2C v4 structure (letter phases) - -**Look for letter-based folders:** - -```javascript -const v4Indicators = [ - 'docs/A-Product-Brief/', - 'docs/B-Trigger-Map/', - 'docs/C-Scenarios/', - 'docs/D-Design-System/', - 'docs/E-Backlog/' || 'docs/D-PRD/', -]; -``` - -**If 3+ folders found**: - -- Return: `project_structure: "wps2c_v4"` -- Action: Fetch WPS2C v4 agent instructions from GitHub -- GitHub: `whiteport-sketch-to-code-bmad-expansion` repo - ---- - -### Step 4: Unknown or Mixed Structure - -**If neither pattern matches**: - -- Return: `project_structure: "unknown"` -- Ask user: "Which structure would you like?" - ---- - -## Output Format - -```yaml -project_structure: "wds_v6" | "wps2c_v4" | "empty" | "unknown" -version_detected: "WDS v6" | "WPS2C v4" | "None" -folders_found: [list] -folders_missing: [list] -total_documents: number -``` - ---- - -## Response Templates - -### Empty Project - -``` -📋 Project ready for setup - -This appears to be a new project. To use WDS methodology: - -💡 Recommendation: Start with Product Brief - -**Saga WDS Analyst Agent** specializes in creating Product Briefs through -stakeholder interviews and requirement gathering. - -Would you like me to hand over to Saga? -``` - -### WDS v6 Project Found - -``` -✅ WDS v6 Project Detected - -Workflows: 1-project-brief, 2-trigger-mapping, 4-ux-design... -Documents: [count] files - -Proceeding to detailed analysis... -``` - -### WPS2C v4 Project Found - -``` -✅ WPS2C v4 Project Detected - -Phases: A-Product-Brief, B-Trigger-Map, C-Scenarios... -Documents: [count] files - -Fetching v4 agent instructions from WPS2C repo... -Proceeding to v4 analysis... -``` - -### Unknown Structure - -``` -❓ Non-Standard Project Structure - -I found a docs/ folder but it doesn't match WDS v6 or WPS2C v4. - -Would you like me to: -1. Analyze it anyway (I'll adapt) -2. Set up WDS v6 structure (recommended) -3. Set up WPS2C v4 structure (legacy) -4. Tell me what you need -``` - ---- - -## Next Steps - -After identification: - -- If `wds_v6`: Run v6 phase analysis tasks (1-8) -- If `wps2c_v4`: Fetch GitHub instructions and run v4 analysis (A-E) -- If `empty`: Stop and recommend Saga handoff -- If `unknown`: Wait for user direction - ---- - -## Performance Target - -**Execution time**: <2 seconds -**File operations**: Folder checks only (no file reads) -**Output**: 3-5 lines maximum - ---- - -## GitHub Fallback for v4 - -**If WPS2C v4 detected:** - -```yaml -github_repo: 'whiteport-sketch-to-code-bmad-expansion' -github_file: 'docs/agents/freyja-ux.md' -fallback_action: 'Use v4 analysis pattern from legacy documentation' -``` - -This allows Freyja to work with older projects without requiring updates. diff --git a/src/modules/wds/workflows/1-product-brief/handover/instructions.md b/src/modules/wds/workflows/1-project-brief/handover/instructions.md similarity index 100% rename from src/modules/wds/workflows/1-product-brief/handover/instructions.md rename to src/modules/wds/workflows/1-project-brief/handover/instructions.md diff --git a/src/modules/wds/workflows/1-product-brief/handover/steps/step-01-analyze-brief.md b/src/modules/wds/workflows/1-project-brief/handover/steps/step-01-analyze-brief.md similarity index 100% rename from src/modules/wds/workflows/1-product-brief/handover/steps/step-01-analyze-brief.md rename to src/modules/wds/workflows/1-project-brief/handover/steps/step-01-analyze-brief.md diff --git a/src/modules/wds/workflows/1-product-brief/handover/steps/step-02-create-summary.md b/src/modules/wds/workflows/1-project-brief/handover/steps/step-02-create-summary.md similarity index 100% rename from src/modules/wds/workflows/1-product-brief/handover/steps/step-02-create-summary.md rename to src/modules/wds/workflows/1-project-brief/handover/steps/step-02-create-summary.md diff --git a/src/modules/wds/workflows/1-product-brief/handover/steps/step-03-provide-activation.md b/src/modules/wds/workflows/1-project-brief/handover/steps/step-03-provide-activation.md similarity index 100% rename from src/modules/wds/workflows/1-product-brief/handover/steps/step-03-provide-activation.md rename to src/modules/wds/workflows/1-project-brief/handover/steps/step-03-provide-activation.md