bmad-enhanced 1.3.1 → 1.3.2

package/_bmad/bme/_vortex/workflows/_deprecated/wireframe/wireframe.template.md

@@ -0,0 +1,287 @@
+---
+artifact: wireframe
+version: 1.0.0
+created: {date}
+screen: {screen_name}
+platform: {platform}
+author: Wade (lean-experiments-specialist)
+---
+
+# Wireframe: {screen_name}
+
+**Platform:** {platform}
+**Target User:** {target_user}
+**Created:** {date}
+**Designer:** Wade (lean-experiments-specialist)
+
+---
+
+## Executive Summary
+
+**Screen Purpose:** {primary_action}
+
+**Key Design Decisions:**
+- {decision_1}
+- {decision_2}
+- {decision_3}
+
+**Target Breakpoints:**
+- Mobile: 375px (primary focus for mobile-first)
+- Tablet: 768px
+- Desktop: 1024px+
+
+**Accessibility Compliance:** WCAG 2.1 Level AA
+
+---
+
+## 1. Requirements
+
+### Screen Information
+- **Screen Name:** {screen_name}
+- **Platform:** {platform}
+- **Target User:** {target_user}
+- **Primary Action:** {primary_action}
+
+### Constraints
+{constraints}
+
+### Success Criteria
+{success_criteria}
+
+---
+
+## 2. User Flows
+
+### Entry Points
+{entry_points}
+
+### Happy Path
+{happy_path}
+
+### Alternative Flows
+{alternative_flows}
+
+### Exit Points
+{exit_points}
+
+---
+
+## 3. Information Architecture
+
+### Visual Hierarchy
+1. **Primary (Hero):** {primary_content}
+2. **Secondary (Supporting):** {secondary_content}
+3. **Tertiary (Metadata):** {tertiary_content}
+
+### Content Grouping
+{content_grouping}
+
+### Navigation Patterns
+{navigation_patterns}
+
+### Information Density
+- **Mobile:** {mobile_density}
+- **Desktop:** {desktop_density}
+
+---
+
+## 4. Wireframe Sketches
+
+### Mobile View (375px)
+
+```
+{mobile_wireframe_ascii}
+```
+
+**Annotations:**
+- {mobile_annotation_1}
+- {mobile_annotation_2}
+- {mobile_annotation_3}
+
+### Desktop View (1024px+)
+
+```
+{desktop_wireframe_ascii}
+```
+
+**Annotations:**
+- {desktop_annotation_1}
+- {desktop_annotation_2}
+- {desktop_annotation_3}
+
+---
+
+## 5. Component Specifications
+
+### Component Library
+
+{component_specifications}
+
+**Example Component Detail:**
+
+#### {component_name}
+- **Type:** {component_type}
+- **Location:** {component_location}
+- **Size:** {component_size}
+- **States:** {component_states}
+- **Behavior:** {component_behavior}
+
+---
+
+## 6. Interaction Design
+
+### Interactive Elements
+
+{interactive_elements}
+
+### States & Feedback
+
+{states_feedback}
+
+### Gestures & Input
+
+**Mobile:**
+- {mobile_gesture_1}
+- {mobile_gesture_2}
+
+**Desktop:**
+- {desktop_interaction_1}
+- {desktop_interaction_2}
+
+---
+
+## 7. Responsive Breakpoints
+
+### Breakpoint Strategy
+
+| Breakpoint | Width | Layout Changes |
+|------------|-------|----------------|
+| Mobile     | 375px | {mobile_layout_changes} |
+| Tablet     | 768px | {tablet_layout_changes} |
+| Desktop    | 1024px+ | {desktop_layout_changes} |
+
+### Adaptive Patterns
+{adaptive_patterns}
+
+---
+
+## 8. Accessibility Notes
+
+### WCAG 2.1 Compliance
+
+**Level AA Requirements:**
+- {accessibility_requirement_1}
+- {accessibility_requirement_2}
+- {accessibility_requirement_3}
+
+### Keyboard Navigation
+{keyboard_navigation}
+
+### Screen Reader Support
+{screen_reader_support}
+
+### Focus Management
+{focus_management}
+
+### Color Contrast
+{color_contrast_notes}
+
+---
+
+## 9. Design Rationale
+
+### Why This Layout?
+{layout_rationale}
+
+### Why This Information Hierarchy?
+{hierarchy_rationale}
+
+### Why These Components?
+{component_rationale}
+
+### Trade-offs Considered
+{tradeoffs}
+
+---
+
+## 10. Next Steps
+
+### For High-Fidelity Design
+- [ ] {hifi_step_1}
+- [ ] {hifi_step_2}
+- [ ] {hifi_step_3}
+
+### For Prototyping
+- [ ] {prototype_step_1}
+- [ ] {prototype_step_2}
+- [ ] {prototype_step_3}
+
+### For Development
+- [ ] {dev_step_1}
+- [ ] {dev_step_2}
+- [ ] {dev_step_3}
+
+### For User Testing
+- [ ] {testing_step_1}
+- [ ] {testing_step_2}
+- [ ] {testing_step_3}
+
+---
+
+## Appendix
+
+### Grid System
+- **Mobile:** 8pt grid, 16px margins
+- **Desktop:** 12-column grid, 24px gutters
+
+### Typography Scale
+- **H1:** 24-32px (Screen title)
+- **H2:** 20-24px (Section headers)
+- **Body:** 16px (Content text)
+- **Caption:** 12-14px (Metadata)
+
+### Spacing System
+- **XS:** 4px
+- **S:** 8px
+- **M:** 16px
+- **L:** 24px
+- **XL:** 32px
+- **XXL:** 48px
+
+### Component Heights
+- **Header:** 56-72px
+- **Bottom Navigation:** 48-72px
+- **Button:** 44-48px (mobile), 36-40px (desktop)
+- **Input Field:** 44-48px (mobile), 36-40px (desktop)
+- **List Item:** 56-72px
+
+---
+
+**Document Version:** 1.0.0
+**Last Updated:** {date}
+**Designer:** Wade (lean-experiments-specialist)
+**Status:** Draft for Review
+
+---
+
+## Document Control
+
+**Change History:**
+
+| Version | Date | Changes | Author |
+|---------|------|---------|--------|
+| 1.0.0   | {date} | Initial wireframe created | Wade |
+
+**Approvals Required:**
+- [ ] Product Manager
+- [ ] UX Lead
+- [ ] Engineering Lead
+- [ ] Accessibility Specialist
+
+---
+
+**Questions or Feedback?**
+
+Contact the design team or leave comments in this document.
+
+Great work! This wireframe provides a solid foundation for your design and development. 🎨

package/_bmad/bme/_vortex/workflows/_deprecated/wireframe/workflow.md

@@ -0,0 +1,44 @@
+---
+workflow: wireframe
+type: step-file
+description: Create wireframes through structured 6-step process
+author: Wade (lean-experiments-specialist)
+---
+
+# Create Wireframe Workflow
+
+This workflow guides you through creating comprehensive wireframes for web or mobile applications.
+
+## What is a Wireframe?
+
+A wireframe is a low-fidelity visual representation of a user interface. It defines the structure, layout, and functionality of screens without focusing on visual design details like colors or fonts. Wireframes answer: Where am I? What can I do? Where can I go?
+
+## Workflow Structure
+
+**Step-file architecture:**
+- Just-in-time loading (each step loads only when needed)
+- Sequential enforcement (must complete step N before step N+1)
+- State tracking in frontmatter (progress preserved)
+
+## Steps Overview
+
+1. **Define Requirements** - What screen, platform, user, functionality?
+2. **User Flows** - How do users navigate? Entry → Goal → Exit
+3. **Information Architecture** - How is content organized and prioritized?
+4. **Wireframe Sketch** - Create layout using ASCII art and grids
+5. **Components & Interactions** - Specify UI components, states, behaviors
+6. **Synthesize** - Create the final wireframe artifact
+
+## Output
+
+**Artifact:** Wireframe markdown file in `{output_folder}/wireframe-{screen-name}-{date}.md`
+
+**Template:** Uses [wireframe.template.md](wireframe.template.md)
+
+---
+
+## INITIALIZATION
+
+Load config from {project-root}/_bmad/bme/_designos/config.yaml
+
+Load step: {project-root}/_bmad/bme/_designos/workflows/wireframe/steps/step-01-define-requirements.md

package/_bmad/bme/_vortex/workflows/contextualize-scope/contextualize-scope.template.md

@@ -0,0 +1,67 @@
+---
+title: "Scope Decision: {scope-name}"
+date: {date}
+created-by: {user-name} with Emma (contextualization-expert)
+type: scope-decision
+status: DECIDED
+version: 1.0
+---
+
+# Scope Decision: {scope-name}
+
+## Decision Summary
+
+**Selected Problem Space:** {selected-scope}
+
+**Rationale:** {selection-rationale}
+
+**De-scoped (Not Now):** {descoped-problems}
+
+---
+
+## Problem Opportunities Considered
+
+{opportunities-list}
+
+---
+
+## Evaluation Criteria
+
+{criteria-list}
+
+---
+
+## Scoring Matrix
+
+{scoring-matrix}
+
+---
+
+## Selected Scope
+
+### Problem Space
+{problem-space}
+
+### Boundaries (What's In)
+{scope-in}
+
+### Boundaries (What's Out)
+{scope-out}
+
+---
+
+## Strategic Fit
+
+{strategic-fit-analysis}
+
+---
+
+## Next Steps
+
+{next-steps}
+
+---
+
+**Created with:** BMAD-Enhanced v1.2.0 - Vortex Framework (Contextualize Stream)
+**Agent:** Emma (Contextualization Expert)
+**Workflow:** contextualize-scope

package/_bmad/bme/_vortex/workflows/contextualize-scope/steps/step-01-list-opportunities.md

@@ -0,0 +1,47 @@
+---
+step: 1
+workflow: contextualize-scope
+title: List Problem Opportunities
+---
+
+# Step 1: List Problem Opportunities
+
+What problems could you solve? Let's get them all on the table before deciding.
+
+## Why This Matters
+
+You can't make a good decision without seeing all options. Listing opportunities ensures you don't miss something important.
+
+## Your Task
+
+List 3-7 problem opportunities you could investigate. For each, provide:
+
+### 1. Problem name (short label)
+### 2. Problem description (1-2 sentences)
+### 3. Who experiences this problem?
+### 4. Rough market size estimate
+### 5. Initial gut feeling (High/Medium/Low interest)
+
+## Example
+
+**Opportunity A: Team Status Visibility**
+- Remote managers lack real-time visibility into distributed team progress
+- Managers of 5-20 person distributed software teams
+- ~2M teams globally, $15B TAM
+- Interest: HIGH
+
+**Opportunity B: Meeting Overload**
+- Teams waste 10+ hours/week in unnecessary meetings
+- Knowledge workers at companies 50-500 employees
+- ~10M workers globally, $50B TAM
+- Interest: MEDIUM
+
+---
+
+## Your Turn
+
+List your problem opportunities.
+
+## Next Step
+
+{project-root}/_bmad/bme/_vortex/workflows/contextualize-scope/steps/step-02-define-criteria.md

package/_bmad/bme/_vortex/workflows/contextualize-scope/steps/step-02-define-criteria.md

@@ -0,0 +1,36 @@
+---
+step: 2
+workflow: contextualize-scope
+title: Define Evaluation Criteria
+---
+
+# Step 2: Define Evaluation Criteria
+
+How will you decide which problem to pursue?
+
+## Your Task
+
+Define 3-5 criteria for evaluating opportunities. Common criteria:
+
+- **Impact:** How many people does this affect? How painful is it?
+- **Feasibility:** Can we actually build this? Do we have the expertise?
+- **Strategic Fit:** Does this align with our vision and strengths?
+- **Market Opportunity:** Size of market? Willingness to pay?
+- **Time to Value:** How quickly can we validate this?
+
+## Example
+
+1. **Impact** (Weight: 30%) - Number of users × problem intensity
+2. **Feasibility** (Weight: 25%) - Team expertise + technical complexity
+3. **Strategic Fit** (Weight: 25%) - Alignment with long-term vision
+4. **Speed to Validation** (Weight: 20%) - Can we test this in <3 months?
+
+---
+
+## Your Turn
+
+Define your evaluation criteria with weights.
+
+## Next Step
+
+{project-root}/_bmad/bme/_vortex/workflows/contextualize-scope/steps/step-03-evaluate-opportunities.md

package/_bmad/bme/_vortex/workflows/contextualize-scope/steps/step-03-evaluate-opportunities.md

@@ -0,0 +1,30 @@
+---
+step: 3
+workflow: contextualize-scope
+title: Evaluate Each Opportunity
+---
+
+# Step 3: Evaluate Each Opportunity
+
+Score each opportunity against your criteria.
+
+## Your Task
+
+For each opportunity, score 1-10 on each criterion. Calculate weighted scores.
+
+## Example
+
+| Opportunity | Impact | Feasibility | Strategic Fit | Speed | Total |
+|------------|--------|-------------|---------------|-------|-------|
+| Team Status| 9      | 8           | 9             | 7     | 8.25  |
+| Meetings   | 7      | 6           | 5             | 8     | 6.45  |
+
+---
+
+## Your Turn
+
+Score your opportunities.
+
+## Next Step
+
+{project-root}/_bmad/bme/_vortex/workflows/contextualize-scope/steps/step-04-define-boundaries.md

package/_bmad/bme/_vortex/workflows/contextualize-scope/steps/step-04-define-boundaries.md

@@ -0,0 +1,32 @@
+---
+step: 4
+workflow: contextualize-scope
+title: Define Scope Boundaries
+---
+
+# Step 4: Define Scope Boundaries
+
+What's IN scope? What's OUT?
+
+## Your Task
+
+Define clear boundaries:
+
+### What's IN Scope
+- Which user segment?
+- Which use cases?
+- Which geography/market?
+
+### What's OUT of Scope
+- What are you explicitly NOT solving?
+- What's phase 2 or phase 3?
+
+---
+
+## Your Turn
+
+Define your scope boundaries.
+
+## Next Step
+
+{project-root}/_bmad/bme/_vortex/workflows/contextualize-scope/steps/step-05-validate-fit.md

package/_bmad/bme/_vortex/workflows/contextualize-scope/steps/step-05-validate-fit.md

@@ -0,0 +1,28 @@
+---
+step: 5
+workflow: contextualize-scope
+title: Validate Strategic Fit
+---
+
+# Step 5: Validate Strategic Fit
+
+Does this choice align with your vision, team, and resources?
+
+## Your Task
+
+Validate fit across dimensions:
+
+1. **Vision Alignment:** Does this serve your product vision?
+2. **Team Capabilities:** Do you have the skills to execute?
+3. **Resource Requirements:** Can you afford to investigate this?
+4. **Market Timing:** Is now the right time?
+
+---
+
+## Your Turn
+
+Validate strategic fit.
+
+## Next Step
+
+{project-root}/_bmad/bme/_vortex/workflows/contextualize-scope/steps/step-06-synthesize.md

package/_bmad/bme/_vortex/workflows/contextualize-scope/steps/step-06-synthesize.md

@@ -0,0 +1,30 @@
+---
+step: 6
+workflow: contextualize-scope
+title: Synthesize
+---
+
+# Step 6: Synthesize
+
+Create the final scope decision document.
+
+## Your Task
+
+Provide final decision summary:
+
+1. **Selected scope** and why
+2. **De-scoped opportunities** and why not now
+3. **Next steps** (suggested: lean-persona → mvp → lean-experiment)
+
+---
+
+## Workflow Complete
+
+Next suggested workflows:
+- **lean-persona** to understand your target user
+- **Wade's mvp** to design your minimum viable product
+- **Wade's lean-experiment** to validate assumptions
+
+---
+
+**Created with:** BMAD-Enhanced v1.2.0

package/_bmad/bme/_vortex/workflows/contextualize-scope/validate.md

@@ -0,0 +1,30 @@
+# Validate Scope Decision
+
+**Status:** Coming in v1.2.0
+
+**Agent:** Emma (Contextualization Expert)
+
+**Stream:** Contextualize
+
+## Overview
+
+This validation workflow helps you review scope decisions to ensure they're data-driven and strategically sound.
+
+## What Gets Validated
+
+- Are all relevant opportunities considered?
+- Are evaluation criteria clear and measurable?
+- Is scoring consistent across opportunities?
+- Is the decision rationale well-documented?
+- Are de-scoped opportunities captured for future reference?
+- Does this align with product vision?
+
+## Coming in v1.2.0
+
+This validation workflow will be available alongside the contextualize-scope workflow in March 2026.
+
+## Questions?
+
+For questions or to request early access:
+- GitHub Issues: https://github.com/amalik/BMAD-Enhanced/issues
+- Tag with: `workflow:contextualize-scope` and `v1.2.0`

package/_bmad/bme/_vortex/workflows/contextualize-scope/workflow.md

@@ -0,0 +1,59 @@
+---
+workflow: contextualize-scope
+type: step-file
+description: Decide which problem space to investigate using strategic evaluation
+author: Emma (contextualization-expert)
+version: 1.2.0
+---
+
+# Contextualize Scope Workflow
+
+This workflow guides you through deciding which problem space to investigate by evaluating opportunities systematically.
+
+## What is Scope Contextualization?
+
+Scope contextualization is the strategic decision of where to focus your investigation. You likely have multiple problems you could solve - this workflow helps you choose wisely by:
+
+- **Identifying all opportunities** - What problems are on the table?
+- **Defining evaluation criteria** - What matters most (impact, feasibility, strategic fit)?
+- **Scoring systematically** - Rate each opportunity against criteria
+- **Deciding with rationale** - Choose one, document why
+- **De-scoping intentionally** - Say "no" to others (for now)
+
+## Why This Matters
+
+Choosing the wrong problem space wastes months of effort. This workflow ensures:
+- You're solving a problem worth solving
+- You pick the problem you can actually solve
+- You don't spread resources across too many problems
+- You can defend your choice with evidence
+
+## Workflow Structure
+
+**Step-file architecture:**
+- Just-in-time loading (each step loads only when needed)
+- Sequential enforcement (must complete step N before step N+1)
+- State tracking in frontmatter (progress preserved)
+
+## Steps Overview
+
+1. **List Problem Opportunities** - What problems could you solve?
+2. **Define Evaluation Criteria** - How will you choose?
+3. **Evaluate Each Opportunity** - Score against criteria
+4. **Define Scope Boundaries** - What's in? What's out?
+5. **Validate Strategic Fit** - Does this align with vision/resources?
+6. **Synthesize** - Create scope decision document
+
+## Output
+
+**Artifact:** Scope decision document in `{output_folder}/scope-decision-{scope-name}-{date}.md`
+
+**Template:** Uses [contextualize-scope.template.md](contextualize-scope.template.md)
+
+---
+
+## INITIALIZATION
+
+Load config from {project-root}/_bmad/bme/_vortex/config.yaml
+
+Load step: {project-root}/_bmad/bme/_vortex/workflows/contextualize-scope/steps/step-01-list-opportunities.md