ldy26098
/
BMAD-METHOD
mirror of https://github.com/bmad-code-org/BMAD-METHOD.git
1
0
Fork 0
Code Packages Projects Releases Wiki Activity
BMAD-METHOD/expansion-packs/tdd-methodology/README.md

3.6 KiB
Raw Blame History

BMAD-METHOD™ TDD Methodology Expansion Pack

Status TDD Integration

This expansion pack enhances the BMAD-METHOD™ with comprehensive Test-Driven Development (TDD) capabilities, enabling teams to follow strict TDD practices with AI assistance.

🚀 Production Ready

✅ EVALUATION COMPLETE: This expansion pack has been thoroughly tested and evaluated on a real project (Calculator Demo). See evaluation report for detailed findings.

Features

  • 🧪 Enhanced QA and Dev agent personas with TDD-specific responsibilities
  • 📋 TDD-aware test design tasks and templates
  • 🔄 Full Red-Green-Refactor cycle support
  • ✅ TDD quality gates and validation
  • 🚀 CI/CD integration for TDD enforcement
  • 💡 Practical examples and demos with complete working project

Components

Agent Enhancements

  • QA Agent: Enhanced for TDD Red phase and test creation
  • Dev Agent: Enhanced for TDD Green phase implementation

New Commands

  • *tdd-start: Initialize TDD workflow for a story
  • *write-failing-tests: Generate failing tests (Red phase)
  • *tdd-implement: Implement code to make tests pass (Green phase)
  • *tdd-refactor: Safe refactoring with test coverage

Quality Gates

  • Phase-specific quality criteria
  • Automated validation through CI/CD
  • TDD discipline enforcement

Templates and Tasks

  • Enhanced test design task with TDD support
  • TDD quality gates template
  • CI/CD workflow templates

Guard Scripts

  • TDD discipline validation
  • Git diff inspection
  • CI pipeline integration

Installation

  1. Copy the contents of this expansion pack to your BMAD-METHOD implementation
  2. Configure your CI/CD pipeline using the provided templates
  3. Update your agent configurations to include TDD capabilities

Usage

  1. Initialize TDD mode for a story:

    *tdd-start "Story description"

  2. Follow the Red-Green-Refactor cycle:

    • Red: *write-failing-tests
    • Green: *tdd-implement
    • Refactor: *tdd-refactor

  3. Monitor quality gates and CI/CD pipeline for TDD compliance

Examples

🧮 Calculator Demo (Complete Working Example)

See ../../examples/tdd-demo-calculator/ for a complete demonstration of the TDD workflow:

  • ✅ Full Red-Green-Refactor cycle completed
  • ✅ 21 comprehensive test cases
  • ✅ 100% test coverage achieved
  • ✅ Complete story documentation
  • ✅ Evaluation report with findings

📧 User Email Validation (Template Example)

See the examples/tdd-demo/ directory for a template demonstration using the "User Email Validation" story.

📊 Evaluation Results

Framework Rating: 9.5/10 - Production Ready ✅

  • ✅ Integration: Seamless integration with core BMAD framework
  • ✅ Documentation: Comprehensive and clear
  • ✅ Quality: 100% test coverage maintained throughout TDD cycle
  • ✅ Process: Complete Red-Green-Refactor workflow validated
  • ✅ Traceability: Excellent story progression tracking

See detailed evaluation report.

Configuration

The TDD methodology can be enabled/disabled per project or story through configuration flags. See the documentation for detailed configuration options.

Contributing

Contributions to improve the TDD methodology expansion pack are welcome. Please follow the standard BMAD-METHOD contribution guidelines.

License

This expansion pack is released under the same license as the BMAD-METHOD™.