mirror of
https://github.com/bmad-code-org/BMAD-METHOD.git
synced 2026-01-30 04:32:02 +00:00
* docs: radical reduction of documentation scope for v6 beta Archive and basement unreviewed content to ship a focused, minimal doc set. Changes: - Archive stale how-to workflow guides (will rewrite for v6) - Archive outdated explanation and reference content - Move unreviewed content to basement for later review - Reorganize TEA docs into dedicated /tea/ section - Add workflow-map visual reference page - Simplify getting-started tutorial and sidebar navigation - Add explanation pages: brainstorming, adversarial-review, party-mode, quick-flow, advanced-elicitation - Fix base URL handling for subdirectory deployments (GitHub Pages forks) The goal is a minimal, accurate doc set for beta rather than comprehensive but potentially misleading content. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> * refactor: restructure BMM and agents documentation by consolidating and flattening index files. --------- Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
3.4 KiB
3.4 KiB
title, description
| title | description |
|---|---|
| How to Run Implementation Readiness | How to validate planning and solutioning before implementation |
Use the implementation-readiness workflow to validate that planning and solutioning are complete and aligned before Phase 4 implementation.
When to Use This
- Always before Phase 4 for BMad Method and Enterprise projects
- After create-epics-and-stories workflow completes
- Before sprint-planning workflow
- When stakeholders request readiness check
When to Skip This
- Quick Flow (no solutioning phase)
- BMad Method Simple (no gate check required)
:::note[Prerequisites]
- BMad Method installed
- Architect agent available
- PRD, Architecture, and Epics completed :::
Steps
1. Load the Architect Agent
Start a fresh chat and load the Architect agent.
2. Run the Workflow
*implementation-readiness
3. Let the Agent Validate
The workflow systematically checks:
- PRD completeness
- Architecture completeness
- Epic/Story completeness
- Alignment between all documents
4. Review the Gate Decision
The agent produces a gate decision with rationale.
Gate Decision Outcomes
| Decision | Meaning | Action |
|---|---|---|
| PASS | All critical criteria met, minor gaps acceptable | Proceed to Phase 4 |
| CONCERNS | Some criteria not met but not blockers | Proceed with caution, address gaps in parallel |
| FAIL | Critical gaps or contradictions | BLOCK Phase 4, resolve issues first |
What Gets Checked
PRD/GDD Completeness:
- Problem statement clear and evidence-based
- Success metrics defined
- User personas identified
- FRs and NFRs complete
- Risks and assumptions documented
Architecture Completeness:
- System, data, API architecture defined
- Key ADRs documented
- Security architecture addressed
- FR/NFR-specific guidance provided
- Standards and conventions defined
Epic/Story Completeness:
- All PRD features mapped to stories
- Stories have acceptance criteria
- Stories prioritized (P0/P1/P2/P3)
- Dependencies identified
Alignment Checks:
- Architecture addresses all PRD FRs/NFRs
- Epics align with architecture decisions
- No contradictions between epics
- Integration points clear
What You Get
An implementation-readiness.md document containing:
- Executive Summary (PASS/CONCERNS/FAIL)
- Completeness Assessment (scores for PRD, Architecture, Epics)
- Alignment Assessment (PRD↔Architecture, Architecture↔Epics)
- Quality Assessment (story quality, dependencies, risks)
- Gaps and Recommendations (critical/minor gaps, remediation)
- Gate Decision with rationale
- Next Steps
Example
E-commerce platform → CONCERNS
Gaps identified:
- Missing security architecture section
- Undefined payment gateway
Recommendation:
- Complete security section
- Add payment gateway ADR
Action: Proceed with caution, address before payment epic.
Tips
- Run before every Phase 4 start — It's a valuable checkpoint
- Take FAIL decisions seriously — Fix issues first
- Use CONCERNS as a checklist — Track parallel work
- Document why you proceed despite concerns — Transparency matters
Next Steps
After implementation readiness:
- If PASS — Run sprint-planning to start Phase 4
- If CONCERNS — Proceed with documented gaps to address
- If FAIL — Return to relevant workflow to fix issues