bmad-method 6.0.0-alpha.13 → 6.0.0-alpha.15

package/src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/instructions.md

@@ -1,387 +0,0 @@
-# Epic and Story Creation with Full Technical Context
-
-<critical>The workflow execution engine is governed by: {project-root}/{bmad_folder}/core/tasks/workflow.xml</critical>
-<critical>You MUST have already loaded and processed: {installed_path}/workflow.yaml</critical>
-<critical>PREREQUISITES: PRD.md AND Architecture.md MUST be completed before running this workflow</critical>
-<critical>UX Design.md is highly recommended if the product has user interfaces</critical>
-<critical>EVERY story must be completable by a single dev agent in one focused session</critical>
-<critical>⚠️ EPIC STRUCTURE PRINCIPLE: Each epic MUST deliver USER VALUE, not just technical capability. Epics are NOT organized by technical layers (database, API, frontend). Each epic should result in something USERS can actually use or benefit from. Exception: Foundation/setup stories at the start of first epic are acceptable.</critical>
-<critical>Communicate all responses in {communication_language} and adapt to {user_skill_level}</critical>
-<critical>Generate all documents in {document_output_language}</critical>
-<critical>LIVING DOCUMENT: Write to epics.md continuously as you work - never wait until the end</critical>
-<critical>Input documents specified in workflow.yaml input_file_patterns - workflow engine handles fuzzy matching, whole vs sharded document discovery automatically</critical>
-<critical>⚠️ ABSOLUTELY NO TIME ESTIMATES - NEVER mention hours, days, weeks, months, or ANY time-based predictions. AI has fundamentally changed development speed - what once took teams weeks/months can now be done by one person in hours. DO NOT give ANY time estimates whatsoever.</critical>
-<critical>⚠️ CHECKPOINT PROTOCOL: After EVERY <template-output> tag, you MUST follow workflow.xml substep 2c: SAVE content to file immediately → SHOW checkpoint separator (━━━━━━━━━━━━━━━━━━━━━━━) → DISPLAY generated content → PRESENT options [a]Advanced Elicitation/[c]Continue/[p]Party-Mode/[y]YOLO → WAIT for user response. Never batch saves or skip checkpoints.</critical>
-
-<workflow>
-
-<step n="0" goal="Validate prerequisites and load all context">
-<action>Welcome {user_name} to comprehensive epic and story creation</action>
-
-<action>**CRITICAL PREREQUISITE VALIDATION:**</action>
-
-<action>Verify required documents exist and are complete:
-
-1. **PRD.md** - Contains functional requirements (FRs) and product scope
-2. **Architecture.md** - Contains technical decisions, API contracts, data models
-3. **UX Design.md** (if UI exists) - Contains interaction patterns, mockups, user flows
-
-Missing any required document means this workflow cannot proceed successfully.</action>
-
-<check if="!prd_content">
-<output>❌ **PREREQUISITE FAILED: PRD.md not found**
-
-The PRD is required to define what functionality needs to be built.
-
-Please complete the PRD workflow first, then run this workflow again.</output>
-
-<exit workflow="Missing required PRD document"/>
-</check>
-
-<check if="!architecture_content">
-<output>❌ **PREREQUISITE FAILED: Architecture.md not found**
-
-The Architecture document is required to provide technical implementation context for stories.
-
-Please complete the Architecture workflow first, then run this workflow again.</output>
-
-<exit workflow="Missing required Architecture document"/>
-</check>
-
-<action>List the documents loaded</action>
-
-<action>**LOAD ALL CONTEXT DOCUMENTS:**</action>
-
-<action>Load and analyze PRD.md:
-
-Extract ALL functional requirements:
-
-- Complete FR inventory (FR1, FR2, FR3...)
-- Non-functional requirements and constraints
-- Project scope boundaries (MVP vs growth vs vision)
-- User types and their goals
-- Success criteria
-- Technical constraints
-- Compliance requirements
-
-**FR Inventory Creation:**
-List every functional requirement with description for coverage tracking.
-</action>
-
-<action>Load and analyze Architecture.md:
-
-Extract ALL technical implementation context relevant to the PRD functional requirements and project needs:
-
-Scan comprehensively for any technical details needed to create complete user stories, including but not limited to:
-
-- Technology stack decisions and framework choices
-- API design, contracts, and integration patterns
-- Data models, schemas, and relationships
-- Authentication, authorization, and security patterns
-- Performance requirements and scaling approaches
-- Error handling, logging, and monitoring strategies
-- Deployment architecture and infrastructure considerations
-- Any other technical decisions, patterns, or constraints that impact implementation
-
-Focus on extracting whatever technical context exists in the Architecture document that will be needed to create comprehensive, actionable user stories for all PRD requirements.
-</action>
-
-<action if="UX Design Exists">
-Load and analyze UX Design.md:
-
-Extract ALL user experience context relevant to the PRD functional requirements and project needs:
-
-Scan comprehensively for any user experience details needed to create complete user stories, including but not limited to:
-
-- User flows, journey patterns, and interaction design
-- Screen layouts, components, and visual specifications
-- Interaction patterns, behaviors, and micro-interactions
-- Responsive design and mobile-first considerations
-- Accessibility requirements and inclusive design patterns
-- Animations, transitions, and feedback mechanisms
-- Error states, validation patterns, and user guidance
-- Any other UX/UI decisions, patterns, or specifications that impact implementation
-
-Focus on extracting whatever user experience context exists in the UX document that will be needed to create comprehensive, actionable user stories for all PRD requirements.
-</action>
-
-<template-output>context_validation</template-output>
-<template-output>fr_inventory</template-output>
-</step>
-
-<step n="1" goal="Design epic structure with full technical context">
-<action>**STRATEGIC EPIC PLANNING WITH COMPLETE CONTEXT:**</action>
-
-<action>Now that you have ALL available context (PRD + Architecture + UX), design epics that deliver incremental user value while leveraging the technical design decisions.
-
-**EPIC DESIGN PRINCIPLES:**
-
-1. **User-Value First**: Each epic must enable users to accomplish something meaningful
-2. **Leverage Architecture**: Build upon the technical decisions already made
-3. **Incremental Delivery**: Each epic should be independently valuable
-4. **Logical Dependencies**: Dependencies should flow naturally, not artificially
-
-**USE YOUR FULL CONTEXT:**
-
-From PRD: Group related functional requirements that deliver user outcomes
-From Architecture: Respect technical boundaries and integration points
-From UX: Design around user journeys and interaction flows
-
-**VALID EPIC EXAMPLES:**
-
-✅ **CORRECT - User Value with Technical Context:**
-
-- Epic 1: Foundation Setup (infrastructure, deployment, core services)
-- Epic 2: User Authentication & Profile Management (register, login, profile management)
-- Epic 3: Content Creation & Management (create, edit, publish, organize content)
-- Epic 4: Content Discovery & Interaction (browse, search, share, comment)
-
-❌ **WRONG - Technical Layer Breakdown:**
-
-- Epic 1: Database Schema & Models
-- Epic 2: REST API Endpoints
-- Epic 3: Frontend Components
-- Epic 4: Authentication Service
-
-**PRESENT YOUR EPIC STRUCTURE:**
-
-For each proposed epic, provide:
-
-- **Epic Title**: Value-based, not technical
-- **User Value Statement**: What users can accomplish after this epic
-- **PRD Coverage**: Which FRs this epic addresses
-- **Technical Context**: How this leverages Architecture decisions
-- **UX Integration**: How this incorporates user experience patterns (if available)
-- **Dependencies**: What must come before (natural dependencies only)
-
-**FOUNDATION EPIC GUIDELINES:**
-
-For Epic 1, include technical foundation based on Architecture:
-
-- Project setup and build system
-- Core infrastructure and deployment pipeline
-- Database schema setup
-- Basic authentication foundation
-- API framework setup
-
-This enables all subsequent user-facing epics.
-</action>
-
-<template-output>epics_structure_plan</template-output>
-<template-output>epics_technical_context</template-output>
-</step>
-
-<step n="2" goal="Create detailed stories with complete implementation context" repeat="for-each-epic">
-<action>**EPIC {{N}} - COMPREHENSIVE STORY CREATION:**</action>
-
-<action>For Epic {{N}}: {{epic_title}}, create bite-sized stories that incorporate ALL available context.
-
-**STORY CREATION WITH FULL CONTEXT:**
-
-For each story, you now have the complete picture:
-
-- **WHAT to build** (from PRD FRs)
-- **HOW to build it** (from Architecture decisions)
-- **HOW users interact** (from UX patterns, if available)
-
-**TRANSFORM STRATEGIC REQUIREMENTS INTO TACTICAL IMPLEMENTATION:**
-
-PRD says: "Users can create accounts"
-Architecture says: "Use PostgreSQL with bcrypt hashing, JWT tokens, rate limiting"
-UX says: "Modal dialog with email/password fields, real-time validation, loading states"
-
-Your story becomes: Specific implementation details with exact acceptance criteria
-
-**STORY PATTERN FOR EACH EPIC {{N}}:**
-
-**Epic Goal:** {{epic_goal}}
-
-For each story M in Epic {{N}}:
-
-- **User Story**: As a [user type], I want [specific capability], So that [value/benefit]
-- **Acceptance Criteria**: BDD format with COMPLETE implementation details
-- **Technical Implementation**: Specific guidance from Architecture
-- **User Experience**: Exact interaction patterns from UX (if available)
-- **Prerequisites**: Only previous stories, never forward dependencies
-
-**DETAILED ACCEPTANCE CRITERIA GUIDELINES:**
-
-Include ALL implementation specifics:
-
-**From Architecture:**
-
-- Exact API endpoints and contracts
-- Database operations and validations
-- Authentication/authorization requirements
-- Error handling patterns
-- Performance requirements
-- Security considerations
-- Integration points with other systems
-
-**From UX (if available):**
-
-- Specific screen/page references
-- Interaction patterns and behaviors
-- Form validation rules and error messages
-- Responsive behavior
-- Accessibility requirements
-- Loading states and transitions
-- Success/error feedback patterns
-
-**From PRD:**
-
-- Business rules and constraints
-- User types and permissions
-- Compliance requirements
-- Success criteria
-
-**STORY SIZING PRINCIPLE:**
-
-Each story must be completable by a single dev agent in one focused session. If a story becomes too large, break it down further while maintaining user value.
-
-**EXAMPLE RICH STORY:**
-
-**Story:** User Registration with Email Verification
-
-As a new user, I want to create an account using my email address, So that I can access the platform's features.
-
-**Acceptance Criteria:**
-Given I am on the landing page
-When I click the "Sign Up" button
-Then the registration modal opens (UX Mockup 3.2)
-
-And I see email and password fields with proper labels
-And the email field validates RFC 5322 format in real-time
-And the password field shows strength meter (red→yellow→green)
-And I see "Password must be 8+ chars with 1 uppercase, 1 number, 1 special"
-
-When I submit valid registration data
-Then POST /api/v1/auth/register is called (Architecture section 4.1)
-And the user record is created in users table with bcrypt hash (Architecture 6.2)
-And a verification email is sent via SendGrid (Architecture 7.3)
-And I see "Check your email for verification link" message
-And I cannot log in until email is verified
-
-**Technical Notes:**
-
-- Use PostgreSQL users table (Architecture section 6.2)
-- Implement rate limiting: 3 attempts per hour per IP (Architecture 8.1)
-- Return JWT token on successful verification (Architecture 5.2)
-- Log registration events to audit_events table (Architecture 9.4)
-- Form validation follows UX Design patterns (UX section 4.1)
-
-**Prerequisites:** Epic 1.1 - Foundation Setup Complete
-</action>
-
-<action>**Generate all stories for Epic {{N}}**</action>
-<template-output>epic*title*{{N}}</template-output>
-<template-output>epic*goal*{{N}}</template-output>
-
-<action>For each story M in epic {{N}}, generate story content</action>
-<template-output>story*{{N}}*{{M}}</template-output>
-
-<action>**EPIC {{N}} COMPLETION REVIEW:**</action>
-
-<output>**Epic {{N}} Complete: {{epic_title}}**
-
-Stories Created: {{count}}
-
-**FR Coverage:** {{list of FRs covered by this epic}}
-
-**Technical Context Used:** {{Architecture sections referenced}}
-
-{{if ux_design_content}}
-**UX Patterns Incorporated:** {{UX sections referenced}}
-{{/if}}
-
-Ready for checkpoint validation.</output>
-
-<template-output>epic\_{{N}}\_complete</template-output>
-</step>
-
-<step n="3" goal="Final validation and coverage matrix">
-<action>**COMPREHENSIVE VALIDATION WITH FULL CONTEXT:**</action>
-
-<action>Review the complete epic and story breakdown for quality and completeness using ALL available context.
-
-**FR COVERAGE VALIDATION:**
-
-Create complete FR Coverage Matrix showing every PRD functional requirement mapped to specific stories:
-
-- **FR1:** [description] → Epic X, Story X.Y (with implementation details)
-- **FR2:** [description] → Epic Y, Story Y.A (with implementation details)
-- **FR3:** [description] → Epic Z, Story Z.B (with implementation details)
-- ...
-
-**CRITICAL VALIDATION:** Every single FR from the PRD must be covered by at least one story with complete acceptance criteria.
-
-**ARCHITECTURE INTEGRATION VALIDATION:**
-
-Verify that Architecture decisions are properly implemented:
-
-- All API endpoints from Architecture are covered in stories
-- Data models from Architecture are properly created and populated
-- Authentication/authorization patterns are consistently applied
-- Performance requirements are addressed in relevant stories
-- Security measures are implemented where required
-- Error handling follows Architecture patterns
-- Integration points between systems are properly handled
-
-**UX INTEGRATION VALIDATION** {{if ux_design_content}}:
-
-Verify that UX design patterns are properly implemented:
-
-- User flows follow the designed journey
-- Screen layouts and components match specifications
-- Interaction patterns work as designed
-- Responsive behavior matches breakpoints
-- Accessibility requirements are met
-- Error states and feedback patterns are implemented
-- Form validation follows UX guidelines
-- Loading states and transitions are implemented
-  {{/if}}
-
-**STORY QUALITY VALIDATION:**
-
-- All stories are sized for single dev agent completion
-- Acceptance criteria are specific and testable
-- Technical implementation guidance is clear
-- User experience details are incorporated
-- No forward dependencies exist
-- Epic sequence delivers incremental value
-- Foundation epic properly enables subsequent work
-
-**FINAL QUALITY CHECK:**
-
-Answer these critical questions:
-
-1. **User Value:** Does each epic deliver something users can actually do/use?
-2. **Completeness:** Are ALL PRD functional requirements covered?
-3. **Technical Soundness:** Do stories properly implement Architecture decisions?
-4. **User Experience:** {{if ux_design_content}} Do stories follow UX design patterns? {{/if}}
-5. **Implementation Ready:** Can dev agents implement these stories autonomously?
-   </action>
-
-<output>**✅ EPIC AND STORY CREATION COMPLETE**
-
-**Output Generated:** epics.md with comprehensive implementation details
-
-**Full Context Incorporated:**
-
-- ✅ PRD functional requirements and scope
-- ✅ Architecture technical decisions and contracts
-  {{if ux_design_content}}
-- ✅ UX Design interaction patterns and specifications
-  {{/if}}
-
-**FR Coverage:** {{count}} functional requirements mapped to {{story_count}} stories
-**Epic Structure:** {{epic_count}} epics delivering incremental user value
-
-**Ready for Phase 4:** Sprint Planning and Development Implementation
-</output>
-
-<template-output>final_validation</template-output>
-<template-output>fr_coverage_matrix</template-output>
-</step>
-
-</workflow>

package/src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/workflow.yaml

@@ -1,53 +0,0 @@
-# Epic and Story Decomposition Workflow
-name: create-epics-and-stories
-description: "Transform PRD requirements and Architecture decisions into comprehensive stories organized by user value. This workflow requires completed PRD + Architecture documents (UX recommended if UI exists) and breaks down requirements into implementation-ready epics and user stories that incorporate all available technical and design context. Creates detailed, actionable stories with complete acceptance criteria for development teams."
-author: "BMad"
-
-# Critical variables from config
-config_source: "{project-root}/{bmad_folder}/bmm/config.yaml"
-project_name: "{config_source}:project_name"
-output_folder: "{config_source}:output_folder"
-user_name: "{config_source}:user_name"
-communication_language: "{config_source}:communication_language"
-document_output_language: "{config_source}:document_output_language"
-user_skill_level: "{config_source}:user_skill_level"
-date: system-generated
-
-# Smart input file references - handles both whole docs and sharded docs
-# Priority: Whole document first, then sharded version
-input_file_patterns:
-  prd:
-    description: "Product Requirements Document with FRs and NFRs (required)"
-    whole: "{output_folder}/*prd*.md"
-    sharded: "{output_folder}/*prd*/index.md"
-    load_strategy: "INDEX_GUIDED"
-  architecture:
-    description: "Architecture decisions and technical design (required)"
-    whole: "{output_folder}/*architecture*.md"
-    sharded: "{output_folder}/*architecture*/index.md"
-    load_strategy: "FULL_LOAD"
-  ux_design:
-    description: "UX design specification for interaction patterns (recommended if UI exists)"
-    whole: "{output_folder}/*ux*.md"
-    sharded: "{output_folder}/*ux*/index.md"
-    load_strategy: "FULL_LOAD"
-
-# Module path and component files
-installed_path: "{project-root}/{bmad_folder}/bmm/workflows/3-solutioning/create-epics-and-stories"
-instructions: "{installed_path}/instructions.md"
-template: "{installed_path}/epics-template.md"
-
-# Output configuration
-default_output_file: "{output_folder}/epics.md"
-
-standalone: true
-
-web_bundle:
-  name: "create-epics-and-stories"
-  description: "Transform PRD requirements into bite-sized stories organized in epics for 200k context dev agents"
-  author: "BMad"
-  instructions: "{bmad_folder}/bmm/workflows/3-solutioning/create-epics-and-stories/instructions.md"
-  template: "{bmad_folder}/bmm/workflows/3-solutioning/create-epics-and-stories/epics-template.md"
-  web_bundle_files:
-    - "{bmad_folder}/bmm/workflows/3-solutioning/create-epics-and-stories/instructions.md"
-    - "{bmad_folder}/bmm/workflows/3-solutioning/create-epics-and-stories/epics-template.md"

package/src/modules/bmm/workflows/3-solutioning/implementation-readiness/checklist.md

@@ -1,169 +0,0 @@
-# Implementation Readiness Validation Checklist
-
-## Document Completeness
-
-### Core Planning Documents
-
-- [ ] PRD exists and is complete
-- [ ] PRD contains measurable success criteria
-- [ ] PRD defines clear scope boundaries and exclusions
-- [ ] Architecture document exists (architecture\*.md)
-- [ ] Technical Specification exists with implementation details
-- [ ] Epic and story breakdown document exists
-- [ ] All documents are dated and versioned
-
-### Document Quality
-
-- [ ] No placeholder sections remain in any document
-- [ ] All documents use consistent terminology
-- [ ] Technical decisions include rationale and trade-offs
-- [ ] Assumptions and risks are explicitly documented
-- [ ] Dependencies are clearly identified and documented
-
-## Alignment Verification
-
-### PRD to Architecture Alignment
-
-- [ ] Every functional requirement in PRD has architectural support documented
-- [ ] All non-functional requirements from PRD are addressed in architecture
-- [ ] Architecture doesn't introduce features beyond PRD scope
-- [ ] Performance requirements from PRD match architecture capabilities
-- [ ] Security requirements from PRD are fully addressed in architecture
-- [ ] If architecture.md: Implementation patterns are defined for consistency
-- [ ] If architecture.md: All technology choices have verified versions
-- [ ] If UX spec exists: Architecture supports UX requirements
-
-### PRD to Stories Coverage
-
-- [ ] Every PRD requirement maps to at least one story
-- [ ] All user journeys in PRD have complete story coverage
-- [ ] Story acceptance criteria align with PRD success criteria
-- [ ] Priority levels in stories match PRD feature priorities
-- [ ] No stories exist without PRD requirement traceability
-
-### Architecture to Stories Implementation
-
-- [ ] All architectural components have implementation stories
-- [ ] Infrastructure setup stories exist for each architectural layer
-- [ ] Integration points defined in architecture have corresponding stories
-- [ ] Data migration/setup stories exist if required by architecture
-- [ ] Security implementation stories cover all architecture security decisions
-
-## Story and Sequencing Quality
-
-### Story Completeness
-
-- [ ] All stories have clear acceptance criteria
-- [ ] Technical tasks are defined within relevant stories
-- [ ] Stories include error handling and edge cases
-- [ ] Each story has clear definition of done
-- [ ] Stories are appropriately sized (no epic-level stories remaining)
-
-### Sequencing and Dependencies
-
-- [ ] Stories are sequenced in logical implementation order
-- [ ] Dependencies between stories are explicitly documented
-- [ ] No circular dependencies exist
-- [ ] Prerequisite technical tasks precede dependent stories
-- [ ] Foundation/infrastructure stories come before feature stories
-
-### Greenfield Project Specifics
-
-- [ ] Initial project setup and configuration stories exist
-- [ ] If using architecture.md: First story is starter template initialization command
-- [ ] Development environment setup is documented
-- [ ] CI/CD pipeline stories are included early in sequence
-- [ ] Database/storage initialization stories are properly placed
-- [ ] Authentication/authorization stories precede protected features
-
-## Risk and Gap Assessment
-
-### Critical Gaps
-
-- [ ] No core PRD requirements lack story coverage
-- [ ] No architectural decisions lack implementation stories
-- [ ] All integration points have implementation plans
-- [ ] Error handling strategy is defined and implemented
-- [ ] Security concerns are all addressed
-
-### Technical Risks
-
-- [ ] No conflicting technical approaches between stories
-- [ ] Technology choices are consistent across all documents
-- [ ] Performance requirements are achievable with chosen architecture
-- [ ] Scalability concerns are addressed if applicable
-- [ ] Third-party dependencies are identified with fallback plans
-
-## UX and Special Concerns (if applicable)
-
-### UX Coverage
-
-- [ ] UX requirements are documented in PRD
-- [ ] UX implementation tasks exist in relevant stories
-- [ ] Accessibility requirements have story coverage
-- [ ] Responsive design requirements are addressed
-- [ ] User flow continuity is maintained across stories
-
-### Special Considerations
-
-- [ ] Compliance requirements are fully addressed
-- [ ] Internationalization needs are covered if required
-- [ ] Performance benchmarks are defined and measurable
-- [ ] Monitoring and observability stories exist
-- [ ] Documentation stories are included where needed
-
-## Overall Readiness
-
-### Ready to Proceed Criteria
-
-- [ ] All critical issues have been resolved
-- [ ] High priority concerns have mitigation plans
-- [ ] Story sequencing supports iterative delivery
-- [ ] Team has necessary skills for implementation
-- [ ] No blocking dependencies remain unresolved
-
-### Quality Indicators
-
-- [ ] Documents demonstrate thorough analysis
-- [ ] Clear traceability exists across all artifacts
-- [ ] Consistent level of detail throughout documents
-- [ ] Risks are identified with mitigation strategies
-- [ ] Success criteria are measurable and achievable
-
-## Assessment Completion
-
-### Report Quality
-
-- [ ] All findings are supported by specific examples
-- [ ] Recommendations are actionable and specific
-- [ ] Severity levels are appropriately assigned
-- [ ] Positive findings are highlighted
-- [ ] Next steps are clearly defined
-
-### Process Validation
-
-- [ ] All expected documents were reviewed
-- [ ] Cross-references were systematically checked
-- [ ] Project level considerations were applied correctly
-- [ ] Workflow status was checked and considered
-- [ ] Output folder was thoroughly searched for artifacts
-
----
-
-## Issue Log
-
-### Critical Issues Found
-
-<!-- checklist of critical issues or N/A -->
-
-### High Priority Issues Found
-
-<!-- checklist of high priority issues or N/A -->
-
-### Medium Priority Issues Found
-
-<!-- checklist of medium priority issues or N/A -->
-
----
-
-_Use this checklist to ensure comprehensive validation of implementation readiness_