bmad-agent-dev

Implements approved stories with test-first discipline as a senior software engineer persona.

Updated Jun 3, 2026

Search Tags:#tdd #code review #sprint planning #persona #developer agent #bmad #story implementation

Ready to run

npx skills add https://github.com/MathematicGuy/team-006-vin20k --skill bmad-agent-dev-mathematicguy

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: bmad-agent-dev
Source: https://github.com/MathematicGuy/team-006-vin20k/tree/main/.agent/skills/bmad-agent-dev
Command: npx skills add https://github.com/MathematicGuy/team-006-vin20k --skill bmad-agent-dev-mathematicguy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It provides a disciplined senior software engineer agent that executes approved stories with test-driven development, ensuring every acceptance criterion is met with verified, passing code. ## Core Features & Use Cases - Story Implementation: Executes approved stories following red-green-refactor TDD discipline, speaking in file paths and acceptance criterion IDs. - Customizable Persona: Merges persona configuration from base, team, and user TOML files to adapt role, communication style, and principles. - Capability Menu: Dispatches to related workflows such as dev-story implementation, quick dev flow, code review, QA test generation, and sprint planning. - Use Case: A developer asks Amelia to implement the next story; the agent loads project context, adopts the TDD persona, and dispatches the bmad-dev-story skill to write tests and code. ## Quick Start Ask Amelia to implement the next approved story and she will write the tests and code following test-first discipline.

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 a story with the Amelia developer agent?▼

Invoke the agent and select the DS menu item or ask directly to implement the next story. The agent dispatches the bmad-dev-story skill, which writes tests first, then code, following red-green-refactor until all acceptance criteria pass.

How do I customize the developer agent persona?▼

Create TOML override files at _bmad/custom/bmad-agent-dev.toml for team settings or bmad-agent-dev.user.toml for personal settings. Scalars override defaults, arrays append, and menu items merge by code.

What workflows can the developer agent dispatch?▼

The menu includes dev-story implementation, quick dev flow, E2E test generation, code review, sprint planning, story creation, epic retrospective, and forensic investigation. Each item invokes a registered skill by name.

What happens if the customization resolver script fails?▼

The agent falls back to manually reading customize.toml, team overrides, and user overrides in base-to-user order, applying the same structural merge rules: scalars override, tables deep-merge, and keyed arrays replace matching entries.

Does the agent work without a BMad config file?▼

The activation flow expects _bmad/bmm/config.yaml for user name, communication language, and output locations. Without it, config-dependent steps like personalized greeting and artifact scanning cannot resolve their values.