mcpField
B
bmad-agent-po

bmad-agent-po

github.com/bmad-code-orgDevelopment54.7k2.4k installsUpdated 1w ago
Repository

About bmad-agent-po

bmad-agent-po renders a skill workflow from a BMad project and directs an agent to follow the generated instructions. It is for agents operating in projects that contain `_bmad/`, with explicit stop conditions for missing setup or command failures.

Key features

  1. 01Render workflow instructions
  2. 02Locate the project root from `_bmad/`
  3. 03Stop on halt output or errors
  4. 04Offer BMad setup when absent

Use cases

  1. 01Load the workflow for a BMad project
  2. 02Handle projects without the BMad setup
  3. 03Report renderer or `uv` failures

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/bmad-code-org/bmad-method --skill bmad-agent-po

After installing, type/bmad-agent-poin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

bmod.toml
customize.toml
workflow.md
assets/
bug-template.md
spike-template.md
ticket-template.md
tickets-template.toml
config/
github-ticketing.toml
jira-ticketing.toml
linear-ticketing.toml
notion-ticketing.toml
repo-ticketing.toml
trello-ticketing.toml
references/
board.md
replan.md
slice.md
spec.md
store-setup.md
ticket.md
validate-checks.md
validate.md
scripts/
read_store.py
tickets.py
scripts/tests/
test_read_store.py
test_tickets.py

Details

From the project README

Run the following command exactly once without changing the current working directory.

Replace {project-root} with the nearest folder containing _bmad/, from the working directory upward. Replace {skill-root} with the absolute path to this skill's directory.

uv run --no-cache "{project-root}/_bmad/scripts/render_skill.py" --project-root "{project-root}" --skill "{skill-root}"
  • The command prints the skill's workflow: follow it. HALT: <reason>: report the reason and stop.
  • If the script does not exist, BMad is not set up in this project yet. Offer to set it up using bmad skill, then run the command again. If you do not have the bmad skill, offer to install it first.
  • On any other output or failure, including uv being unavailable, report the command output and stop. Do not run any workflow source directly.

Comments

Markdown supported