One-click install
npx skills add https://github.com/thuantan2060/facebook-sale-tracking --skill bmad-dev-story-thuantan2060
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-dev-story
Source: https://github.com/thuantan2060/facebook-sale-tracking/tree/main/.agents/skills/bmad-dev-story
Command: npx skills add https://github.com/thuantan2060/facebook-sale-tracking --skill bmad-dev-story-thuantan2060

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It turns a structured “story spec” into a fully implemented, tested, and documentation-updated development change without skipping required steps.

Core Features & Use Cases

  • Story-driven implementation: Locates the next ready-for-dev story (or uses a user-specified story path) and follows the story’s Tasks/Subtasks sequence exactly.
  • Test-first red-green-refactor: Writes failing tests first, implements minimal code to pass, then refactors while keeping tests green.
  • DoD-ready completion tracking: Updates only the permitted story sections (Tasks/Subtasks, Dev Agent Record, File List, Change Log, Status) and ensures regression checks and definition-of-done gates are satisfied before marking for review.
  • Sprints and review continuation: Uses sprint-status.yaml ordering when available and resumes after “Senior Developer Review (AI)” by prioritizing unresolved [AI-Review] follow-ups.

Quick Start

Run the bmad-dev-story skill with your story file spec so it can implement the story end-to-end, update the story sections only as allowed, and mark it as ready for review.

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 a story spec using test-driven development from start to finish?

Story implementation follows a deterministic red-green-refactor sequence, writing failing tests first, adding minimal code to pass, then refactoring. It updates permitted story sections and transitions the status to review only after test and quality gates pass.

What is the red-green-refactor workflow for sprint-based story implementation?

Red-green-refactor is a test-first workflow that writes failing tests, implements minimal code to pass them, then refactors while keeping tests green. It drives task completion by following the story's Tasks/Subtasks sequence exactly with strict modification boundaries.

Can I resume story implementation after an AI code review and resolve follow-ups?

Yes, story implementation resumes after a Senior Developer Review by prioritizing unresolved AI-Review follow-ups. It loads the specified story file, addresses the review items, runs regression checks, and updates the Dev Agent Record before marking the story for review.

How do I track definition of done and update documentation during story implementation?

Definition of done is tracked by satisfying regression checks and quality gates before marking a story for review. Documentation updates are limited to approved story sections only, including Tasks/Subtasks, File List, Change Log, and Status.

Does story implementation work with sprint-status.yaml for ordering the next ready-for-dev story?

Yes, story implementation uses sprint-status.yaml ordering when available to locate the next ready-for-dev story. Alternatively, you can specify a direct story file path to load and implement end-to-end.

What are the modification boundaries when implementing a story spec?

Modification boundaries restrict updates to approved story sections only: Tasks/Subtasks, Dev Agent Record, File List, Change Log, and Status. This strict scope prevents unintended changes and ensures the implementation satisfies the definition of done before transitioning to review.