bmad-dev

Implement approved user stories using Test-Driven Development and Red-Green-Refactor cycles.

2|Updated Apr 21, 2025
One-click install
npx skills add https://github.com/akvo/akvo-rag --skill bmad-dev-akvo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-dev
Source: https://github.com/akvo/akvo-rag/tree/main/.agent/skills/bmad-dev
Command: npx skills add https://github.com/akvo/akvo-rag --skill bmad-dev-akvo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and scripts (resource) components.

What problem does it solve?

This Skill automates the implementation of approved user stories using Test-Driven Development (TDD), ensuring code quality and adherence to specifications.

Core Features & Use Cases

  • Story-Driven Implementation: Follows a strict Red-Green-Refactor cycle based on user story acceptance criteria.
  • Code Quality Enforcement: Ensures all code is tested, follows conventions, and adheres to security and accessibility best practices.
  • Use Case: A product manager provides a user story for a new feature. The developer (Amelia) loads the story, writes failing tests based on acceptance criteria, writes minimal code to pass, refactors, and ensures the feature is fully implemented and tested before handing off.

Quick Start

Use the bmad-dev skill to implement the approved user story.

Frequently Asked Questions about bmad-dev

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I implement user stories using Test-Driven Development?

Yes, you can automate user story implementation with TDD by following a strict Red-Green-Refactor cycle. The process enforces code quality standards by writing failing tests for acceptance criteria, creating minimal passing code, and refactoring within specified technology stacks.

Does TDD implementation work with FastAPI and Next.js stacks?

TDD implementation supports FastAPI, Next.js, and Laravel technology stacks. It requires stack-specific Docker execution for all development tasks to maintain consistent environments while enforcing code quality standards and adherence to acceptance criteria.

What is the Red-Green-Refactor methodology for story-driven development?

The Red-Green-Refactor methodology is a TDD cycle where you write failing tests based on user story acceptance criteria, write minimal code to pass those tests, and then refactor. It ensures disciplined development cycles and strict adherence to specifications.

How do I enforce code quality standards during feature implementation?

You enforce code quality standards during feature implementation by using TDD to ensure all code is tested and follows conventions. This approach guarantees adherence to security and accessibility best practices while meeting user story acceptance criteria.

What are the limitations of automated user story implementation?

Limitations of automated user story implementation include the strict requirement for approved user stories and predefined acceptance criteria before starting. It also mandates stack-specific Docker execution, limiting use to supported technology stacks like FastAPI, Next.js, or Laravel.