diff --git a/README.md b/README.md index d51694b9..ae9826c8 100644 --- a/README.md +++ b/README.md @@ -15,13 +15,15 @@ Foundations in Agentic Agile Driven Development, known as the Breakthrough Metho ## 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. **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 @@ -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 - **[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 -- **[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 - **[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 ``` +## 🧪 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 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! diff --git a/docs/user-guide.md b/docs/user-guide.md index 68ed66fa..80f538cb 100644 --- a/docs/user-guide.md +++ b/docs/user-guide.md @@ -93,10 +93,11 @@ QA Assessments → docs/qa/assessments/ 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 graph TD A["Development Phase Start"] --> B["SM: Reviews Previous Story Dev/QA Notes"] @@ -160,6 +161,83 @@ graph TD 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 Before installing BMad Method, ensure you have: