bmad-github-dev-story

Automate BMAD story implementation from GitHub issues using GitHub API and BMAD workflows.

Updated May 7, 2026
One-click install
npx skills add https://github.com/m4rise/doc-classifier-app --skill bmad-github-dev-story
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-github-dev-story
Source: https://github.com/m4rise/doc-classifier-app/tree/main/.github/skills/bmad-github-dev-story
Command: npx skills add https://github.com/m4rise/doc-classifier-app --skill bmad-github-dev-story

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires github-api, bmad-workflow, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the implementation of BMAD stories from GitHub issues, streamlining the process and ensuring consistency with GitHub's operational source of truth.

Core Features & Use Cases

  • GitHub Issue Resolution: Resolves and resumes the current GitHub story's existing issue, linked PR, and branch before implementation.
  • Source of Truth: Treats GitHub as the primary source of truth for AC, DoD, DoR, active status, branch, comments, and PR linkage.
  • BMAD Context Integration: Utilizes BMAD local artifacts for product context and traceability.
  • Implementation Workflow: Provides a structured implementation workflow, including the resolution of existing work, choosing the appropriate BMAD execution flow, and ensuring completion and review.

Quick Start

Use the bmad-github-dev-story skill to implement the GitHub story issue with ID '123'.

Frequently Asked Questions about bmad-github-dev-story

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

FAQPage Schema
How do I automate GitHub issue implementation for BMAD stories?

To automate GitHub issue implementation for BMAD stories, this Skill coordinates with the GitHub API and BMAD workflow definitions to resolve existing issues, linked PRs, and branches before executing the structured implementation flow.

What is the source of truth for BMAD story implementation using GitHub issues?

GitHub serves as the primary source of truth for BMAD story implementation, providing authoritative data for acceptance criteria, definition of done, active status, branches, comments, and PR linkage, while BMAD local artifacts supply product context and traceability.

How does BMAD workflow integration handle existing GitHub PRs and branches?

BMAD workflow integration resolves and resumes existing GitHub story issues by checking linked PRs and branches prior to implementation, ensuring accurate continuation and preventing conflicts with current active work.

Do I need the GitHub API and BMAD workflow definitions to automate dev story implementation?

Yes, interacting with the GitHub API and BMAD workflow definitions is required to automate dev story implementation, as these dependencies provide the necessary operational source of truth and execution flow context.

What's the best way to ensure consistent dev story implementation across GitHub issues?

The best way to ensure consistent dev story implementation is to use an automated workflow that treats GitHub as the source of truth for status and criteria, integrating local BMAD artifacts for product context and traceability.

Can I resume an incomplete GitHub story implementation using BMAD local artifacts?

Yes, you can resume an incomplete GitHub story implementation because the Skill resolves existing work including active branches and linked PRs, combining GitHub status with BMAD local artifacts for accurate context.