bmad-enhanced 1.3.8 → 1.4.0

package/README.md

@@ -4,8 +4,8 @@
 
 > Strategic framing and validated learning through Emma and Wade
 
-[![Status](https://img.shields.io/badge/status-v1.3.0--complete-success)]()
-[![Version](https://img.shields.io/badge/version-1.3.0-blue)]()
+[![Status](https://img.shields.io/badge/status-v1.3.8--stable-success)]()
+[![Version](https://img.shields.io/badge/version-1.3.8-blue)]()
 [![Workflows](https://img.shields.io/badge/workflows-7_implemented-success)]()
 [![Emma](https://img.shields.io/badge/emma-3_workflows-brightgreen)]()
 [![Wade](https://img.shields.io/badge/wade-4_workflows-brightgreen)]()
@@ -44,29 +44,19 @@ Contextualize Stream       Externalize Stream
 
 ### Prerequisites
 
-**⚠️ IMPORTANT: BMAD Method Required**
-
-BMAD-Enhanced is an extension package. You must have [BMAD Method](https://github.com/bmadhub/bmad) installed first:
-
-```bash
-# Install BMAD Method first
-npx bmad-method@alpha install
-```
-
-**Additional Requirements:**
 - Node.js 14+ or Bun
 - Git
 - Claude Code or Claude.ai
 
-### One-Command Installation
+**Optional:** [BMAD Method](https://github.com/bmadhub/bmad) - BMAD-Enhanced works standalone or as an extension to BMAD Method.
 
-Once BMAD Method is installed:
+### One-Command Installation
 
 ```bash
-npm install bmad-enhanced@1.3.0 && npx bmad-install-agents
+npm install bmad-enhanced && npx bmad-install-agents
 ```
 
-That's it! Emma and Wade (Vortex framework) with all 7 workflows are now added to your BMAD installation.
+That's it! Emma and Wade (Vortex framework) with all 7 workflows are installed.
 
 ### Installation
 
@@ -74,7 +64,7 @@ That's it! Emma and Wade (Vortex framework) with all 7 workflows are now added t
 
 ```bash
 # Install into your project
-npm install bmad-enhanced@1.3.0
+npm install bmad-enhanced
 
 # Install all agents (Emma + Wade) with all 7 workflows
 npx bmad-install-agents
@@ -105,7 +95,7 @@ cat _bmad/bme/_vortex/agents/contextualization-expert.md
   - Wade: mvp, lean-experiment, proof-of-concept, proof-of-value
 - Configuration file (`_bmad/bme/_vortex/config.yaml`)
 - Output directory (`_bmad-output/vortex-artifacts/`)
-- User guides (Emma & Wade v1.2.0)
+- User guides (Emma & Wade)
 
 ### Your First Lean Persona with Emma
 
@@ -212,13 +202,14 @@ npx bmad-update
 
 ### Migration Paths
 
-**From v1.1.x to v1.3.0:**
+**From v1.1.x or v1.2.x to v1.3.x:**
 - No breaking changes
 - Agent files refreshed (bug fixes)
+- Legacy `_designos` directory removed
 - User guides updated
 
-**From v1.0.x to v1.3.0:**
-- ⚠️ Breaking: empathy-map → lean-persona
+**From v1.0.x to v1.3.x:**
+- Breaking: empathy-map → lean-persona
 - Old workflows preserved in `_deprecated/`
 - 7 new workflows installed
 
@@ -263,7 +254,7 @@ All agents built using a standard pattern:
 
 ### Emma (contextualization-expert) - ✅ COMPLETE
 
-**Status:** v1.2.0 - All 3 workflows implemented and ready to use
+**Status:** v1.3.8 - All 3 workflows implemented and ready to use
 **Title:** Contextualization Expert 🎯
 **Stream:** Contextualize
 **Domain:** Strategic framing, problem-product space navigation
@@ -289,7 +280,7 @@ All agents built using a standard pattern:
 
 ### Wade (lean-experiments-specialist) - ✅ COMPLETE
 
-**Status:** v1.2.0 - All 4 workflows implemented and ready to use
+**Status:** v1.3.8 - All 4 workflows implemented and ready to use
 **Title:** Lean Experiments Specialist 🧪
 **Stream:** Externalize
 **Domain:** Lean Startup experimentation, validated learning
@@ -316,30 +307,32 @@ All agents built using a standard pattern:
 
 ## 📊 Project Status
 
-**Current Version:** v1.2.0 - Complete Vortex Framework Implementation ✅
+**Current Version:** v1.3.8 - Complete Vortex Framework + Update/Migration System ✅
 
 **Progress:**
-- ✅ Emma - 3 Contextualize workflows IMPLEMENTED (v1.2.0)
-- ✅ Wade - 4 Externalize workflows IMPLEMENTED (v1.2.0)
+- ✅ Emma - 3 Contextualize workflows IMPLEMENTED
+- ✅ Wade - 4 Externalize workflows IMPLEMENTED
 - ✅ 56 workflow files created (7 workflows × 8 files each)
-- ✅ User guides updated to v1.2.0
+- ✅ Update/migration system with backup and rollback
+- ✅ Standalone installation support (no BMAD Method required)
 
-**What's New in v1.2.0:**
-- **7 complete workflows** - lean-persona, product-vision, contextualize-scope (Emma) + mvp, lean-experiment, proof-of-concept, proof-of-value (Wade)
-- **Lean Startup methodology** - Hypothesis-driven, Build-Measure-Learn cycles
-- **Updated documentation** - Emma & Wade user guides v1.2.0
-- **Deprecated workflows archived** - empathy-map and wireframe moved to `_deprecated/` (still functional)
+**What's New in v1.3.x:**
+- **Update/migration system** - `npx bmad-update`, `npx bmad-version`, `npx bmad-migrate`
+- **Automatic backups** - Before every migration, with rollback on failure
+- **Standalone support** - Works without BMAD Method installed
+- **Legacy cleanup** - Removes deprecated `_designos` directory and old agents
+- **Migration paths** - Supports upgrade from v1.0.x, v1.1.x, v1.2.x
 
 **Roadmap:**
 ```
-v1.1.0               v1.2.0                  v1.3.0              v2.0.0
+v1.1.0               v1.2.0                  v1.3.x ✅            v2.0.0
 ├─────────────────┬────────────────────────┬──────────────────┬──────────────────┤
-│ Repositioning ✅ │  Workflows ✅          │  Tooling 📋      │  Advanced 📋     │
+│ Repositioning ✅ │  Workflows ✅          │  Tooling ✅       │  Advanced 📋     │
 │ • New identity  │  • 7 workflows         │  • Update tools  │  • Multi-agent   │
 │ • Framework     │  • Templates           │  • Migration     │  • Integration   │
 │ • Structure     │  • User guides         │  • Automation    │  • Analytics     │
 └─────────────────┴────────────────────────┴──────────────────┴──────────────────┘
-   Feb 2026            Feb 2026                Q2 2026             Q3 2026
+   Feb 2026            Feb 2026                Feb 2026            Q3 2026
 ```
 
 **See:** [CHANGELOG.md](CHANGELOG.md) for complete version history
@@ -350,10 +343,8 @@ v1.1.0               v1.2.0                  v1.3.0              v2.0.0
 
 ### User Guides
 
-- **[Emma User Guide](_bmad-output/design-artifacts/EMMA-USER-GUIDE.md)** - Complete guide to empathy mapping with Emma
-- Wade User Guide - Coming Week 1, Day 7
-- Quinn User Guide - Coming Week 2, Day 3
-- Stan User Guide - Coming Week 2, Day 7
+- **[Emma User Guide](_bmad-output/vortex-artifacts/EMMA-USER-GUIDE.md)** - Complete guide to strategic contextualization with Emma
+- **[Wade User Guide](_bmad-output/vortex-artifacts/WADE-USER-GUIDE.md)** - Complete guide to lean experiments with Wade
 
 ### Technical Documentation
 
@@ -425,8 +416,8 @@ Clear, comprehensive documentation:
 
 1. **Clone Emma's structure:**
    ```bash
-   cp -r _bmad/bme/_vortex/agents/contextualization-expert.md \
-         _bmad/bme/_designos/agents/your-agent.md
+   cp _bmad/bme/_vortex/agents/contextualization-expert.md \
+      _bmad/bme/_vortex/agents/your-agent.md
    ```
 
 2. **Customize the agent:**
@@ -506,28 +497,18 @@ Clear, comprehensive documentation:
 
 ## 📈 Roadmap
 
-### Current Focus: Week 1-2 (Agent Development)
-
-**Week 1:**
-- ✅ Day 1-2: Emma (contextualization-expert) - COMPLETE
-- ✅ Day 3-7: Wade (lean-experiments-specialist) - COMPLETE
-
-**Week 2:**
-- 📋 Day 1-3: Sage (quality-gatekeeper)
-- 📋 Day 4-7: Stan (standards-auditor)
+### Completed
 
-**Week 3:**
-- 📋 Integration testing (all 4 agents)
-- 📋 Party mode validation
-- 📋 Decision gate (evaluate success, plan next phase)
+- ✅ **v1.1.0** - Vortex Framework repositioning (Emma + Wade)
+- ✅ **v1.2.0** - All 7 workflows implemented (56 files)
+- ✅ **v1.3.x** - Update/migration system with backup and rollback
 
-### Future Phases (TBD)
+### Future (v2.0.0+)
 
-Based on Week 3 decision gate results:
-- Phase 1: Contract foundation (BaseArtifact)
-- Phase 2: Additional agent capabilities
-- Phase 3: Cross-agent collaboration patterns
-- Phase 4: Community agents (open for contributions)
+- 📋 Multi-agent collaboration patterns
+- 📋 Cross-agent workflow integration
+- 📋 Analytics and reporting
+- 📋 Community agent contributions
 
 ---
 
@@ -570,7 +551,7 @@ We welcome contributions! Areas where we need help:
 - No validation plan for strategy
 - Weeks of strategic discussion
 
-**After (v1.2.0):**
+**After (v1.3.x):**
 - Clear problem space framing: 1-2 hours
 - Explicit assumption mapping
 - Built-in validation planning
@@ -586,7 +567,7 @@ We welcome contributions! Areas where we need help:
 - No structured experiment process
 - 6-12 months to market validation
 
-**After (v1.2.0):**
+**After (v1.3.x):**
 - Rapid experiment design: 2-3 hours
 - Minimal investment in learning
 - Structured Build-Measure-Learn cycles
@@ -613,13 +594,13 @@ We welcome contributions! Areas where we need help:
 ### Emma (Operational Metrics)
 
 **Adoption (Target):**
-- 50+ teams using Emma for empathy mapping
+- 50+ teams using Emma for strategic contextualization
 - 80%+ complete the full 6-step workflow
 - NPS ≥8
 
 **Quality (Target):**
-- 90%+ empathy maps grounded in research evidence
-- 95%+ artifacts include all required sections
+- 90%+ lean personas grounded in research evidence
+- 95%+ artifacts include all required sections (assumptions, validation plan)
 
 **Performance (Measured):**
 - Complete workflow: 30-60 minutes
@@ -628,14 +609,14 @@ We welcome contributions! Areas where we need help:
 ### Wade (Operational Metrics)
 
 **Adoption (Target):**
-- 50+ teams using Wade for wireframing
+- 50+ teams using Wade for lean experiments
 - 80%+ complete the full 6-step workflow
 - NPS ≥8
 
 **Quality (Target):**
-- 90%+ wireframes include complete information architecture
-- 95%+ artifacts include component catalog and interactions
-- 85%+ pass usability validation checklist
+- 90%+ experiments include clear hypothesis and success metrics
+- 95%+ artifacts include pivot-or-persevere decision criteria
+- 85%+ pass validated learning checklist
 
 **Performance (Measured):**
 - Complete workflow: 45-90 minutes
@@ -645,7 +626,7 @@ We welcome contributions! Areas where we need help:
 
 **Adoption:**
 - 100+ teams using BMAD-Enhanced agents
-- 4/4 agents in production
+- 2/2 Vortex agents in production
 - Community agents contributed
 
 **Quality:**
@@ -656,63 +637,62 @@ We welcome contributions! Areas where we need help:
 
 ## 🔍 Sample Output
 
-### Emma Empathy Map Artifact
+### Emma Lean Persona Artifact
 
-Emma generates comprehensive empathy maps with:
+Emma generates comprehensive lean personas with:
 
 **Executive Summary:**
-- 3-5 key insights from research
-- Top 3 pain points
-- Top 3 desired gains
+- Jobs-to-be-done identification
+- Top riskiest assumptions
+- Validation plan priorities
 
 **Detailed Sections:**
-- Target user profile (demographics, job-to-be-done, context)
-- Says & Thinks (quotes + inferred thoughts)
-- Does & Feels (actions + emotions)
+- Target user profile (demographics, context, goals)
+- Jobs-to-be-done (functional, emotional, social)
 - Pain points (prioritized: HIGH/MEDIUM/LOW)
-- Desired gains (prioritized: HIGH/MEDIUM/LOW)
+- Current alternatives and workarounds
+- Riskiest assumptions (ranked by impact and uncertainty)
 
-**Design Implications:**
-- What to prioritize
-- What to avoid
-- What to focus on
+**Validation Planning:**
+- Which assumptions to test first
+- Suggested experiment types
+- Success/failure criteria
 
-**Feature Prioritization Matrix:**
-| Pain Point | Desired Gain | Design Opportunity | Priority |
-|------------|--------------|-------------------|----------|
-| Multi-step auth | Seamless biometric | Face ID-only login | HIGH |
+**Assumption Prioritization Matrix:**
+| Assumption | Risk Level | Experiment Type | Priority |
+|------------|-----------|-----------------|----------|
+| Users want X | HIGH | Interview | P0 |
 
-**See:** [Sample Empathy Map](_bmad-output/test-artifacts/emma-tests/results/empathy-map-sarah-chen-2026-02-14.md)
+**See:** [Emma User Guide](_bmad-output/vortex-artifacts/EMMA-USER-GUIDE.md) for examples
 
-### Wade Wireframe Artifact
+### Wade MVP Specification Artifact
 
-Wade generates comprehensive wireframes with:
+Wade generates comprehensive MVP specs with:
 
 **Executive Summary:**
-- Product context and user goals
-- Key user flows (3-5 primary flows)
-- Design priorities and constraints
+- Riskiest assumption to test
+- MVP type and scope
+- Build-Measure-Learn cycle plan
 
 **Detailed Sections:**
-- Information Architecture (sitemap, navigation hierarchy, content structure)
-- Screen Layouts (annotated wireframes for key screens)
-- Component Catalog (UI components with specifications)
-- Interaction Flows (user journey maps with screen transitions)
-- Responsive Considerations (mobile, tablet, desktop breakpoints)
-
-**Usability Validation:**
-- Navigation clarity assessment
-- Content hierarchy review
-- Interaction pattern consistency
-- Accessibility considerations
-
-**Design Handoff:**
-- Component specifications
-- Interaction states
-- Content requirements
-- Technical notes
-
-**See:** [Wade User Guide](_bmad-output/design-artifacts/WADE-USER-GUIDE.md) for examples
+- Hypothesis statement (testable, falsifiable)
+- MVP scope (minimum needed to test assumption)
+- Success metrics (quantitative thresholds)
+- Measurement plan (how to collect data)
+- Timeline and resource requirements
+
+**Experiment Design:**
+- Target audience and sample size
+- Data collection methods
+- Analysis approach
+- Pivot-or-persevere decision criteria
+
+**Decision Framework:**
+- Evidence thresholds for persevere
+- Evidence thresholds for pivot
+- Kill criteria
+
+**See:** [Wade User Guide](_bmad-output/vortex-artifacts/WADE-USER-GUIDE.md) for examples
 
 ---
 
@@ -720,14 +700,13 @@ Wade generates comprehensive wireframes with:
 
 ### For Users
 
-**Emma (Empathy Mapping):**
-- **[Emma User Guide](_bmad-output/design-artifacts/EMMA-USER-GUIDE.md)** - Complete guide with examples
-- **[Sample Empathy Map](_bmad-output/test-artifacts/emma-tests/results/empathy-map-sarah-chen-2026-02-14.md)** - Real output example
-- Emma's chat mode (CH command) - Ask Emma questions about empathy mapping
+**Emma (Strategic Contextualization):**
+- **[Emma User Guide](_bmad-output/vortex-artifacts/EMMA-USER-GUIDE.md)** - Complete guide with examples
+- Emma's chat mode (CH command) - Ask Emma questions about lean personas, product vision, and scope
 
-**Wade (Wireframing):**
-- **[Wade User Guide](_bmad-output/design-artifacts/WADE-USER-GUIDE.md)** - Complete guide with examples
-- Wade's chat mode (CH command) - Ask Wade questions about wireframe design and UI patterns
+**Wade (Lean Experiments):**
+- **[Wade User Guide](_bmad-output/vortex-artifacts/WADE-USER-GUIDE.md)** - Complete guide with examples
+- Wade's chat mode (CH command) - Ask Wade questions about MVPs, experiments, and validated learning
 
 ### For Developers
 
@@ -747,7 +726,7 @@ Wade generates comprehensive wireframes with:
 
 ### 1. Domain Specialization Over Generic Tools
 
-Each agent brings deep expertise in a specific domain (UX research, design, quality, standards) rather than generic capabilities.
+Each agent brings deep expertise in a specific domain (strategic framing, lean experimentation) rather than generic capabilities.
 
 ### 2. Standard Interface, Diverse Expertise
 
@@ -755,7 +734,7 @@ All agents use BMAD Agent Architecture Framework for consistency, but each has u
 
 ### 3. Research-Driven Design
 
-Workflows based on proven frameworks (Jobs-to-be-Done, design thinking, quality engineering, compliance standards).
+Workflows based on proven frameworks (Jobs-to-be-Done, Lean Startup, Build-Measure-Learn).
 
 ### 4. Test-First Development
 
@@ -807,7 +786,7 @@ Built on:
 
 **Original vision (archived):** [ORIGINAL-VISION-README.md](_bmad-output/planning-artifacts/ORIGINAL-VISION-README.md)
 
-**Current approach:** Build 4 expert agents using BMAD Agent Architecture Framework (Emma, Wade, Quinn, Stan).
+**Current approach:** Vortex Framework with 2 specialized agents (Emma, Wade) using BMAD Agent Architecture Framework.
 
 ### What happened to empathy mapping and wireframing?
 
@@ -832,7 +811,7 @@ Built on:
 
 ### Are the new workflows ready?
 
-**Yes! v1.2.0 released February 2026.** All 7 workflows are fully implemented and ready to use:
+**Yes! All 7 workflows are fully implemented (since v1.2.0) and ready to use:**
 
 **Emma (Contextualize):**
 - lean-persona (6-step workflow)
@@ -872,7 +851,7 @@ Each workflow includes templates, step files, and comprehensive guidance.
 
 [Get Started](#quick-start) • [Documentation](#documentation) • [Roadmap](#roadmap)
 
-**Current Status:** ✅ v1.1.0 Repositioned | 📋 v1.2.0 Workflows Coming March 2026
+**Current Status:** ✅ v1.3.8 Stable - Vortex Framework Complete
 
 Made with ❤️ by the BMAD-Enhanced community
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bmad-enhanced",
-  "version": "1.3.8",
+  "version": "1.4.0",
   "description": "Vortex Framework - Contextualize and Externalize streams for Lean Startup validation",
   "main": "index.js",
   "bin": {