@moxxy/mode-bmad implements the BMAD method (Breakthrough Method for Agile AI-Driven Development). A single user request flows through four sequential phases, each owned by a different persona, with the artifact from each phase becoming the input for the next.

Phases

1. Analysis — Analyst → one-page PRD-style brief.
2. Planning — Product Manager → numbered stories with acceptance criteria.
3. Solutioning — Architect → short design + change list.
4. Implementation — Developer → tool-use sub-loop per story.

Between phases, an optional approval gate lets the user approve / redraft / cancel. Without a resolver (headless / non-TTY) the loop proceeds end to end.

Inspired by bmad-code-org/BMAD-METHOD.

Install

pnpm add @moxxy/mode-bmad

Use

import { bmadModePlugin } from '@moxxy/mode-bmad';

session.pluginHost.registerStatic(bmadModePlugin);
session.modes.setActive('bmad');

Switch interactively with /mode bmad.

Exports

• bmadMode, bmadModePlugin
• BMAD_MODE_NAME — 'bmad'
• parseStories(text) — story parser used by the planning phase.

When to pick bmad

Pick bmad when plan-execute under-specifies — multi-stakeholder requests where UX, API design, data model, and implementation all need distinct treatment. For everything else, tool-use is faster.

See also

• Modes guide — comparison + switching.
• Sub-agents — dispatch_agent({ mode: 'bmad' }).