bmad-agent-dev

Execute approved story tasks in strict sequence with passing unit tests.

2|Updated Apr 2, 2026
One-click install
npx skills add https://github.com/cassioalexandre/agf --skill bmad-agent-dev-cassioalexandre
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-agent-dev
Source: https://github.com/cassioalexandre/agf/tree/main/_bmad/bmm/4-implementation/bmad-agent-dev
Command: npx skills add https://github.com/cassioalexandre/agf --skill bmad-agent-dev-cassioalexandre

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the need for reliable, test-driven software implementation that follows an approved story’s exact sequence and acceptance criteria.

Core Features & Use Cases

  • Story execution in strict order: Executes tasks/subtasks exactly as written in the story, without reordering or skipping.
  • Test-first completion gates: Requires implementation plus comprehensive tests, with the full test suite passing before marking items complete.
  • Citable, auditable development: Records decisions, added tests, and updated file lists back into the story file for traceability.

Use case: When a user requests that Amelia (the developer agent) implement a story, the skill carries out each subtask in order, runs tests after each step, and keeps the story record updated with what changed and why.

Quick Start

Ask the agent to implement the approved story and say to invoke the bmad-agent-dev capability when discussing work with Amelia.

Frequently Asked Questions about bmad-agent-dev

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

FAQPage Schema
How do I implement user stories with strict test-driven development?

Story implementation with strict test-driven development executes approved tasks in exact sequence, requiring comprehensive unit test coverage and a fully passing test suite before marking any item complete. It updates the story file with an auditable record of decisions and changed files for traceability.

What is agentic governance in software development workflows?

Agentic governance in software development workflows ensures an agent executes tasks exactly as written in a story file without reordering or skipping. It gates each task completion on real test execution outcomes and records an auditable Dev Agent Record back into the story for traceability.

Does test-first completion gating require the full test suite to pass?

Yes, test-first completion gating requires the full test suite to pass before marking items complete. The implementation process demands comprehensive unit tests run after each subtask, ensuring verifiable passing test results gate every step of story execution.

How do I maintain an auditable file list during code implementation?

Maintaining an auditable file list during code implementation requires the agent to record decisions, added tests, and updated file lists directly back into the story file. This creates traceable development records tied to acceptance criteria.

Can I use this for story execution if my project context is missing?

Story execution can still proceed if project context is missing, but it loads bmad initialization config and project context when available to inform the process. The agent strictly gates task completion on real test execution outcomes regardless of context.

When should I not use automated story execution for code review?

You should not use automated story execution when tasks and acceptance criteria are not provided via an approved story file. The process relies on strict sequence execution and real test outcomes, making it unsuitable for unstructured development without predefined test gates.