bmad-dev-story

Implements sprint stories from spec files using a red-green-refactor workflow.

Updated May 22, 2026
One-click install
npx skills add https://github.com/Asygnuz-S-A-S/one-star --skill bmad-dev-story-asygnuz-s-a-s
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-dev-story
Source: https://github.com/Asygnuz-S-A-S/one-star/tree/main/.claude/skills/bmad-dev-story
Command: npx skills add https://github.com/Asygnuz-S-A-S/one-star --skill bmad-dev-story-asygnuz-s-a-s

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It removes the guesswork from turning a written story spec into working code by enforcing a strict, ordered implementation workflow with test-driven development, validation gates, and status tracking. ## Core Features & Use Cases - Story Discovery and Loading: Automatically finds the next ready-for-dev story from sprint-status.yaml or accepts an explicit story file path. - Red-Green-Refactor Execution: Implements each task by writing failing tests first, then minimal passing code, then refactoring, with HALT conditions for failures. - Review Continuation: Detects prior code review findings and prioritizes unresolved review follow-up tasks before regular work. - Use Case: A developer says "dev this story" and the workflow loads the story spec, implements every task with tests, updates the story file and sprint status to review, and reports a completion summary. ## Quick Start Ask the assistant to implement the next story in the sprint plan or say "dev this story" followed by the path to your story file.

Frequently Asked Questions about bmad-dev-story

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

FAQPage Schema
How do I implement the next story in my sprint plan?▼

Say "implement the next story in the sprint plan" and the workflow reads sprint-status.yaml, finds the first story marked ready-for-dev, loads its spec, and implements all tasks in order with tests.

How do I develop a specific story file?▼

Say "dev this story" followed by the full path to the story markdown file. The workflow reads the complete file, parses its tasks and acceptance criteria, and executes them sequentially.

Does it support continuing work after a code review?▼

Yes. It detects a Senior Developer Review section in the story file, counts unchecked review follow-up items, and prioritizes resolving those findings before continuing with regular tasks.

What happens if no stories are ready for development?▼

The workflow reports that no ready-for-dev stories exist and offers options: run create-story to draft a new story, run validate-create-story for a quality check, or provide a specific story file path.

When does the workflow stop or halt during implementation?▼

It halts when new dependencies beyond the story spec are needed, after three consecutive implementation failures, when required configuration is missing, or when validation gates fail at completion.