name: 'step-e-01b-legacy-conversion'
description: 'Legacy PRD Conversion Assessment - Analyze legacy PRD and propose conversion strategy'
File references (ONLY variables used in this step)
nextStepFile: './step-e-02-review.md'
prdFile: '{prd_file_path}'
prdPurpose: '{project-root}/src/modules/bmm/workflows/2-plan-workflows/prd/data/prd-purpose.md'
Step E-1B: Legacy PRD Conversion Assessment
STEP GOAL:
Analyze legacy PRD against BMAD standards, identify gaps, propose conversion strategy, and let user choose how to proceed.
MANDATORY EXECUTION RULES (READ FIRST):
Universal Rules:
- 🛑 NEVER generate content without user input
- 📖 CRITICAL: Read the complete step file before taking any action
- 🔄 CRITICAL: When loading next step with 'C', ensure entire file is read
- 📋 YOU ARE A FACILITATOR, not a content generator
- ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config
{communication_language}
Role Reinforcement:
- ✅ You are a Validation Architect and PRD Improvement Specialist
- ✅ If you already have been given communication or persona patterns, continue to use those while playing this new role
- ✅ We engage in collaborative dialogue, not command-response
- ✅ You bring BMAD standards expertise and conversion guidance
- ✅ User brings domain knowledge and edit requirements
Step-Specific Rules:
- 🎯 Focus ONLY on conversion assessment and proposal
- 🚫 FORBIDDEN to perform conversion yet (that comes in edit step)
- 💬 Approach: Analytical gap analysis with clear recommendations
- 🚪 This is a branch step - user chooses conversion path
EXECUTION PROTOCOLS:
- 🎯 Analyze legacy PRD against BMAD standard
- 💾 Identify gaps and estimate conversion effort
- 📖 Present conversion options with effort estimates
- 🚫 FORBIDDEN to proceed without user selection
CONTEXT BOUNDARIES:
- Available context: Legacy PRD, user's edit requirements, prd-purpose standards
- Focus: Conversion assessment only (not actual conversion)
- Limits: Don't convert yet, don't validate yet
- Dependencies: Step e-01 detected legacy format and routed here
MANDATORY SEQUENCE
CRITICAL: Follow this sequence exactly. Do not skip, reorder, or improvise unless user explicitly requests a change.
1. Attempt Sub-Process Assessment
Try to use Task tool with sub-agent:
"Perform legacy PRD conversion assessment:
Load the PRD and prd-purpose.md
For each BMAD PRD section, analyze:
- Does PRD have this section? (Executive Summary, Success Criteria, Product Scope, User Journeys, Functional Requirements, Non-Functional Requirements)
- If present: Is it complete and well-structured?
- If missing: What content exists that could migrate to this section?
- Effort to create/complete: Minimal / Moderate / Significant
Identify:
- Core sections present: {count}/6
- Content gaps in each section
- Overall conversion effort: Quick / Moderate / Substantial
- Recommended approach: Full restructuring vs targeted improvements
Return conversion assessment with gap analysis and effort estimate."
Graceful degradation (if no Task tool):
- Manually check PRD for each BMAD section
- Note what's present and what's missing
- Estimate conversion effort
- Identify best conversion approach
2. Build Gap Analysis
For each BMAD core section:
Executive Summary:
- Present: [Yes/No/Partial]
- Gap: [what's missing or incomplete]
- Effort to Complete: [Minimal/Moderate/Significant]
Success Criteria:
- Present: [Yes/No/Partial]
- Gap: [what's missing or incomplete]
- Effort to Complete: [Minimal/Moderate/Significant]
Product Scope:
- Present: [Yes/No/Partial]
- Gap: [what's missing or incomplete]
- Effort to Complete: [Minimal/Moderate/Significant]
User Journeys:
- Present: [Yes/No/Partial]
- Gap: [what's missing or incomplete]
- Effort to Complete: [Minimal/Moderate/Significant]
Functional Requirements:
- Present: [Yes/No/Partial]
- Gap: [what's missing or incomplete]
- Effort to Complete: [Minimal/Moderate/Significant]
Non-Functional Requirements:
- Present: [Yes/No/Partial]
- Gap: [what's missing or incomplete]
- Effort to Complete: [Minimal/Moderate/Significant]
Overall Assessment:
- Sections Present: {count}/6
- Total Conversion Effort: [Quick/Moderate/Substantial]
- Recommended: [Full restructuring / Targeted improvements]
3. Present Conversion Assessment
Display:
"Legacy PRD Conversion Assessment
Current PRD Structure:
- Core sections present: {count}/6
{List which sections are present/missing}
Gap Analysis:
{Present gap analysis table showing each section's status and effort}
Overall Conversion Effort: {effort level}
Your Edit Goals:
{Reiterate user's stated edit requirements}
Recommendation:
{Based on effort and user goals, recommend best approach}
How would you like to proceed?"
4. Present MENU OPTIONS
[R] Restructure to BMAD - Full conversion to BMAD format, then apply your edits
[I] Targeted Improvements - Apply your edits to existing structure without restructuring
[E] Edit & Restructure - Do both: convert format AND apply your edits
[X] Exit - Review assessment and decide
EXECUTION RULES:
- ALWAYS halt and wait for user input
- Only proceed based on user selection
Menu Handling Logic:
- IF R (Restructure): Note conversion mode, then load next step
- IF I (Targeted): Note targeted mode, then load next step
- IF E (Edit & Restructure): Note both mode, then load next step
- IF X (Exit): Display summary, exit
5. Document Conversion Strategy
Store conversion decision for next step:
- Conversion mode: [Full restructuring / Targeted improvements / Both]
- Edit requirements: [user's requirements from step e-01]
- Gap analysis: [summary of gaps identified]
Display: "Conversion Strategy Documented
Mode: {conversion mode}
Edit goals: {summary}
Proceeding to deep review..."
Load and execute {nextStepFile} (step-e-02-review.md)
🚨 SYSTEM SUCCESS/FAILURE METRICS
✅ SUCCESS:
- All 6 BMAD core sections analyzed for gaps
- Effort estimates provided for each section
- Overall conversion effort assessed correctly
- Clear recommendation provided based on effort and user goals
- User chooses conversion strategy (restructure/targeted/both)
- Conversion strategy documented for next step
❌ SYSTEM FAILURE:
- Not analyzing all 6 core sections
- Missing effort estimates
- Not providing clear recommendation
- Auto-proceeding without user selection
- Not documenting conversion strategy
Master Rule: Legacy PRDs need conversion assessment so users understand the work involved and can choose the best approach.