📚 Update documentation with Production QA integration
✨ Documentation Updates: - Updated main README.md with Production QA features and 3 key innovations - Enhanced User Guide with dual workflow diagrams (Traditional vs Production QA) - Added comprehensive Mermaid charts showing QA integration - Clarified relationship between original QA agent and new specialized QA agents - Added Production QA section highlighting enterprise features 🧪 Key Updates: - Three-phase approach: Planning + Development + Production QA - Parallel development workflow with comprehensive testing - Quality gates and automated validation - Tool-agnostic testing framework support - Enterprise-grade QA capabilities 📊 Charts Updated: - Traditional BMAD development cycle (preserved) - Enhanced Production QA development cycle (new) - Clear distinction between advisory QA and implementation QA This ensures users understand both the original BMAD workflow and the enhanced Production QA capabilities, making the transition seamless. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
parent
6263ccf111
commit
af9dd06f16
27
README.md
27
README.md
|
|
@ -15,13 +15,15 @@ Foundations in Agentic Agile Driven Development, known as the Breakthrough Metho
|
||||||
|
|
||||||
## Overview
|
## Overview
|
||||||
|
|
||||||
**BMAD-METHOD™'s Two Key Innovations:**
|
**BMAD-METHOD™'s Three Key Innovations:**
|
||||||
|
|
||||||
**1. Agentic Planning:** Dedicated agents (Analyst, PM, Architect) collaborate with you to create detailed, consistent PRDs and Architecture documents. Through advanced prompt engineering and human-in-the-loop refinement, these planning agents produce comprehensive specifications that go far beyond generic AI task generation.
|
**1. Agentic Planning:** Dedicated agents (Analyst, PM, Architect) collaborate with you to create detailed, consistent PRDs and Architecture documents. Through advanced prompt engineering and human-in-the-loop refinement, these planning agents produce comprehensive specifications that go far beyond generic AI task generation.
|
||||||
|
|
||||||
**2. Context-Engineered Development:** The Scrum Master agent then transforms these detailed plans into hyper-detailed development stories that contain everything the Dev agent needs - full context, implementation details, and architectural guidance embedded directly in story files.
|
**2. Context-Engineered Development:** The Scrum Master agent then transforms these detailed plans into hyper-detailed development stories that contain everything the Dev agent needs - full context, implementation details, and architectural guidance embedded directly in story files.
|
||||||
|
|
||||||
This two-phase approach eliminates both **planning inconsistency** and **context loss** - the biggest problems in AI-assisted development. Your Dev agent opens a story file with complete understanding of what to build, how to build it, and why.
|
**3. Production-Ready QA Integration:** Specialized QA agents create comprehensive test suites in parallel with development, implementing automated quality gates, performance validation, security scanning, and accessibility testing - ensuring enterprise-grade quality without slowing development velocity.
|
||||||
|
|
||||||
|
This three-phase approach eliminates **planning inconsistency**, **context loss**, and **quality gaps** - the biggest problems in AI-assisted development. Your Dev agent opens a story file with complete understanding of what to build, how to build it, and why, while QA agents ensure production readiness.
|
||||||
|
|
||||||
**📖 [See the complete workflow in the User Guide](docs/user-guide.md)** - Planning phase, development cycle, and all agent roles
|
**📖 [See the complete workflow in the User Guide](docs/user-guide.md)** - Planning phase, development cycle, and all agent roles
|
||||||
|
|
||||||
|
|
@ -43,7 +45,7 @@ This two-phase approach eliminates both **planning inconsistency** and **context
|
||||||
- **[See available AI agents](/bmad-core/agents)** → Specialized roles for your team
|
- **[See available AI agents](/bmad-core/agents)** → Specialized roles for your team
|
||||||
- **[Explore non-technical uses](#-beyond-software-development---expansion-packs)** → Creative writing, business, wellness, education
|
- **[Explore non-technical uses](#-beyond-software-development---expansion-packs)** → Creative writing, business, wellness, education
|
||||||
- **[Create my own AI agents](docs/expansion-packs.md)** → Build agents for your domain
|
- **[Create my own AI agents](docs/expansion-packs.md)** → Build agents for your domain
|
||||||
- **[Browse ready-made expansion packs](expansion-packs/)** → Game dev, DevOps, infrastructure and get inspired with ideas and examples
|
- **[Browse ready-made expansion packs](expansion-packs/)** → Game dev, DevOps, infrastructure, **Production QA**, and get inspired with ideas and examples
|
||||||
- **[Understand the architecture](docs/core-architecture.md)** → Technical deep dive
|
- **[Understand the architecture](docs/core-architecture.md)** → Technical deep dive
|
||||||
- **[Join the community](https://discord.gg/gk8jAdXWmj)** → Get help and share ideas
|
- **[Join the community](https://discord.gg/gk8jAdXWmj)** → Get help and share ideas
|
||||||
|
|
||||||
|
|
@ -106,6 +108,25 @@ git clone https://github.com/bmadcode/bmad-method.git
|
||||||
npm run install:bmad # build and install all to a destination folder
|
npm run install:bmad # build and install all to a destination folder
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## 🧪 Production QA & Testing (NEW!)
|
||||||
|
|
||||||
|
**Enterprise-grade QA integration with comprehensive testing automation:**
|
||||||
|
|
||||||
|
### Specialized QA Agents
|
||||||
|
- **QA Test Engineer** - E2E, API, integration testing specialist
|
||||||
|
- **Performance Engineer** - Load, stress, capacity testing expert
|
||||||
|
- **Security Engineer** - Vulnerability scanning, OWASP compliance
|
||||||
|
- **QA Test Lead** - Strategic coordination and quality oversight
|
||||||
|
|
||||||
|
### Quality Features
|
||||||
|
- ✅ **Automated Quality Gates** - 80%+ coverage, security clean, performance validated
|
||||||
|
- ✅ **Tool-Agnostic Testing** - Supports Playwright, Cypress, k6, OWASP ZAP, and more
|
||||||
|
- ✅ **Parallel Development** - QA creates tests while Dev implements features
|
||||||
|
- ✅ **CI/CD Integration** - Automated testing pipelines with GitHub Actions
|
||||||
|
- ✅ **Comprehensive Coverage** - E2E, API, Performance, Security, Visual, Accessibility
|
||||||
|
|
||||||
|
**[📖 See Production QA Guide](expansion-packs/bmad-production-qa/README.md)**
|
||||||
|
|
||||||
## 🌟 Beyond Software Development - Expansion Packs
|
## 🌟 Beyond Software Development - Expansion Packs
|
||||||
|
|
||||||
BMAD™'s natural language framework works in ANY domain. Expansion packs provide specialized AI agents for creative writing, business strategy, health & wellness, education, and more. Also expansion packs can expand the core BMAD-METHOD™ with specific functionality that is not generic for all cases. [See the Expansion Packs Guide](docs/expansion-packs.md) and learn to create your own!
|
BMAD™'s natural language framework works in ANY domain. Expansion packs provide specialized AI agents for creative writing, business strategy, health & wellness, education, and more. Also expansion packs can expand the core BMAD-METHOD™ with specific functionality that is not generic for all cases. [See the Expansion Packs Guide](docs/expansion-packs.md) and learn to create your own!
|
||||||
|
|
|
||||||
|
|
@ -93,10 +93,11 @@ QA Assessments → docs/qa/assessments/
|
||||||
QA Gates → docs/qa/gates/
|
QA Gates → docs/qa/gates/
|
||||||
```
|
```
|
||||||
|
|
||||||
### The Core Development Cycle (IDE)
|
### The Core Development Cycle (IDE) - Enhanced with Production QA
|
||||||
|
|
||||||
Once planning is complete and documents are sharded, BMad follows a structured development workflow:
|
Once planning is complete and documents are sharded, BMad follows a structured development workflow with integrated QA automation:
|
||||||
|
|
||||||
|
#### Traditional BMad Core Development Cycle
|
||||||
```mermaid
|
```mermaid
|
||||||
graph TD
|
graph TD
|
||||||
A["Development Phase Start"] --> B["SM: Reviews Previous Story Dev/QA Notes"]
|
A["Development Phase Start"] --> B["SM: Reviews Previous Story Dev/QA Notes"]
|
||||||
|
|
@ -160,6 +161,83 @@ graph TD
|
||||||
style Z fill:#ffd54f,color:#000
|
style Z fill:#ffd54f,color:#000
|
||||||
```
|
```
|
||||||
|
|
||||||
|
#### Enhanced Production QA Development Cycle (bmad-production-qa)
|
||||||
|
```mermaid
|
||||||
|
graph TD
|
||||||
|
A[Planning Complete] --> B[qa-test-lead: Create Test Strategy]
|
||||||
|
B --> C[qa-test-lead: Setup Testing Infrastructure]
|
||||||
|
C --> D[sm: Create Story with QA Requirements]
|
||||||
|
D --> E{QA Review Needed?}
|
||||||
|
E -->|Yes| F[qa-test-engineer: Validate Test Requirements]
|
||||||
|
E -->|No| G{PO Approval?}
|
||||||
|
F --> G
|
||||||
|
G -->|Yes| H[po: Approve Story]
|
||||||
|
G -->|No| I[Begin Parallel Development]
|
||||||
|
H --> I
|
||||||
|
|
||||||
|
I --> J[dev: Implement Story]
|
||||||
|
I --> K[qa-test-engineer: Create Test Suites]
|
||||||
|
|
||||||
|
J --> L{Dev Complete?}
|
||||||
|
K --> M{Tests Ready?}
|
||||||
|
L -->|Yes| N[qa-test-engineer: Execute Test Suites]
|
||||||
|
M -->|Yes| N
|
||||||
|
|
||||||
|
N --> O[Evaluate Quality Gates]
|
||||||
|
O --> P{Quality Gate Decision}
|
||||||
|
|
||||||
|
P -->|PASS| Q[Production Ready]
|
||||||
|
P -->|FAIL| R[dev: Fix Issues]
|
||||||
|
P -->|CONDITIONAL| S{Security Check Needed?}
|
||||||
|
|
||||||
|
R --> N
|
||||||
|
|
||||||
|
S -->|Yes| T[qa-security-engineer: Security Validation]
|
||||||
|
S -->|No| U{Performance Check?}
|
||||||
|
T --> U
|
||||||
|
U -->|Yes| V[qa-performance-engineer: Performance Validation]
|
||||||
|
U -->|No| Q
|
||||||
|
V --> Q
|
||||||
|
|
||||||
|
Q --> W{More Stories?}
|
||||||
|
W -->|Yes| D
|
||||||
|
W -->|No| X[qa-test-lead: Epic Quality Report]
|
||||||
|
X --> Y[Epic Complete - Production Ready]
|
||||||
|
|
||||||
|
style A fill:#e3f2fd
|
||||||
|
style B fill:#fff3e0
|
||||||
|
style C fill:#fff3e0
|
||||||
|
style D fill:#e8f5e9
|
||||||
|
style I fill:#f3e5f5
|
||||||
|
style J fill:#e3f2fd
|
||||||
|
style K fill:#ffd54f
|
||||||
|
style N fill:#ffd54f
|
||||||
|
style O fill:#f9ab00
|
||||||
|
style Q fill:#34a853,color:#fff
|
||||||
|
style R fill:#f44336,color:#fff
|
||||||
|
style Y fill:#34a853,color:#fff
|
||||||
|
```
|
||||||
|
|
||||||
|
### QA Agent Evolution: Traditional vs Production QA
|
||||||
|
|
||||||
|
**Traditional BMAD QA Agent (Quinn):**
|
||||||
|
- Test Architect & Quality Advisor
|
||||||
|
- Strategic guidance and quality gates
|
||||||
|
- Requirements tracing and risk assessment
|
||||||
|
- Advisory role with high-level recommendations
|
||||||
|
|
||||||
|
**Production QA Expansion Pack:**
|
||||||
|
- **QA Test Engineer** - Hands-on test automation and implementation
|
||||||
|
- **Performance Engineer** - Specialized load and stress testing
|
||||||
|
- **Security Engineer** - Comprehensive security scanning and compliance
|
||||||
|
- **QA Test Lead** - Strategic coordination across all QA activities
|
||||||
|
|
||||||
|
**Working Together:**
|
||||||
|
Both approaches can coexist. The traditional QA agent provides strategic oversight while the Production QA agents handle implementation. Choose the approach that fits your project:
|
||||||
|
- **Traditional QA**: Use Quinn for advisory guidance and manual quality reviews
|
||||||
|
- **Production QA**: Use specialized agents for automated testing and comprehensive quality gates
|
||||||
|
- **Hybrid**: Use both - Quinn for strategy and specialized agents for implementation
|
||||||
|
|
||||||
## Prerequisites
|
## Prerequisites
|
||||||
|
|
||||||
Before installing BMad Method, ensure you have:
|
Before installing BMad Method, ensure you have:
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue