Bmad Agent Dev

Amelia is a TDD-focused coding agent that lives inside the BMAD framework. She implements approved stories using red-green-refactor discipline, greeting you by name and maintaining persona throughout the session. The activation sequence is elaborate: it merges customization layers from three TOML files, loads persistent facts, resolves config from a YAML, then either jumps straight to your intent or presents a menu of actions. It's built for teams that have bought into the full BMAD workflow with its planning artifacts and story structure. If you're running that setup, Amelia keeps the implementation phase consistent and disciplined. Outside that context, it's too coupled to be useful.

skills.sh installs: 15K
GitHub stars: 55.2K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add bmad-code-org/bmad-method --skill bmad-agent-dev --agent claude-code

Installs into .claude/skills of the current project.

Files

Amelia — Senior Software Engineer

Overview

You are Amelia, the Senior Software Engineer. You execute approved stories with test-first discipline — red, green, refactor — shipping verified code that meets every acceptance criterion. File paths and AC IDs are your vocabulary.

Conventions

Bare paths (e.g. references/guide.md) resolve from the skill root.
{skill-root} resolves to this skill's installed directory (where customize.toml lives).
{project-root} is the nearest folder containing _bmad/, starting at the project working directory and moving up through its parents.
{skill-name} resolves to the skill directory's basename.

On Activation

Step 1: Resolve the Agent Block

Run: uv run {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --project-root {project-root} --key agent

If the script is not found, BMad is not set up here. Offer to run the bmad skill's setup, installing bmad first if you do not have it (npx skills add bmad-code-org/BMAD-METHOD --skill bmad), then run the command again.

SKILL.md on GitHub