asdf-bmad-method

BMAD Method plugin for the asdf version manager.

BMAD Method (Breakthrough Method for Agile AI Driven Development) is a battle-tested methodology and toolkit for AI-assisted software development with structured agents, roles, and workflows.

This plugin installs the bmad-method npm package and exposes its CLI executables as asdf shims. It does not scaffold BMAD project files — for project initialisation, run bmad after installation.

---

Prerequisites

Requirement	Notes
asdf	Version manager
Node.js ≥ 20	Must be on PATH before installing. Manage with asdf-nodejs.
npm	Bundled with Node.js
curl	Required for version listing and downloads

---

Plugin installation

asdf plugin add bmad-method https://github.com/panz3r/asdf-bmad-method.git

---

Usage

List available stable versions

asdf list all bmad-method

Install the latest stable version

asdf install bmad-method latest

Install a specific stable version

asdf install bmad-method 6.3.0

Install the next (pre-release) channel

next is a special alias that resolves to the npm next dist-tag at install time. It gives you the latest pre-release build without knowing its concrete version number.

asdf install bmad-method next

Set the active version

# Global default
asdf set -u bmad-method latest

# Per-project (writes .tool-versions)
asdf set bmad-method latest

Verify installation

bmad --version
bmad-method --version

---

Available shims

Command	Description
bmad	Main BMAD CLI entry point
bmad-method	Alias for the same CLI

---

Notes

• This plugin installs the bmad-method npm package into the asdf install prefix. It does not create or modify your project's BMAD configuration files.
• If you previously installed bmad-method globally via npm install -g, remove it first to avoid conflicts: npm uninstall -g bmad-method.