skills.rest
watchthelight
watchthelightCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

bmad-agent-dev

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

Updated Sep 3, 2026
Search Tags:#code review#test-driven development#sprint planning#persona#developer agent#bmad#story implementation
One-click install
npx skills add https://github.com/watchthelight/shatterfish --skill bmad-agent-dev-watchthelight
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-agent-dev
Source: https://github.com/watchthelight/shatterfish/tree/main/.claude/skills/bmad-agent-dev
Command: npx skills add https://github.com/watchthelight/shatterfish --skill bmad-agent-dev-watchthelight

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? This Skill provides a dedicated senior software engineer persona (Amelia) that executes approved stories with strict test-driven development discipline, ensuring every implementation meets its acceptance criteria with verified, passing tests. ## Core Features & Use Cases - Story Implementation: Executes approved stories following red-green-refactor TDD cycles, speaking in file paths and acceptance criterion IDs. - Customizable Persona: Loads layered configuration from customize.toml files (base, team, and user overrides) to adapt role, communication style, principles, and menu options. - Capability Menu: Dispatches to related workflows including story building, E2E test generation, code review, sprint planning, and epic retrospectives. - Use Case: A developer says "hey Amelia, let's implement the next story" and the agent loads project context, adopts the TDD-focused persona, and dispatches directly to the build workflow. ## Quick Start Ask Amelia to implement the next approved story from your sprint plan using test-first development.

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 test-driven development?▼

Invoke the developer agent and ask it to implement your approved story. It follows red-green-refactor discipline, writing failing tests first, then code to pass them, and refuses to mark tasks complete without passing tests.

How do I customize the developer agent persona?▼

Edit the customize.toml file to change the role, communication style, principles, and menu items. Team overrides go in _bmad/custom/bmad-agent-dev.toml and personal overrides in bmad-agent-dev.user.toml, merged with structural rules.

What workflows can the developer agent dispatch to?▼

The menu includes story implementation (bmad-build), E2E test generation, comprehensive code review, sprint planning, and epic retrospectives. You can dispatch by menu number, code, or a fuzzy description match.

Does the agent add story references to code comments?▼

No. Its principles explicitly forbid epic or story references as inline code comments. Comments explain why, not what, and generated code must be free of AI workflow metadata and planning references.

What happens if the customization resolver script fails?▼

The agent falls back to manually reading the three TOML files in base, team, then user order and applies the same structural merge rules itself: scalars override, tables deep-merge, and keyed arrays replace matching entries.

Related Skills

Explore More Software Engineering Skills→
FelipeMainesFelipeMaines

aiox-sm

Generate and validate Scrum user stories from PRD context.

Community
Advanced
anipatkeanipatke
1

savepoint-audit

Review completed technical epics against acceptance criteria and capture drift.

Community
Advanced
itou-daikiitou-daiki

tdd-workflow

Enforce test-driven development with failing tests, implementation, and 80% coverage verification.

Community
Advanced
unbakedcosmosunbakedcosmos

bmad-agent-dev

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

Community
Intermediate