bmad-dev-story

Execute software development stories from specification files using test-driven development.

Updated Mar 16, 2026
One-click install
npx skills add https://github.com/geekdesign27/travailleursisoles --skill bmad-dev-story-geekdesign27
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-dev-story
Source: https://github.com/geekdesign27/travailleursisoles/tree/main/_bmad/bmm/workflows/4-implementation/bmad-dev-story
Command: npx skills add https://github.com/geekdesign27/travailleursisoles --skill bmad-dev-story-geekdesign27

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill automates the process of implementing software development stories by strictly following a provided story specification, ensuring all requirements and tasks are met.

Core Features & Use Cases

  • Automated Story Implementation: Executes development tasks based on a detailed story file.
  • Context-Driven Development: Utilizes comprehensive context from Dev Notes for accurate implementation.
  • Workflow Adherence: Follows a strict red-green-refactor cycle and validation steps.
  • Use Case: When a user says "dev this story [story file]", the AI will take the story specification, implement the tasks, write tests, and update the story status to 'review'.

Quick Start

Use the bmad-dev-story skill to implement the story found in the file at /path/to/your/story.md.

Frequently Asked Questions about bmad-dev-story

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

FAQPage Schema
How do I automate story implementation from a specification file?

Automating story implementation involves parsing a story specification file and executing tasks using context from Dev Notes. This Skill follows a strict workflow including test-driven development, validation, and status updates to complete the process.

How does automated test-driven development workflow work for agile stories?

Automated test-driven development for agile stories works by adhering to a strict red-green-refactor cycle. The workflow parses story tasks, writes tests, implements code, runs validation steps, and updates the story status to review upon completion.

What do I need to provide to implement development stories with context?

To implement development stories with context, you need to provide a detailed story specification file and access to project context or Dev Notes. Sprint status tracking may also be required for execution and updating task progress.

Can I use workflow automation to update story status to review after coding?

Yes, you can use workflow automation to update story status to review after coding. The Skill executes development tasks, writes tests, performs validation, and automatically updates the story file status to review upon finishing implementation.

What is the best way to execute tasks defined in a story specification file?

The best way to execute tasks defined in a story specification file is by utilizing context-driven development. This approach strictly follows the provided requirements, applying a red-green-refactor cycle to ensure all implementation tasks are met accurately.

When should I not use automated story implementation for development tasks?

You should not use automated story implementation when a story specification file or project context is unavailable. Execution depends on parsing detailed story files and Dev Notes to adhere to the required test-driven development workflow.