BMAD-METHOD/src/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-04-final-validation.md

5.1 KiB

name description workflow_path thisStepFile workflowFile outputFile advancedElicitationTask partyModeWorkflow epicsTemplate
step-04-final-validation Validate complete coverage of all requirements and ensure implementation readiness {project-root}/_bmad/bmm/workflows/3-solutioning/create-epics-and-stories ./step-04-final-validation.md {workflow_path}/workflow.md {planning_artifacts}/epics.md {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml {project-root}/_bmad/core/workflows/party-mode/workflow.md {workflow_path}/templates/epics-template.md

Step 4: Final Validation

STEP GOAL:

To validate complete coverage of all requirements and ensure stories are ready for development.

MANDATORY EXECUTION RULES (READ FIRST):

Universal Rules:

  • 🛑 NEVER generate content without user input
  • 📖 CRITICAL: Read the complete step file before taking any action
  • 🔄 CRITICAL: Process validation sequentially without skipping
  • 📋 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 product strategist and technical specifications writer
  • 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 validation expertise and quality assurance
  • User brings their implementation priorities and final review

Step-Specific Rules:

  • 🎯 Focus ONLY on validating complete requirements coverage
  • 🚫 FORBIDDEN to skip any validation checks
  • 💬 Validate FR coverage, story completeness, and dependencies
  • 🚪 ENSURE all stories are ready for development

EXECUTION PROTOCOLS:

  • 🎯 Validate every requirement has story coverage
  • 💾 Check story dependencies and flow
  • 📖 Verify architecture compliance
  • 🚫 FORBIDDEN to approve incomplete coverage

CONTEXT BOUNDARIES:

  • Available context: Complete epic and story breakdown from previous steps
  • Focus: Final validation of requirements coverage and story readiness
  • Limits: Validation only, no new content creation
  • Dependencies: Completed story generation from Step 3

VALIDATION PROCESS:

1. FR Coverage Validation

Review the complete epic and story breakdown to ensure EVERY FR is covered:

CRITICAL CHECK:

  • Go through each FR from the Requirements Inventory
  • Verify it appears in at least one story
  • Check that acceptance criteria fully address the FR
  • No FRs should be left uncovered

2. Architecture Implementation Validation

Check for Starter Template Setup:

  • Does Architecture document specify a starter template?
  • If YES: Epic 1 Story 1 must be "Set up initial project from starter template"
  • This includes cloning, installing dependencies, initial configuration

Database/Entity Creation Validation:

  • Are database tables/entities created ONLY when needed by stories?
  • WRONG: Epic 1 creates all tables upfront
  • RIGHT: Tables created as part of the first story that needs them
  • Each story should create/modify ONLY what it needs

3. Story Quality Validation

Each story must:

  • Be completable by a single dev agent
  • Have clear acceptance criteria
  • Reference specific FRs it implements
  • Include necessary technical details
  • Not have forward dependencies (can only depend on PREVIOUS stories)
  • Be implementable without waiting for future stories

4. Epic Structure Validation

Check that:

  • Epics deliver user value, not technical milestones
  • Dependencies flow naturally
  • Foundation stories only setup what's needed
  • No big upfront technical work

5. Dependency Validation (CRITICAL)

Epic Independence Check:

  • Does each epic deliver COMPLETE functionality for its domain?
  • Can Epic 2 function without Epic 3 being implemented?
  • Can Epic 3 function standalone using Epic 1 & 2 outputs?
  • WRONG: Epic 2 requires Epic 3 features to work
  • RIGHT: Each epic is independently valuable

Within-Epic Story Dependency Check: For each epic, review stories in order:

  • Can Story N.1 be completed without Stories N.2, N.3, etc.?
  • Can Story N.2 be completed using only Story N.1 output?
  • Can Story N.3 be completed using only Stories N.1 & N.2 outputs?
  • WRONG: "This story depends on a future story"
  • WRONG: Story references features not yet implemented
  • RIGHT: Each story builds only on previous stories

6. Complete and Save

If all validations pass:

  • Update any remaining placeholders in the document
  • Ensure proper formatting
  • Save the final epics.md

Present Final Menu: All validations complete! [C] Complete Workflow

When C is selected, the workflow is complete and the epics.md is ready for development.

Epics and Stories complete. Read fully and follow: _bmad/core/tasks/bmad-help.md with argument Create Epics and Stories.

Upon Completion of task output: offer to answer any questions about the Epics and Stories.