bmad-code-org/BMAD-METHOD
bmad-code-org/BMAD-METHOD
Activity
Last release
Open issues
Open PRs
License
release notes
release notes
release notes
Published 3 weeks ago
MinorContains breaking changesNew planning shapes lead this release. bmad-ux replaces the old single-spine UX skill with a two-spine contract: DESIGN.md (visual identity, Google Labs spec) and EXPERIENCE.md (behavior, flow, IA). bmad-spec distills any messy intent (brain dump, PRD, transcript, brief) into a tight five-field SPEC.md kernel that any downstream skill can consume. Both extend the streamlined Create/Update/Validate + Fast/Coaching template that bmad-prd and bmad-product-brief set in v6.7.0. The handoff from design into engineering is now a sealed file contract, not a translation layer.
Also shipping: Web Bundles for Gemini Gems and ChatGPT Custom GPTs (bmadcode.com/web-bundles) bring six planning bundles to non-IDE users with full IDE schema parity. bmad-automator (story automation) lands on the next channel. bmad-method-ui ships a community-alpha VS Code dashboard + standalone Next.js web UI. 19 new elicitation techniques arrive. Plus a long tail of installer and activation fixes.
bmad-create-ux-design replaced by bmad-ux. Single design.md spine is gone. New skill emits DESIGN.md (visual tokens per the Google Labs spec) and EXPERIENCE.md (behavior, flow, IA, states, a11y), with EXPERIENCE.md referencing DESIGN.md tokens via {path.to.token} syntax. Adds named-protagonist journeys, surface-closure validation, opt-in reviewer gate, and an extensible producer-handoff registry (default: Stitch). Installer auto-removes the legacy skill. PRD and brief templates aligned (form-factor probe, named-protagonist UJs, no standalone Primary Persona) (#2413)bmad-distillator retired, superseded by bmad-spec. Promoted to core because the kernel pattern is domain-agnostic. Installer cleans up automatically. No internal pipelines called it, but custom workflows must switch to bmad-spec.tools/bundle-web-bundles.js zips each bundle into dist/web-bundles/{slug}.zip for GitHub Release attachment. web-bundles/bundles.json carries persona, copy, accent color, knowledge files, and platform feature flags (web-browsing, deep-research, Stitch). Zero deps; execFileSync + strict slug regex (^[a-z0-9][a-z0-9-]*$) eliminates shell-injection surface (#2424)bmad-spec, new core skill: Distills any intent (brain dump, PRD, transcript, brief) into SPEC.md with a five-field kernel (Problem, Capabilities, Constraints, Non-goals, Success signal). Catalogs, tables, diagrams, and editorial-voice content go to named companions; absorbed inputs land in a sources: list downstream skips. Eight-rule Spec Law with lean-prose discipline. Outputs to {output_folder}/specs/spec-{slug}/, works without bmm installed. Headless callers get JSON; interactive runs close conversationally (#2417)bmad-ux, spine-based UX skill: Rewrite around DESIGN.md (visual identity, Google Labs spec) + EXPERIENCE.md (behavior, flow, IA). Six-step activation matches bmad-prd and bmad-product-brief. Fast/Coaching modes. Opt-in reviewer gate (no auto-spend on parallel reviewers for hobby work). Per-category verdicts, no misleading headline grade. Ships three DESIGN.md examples (editorial/Linen & Logic, native mobile/Quill, web SaaS/Drift), two paired EXPERIENCE.md examples, one unpaired DESIGN.md modeling the pure Stitch handoff (#2413)framing category plus additions across 7 categories (all 50 existing methods preserved). Highlights: Chain-of-Thought Scaffolding, Six Thinking Hats, Delphi Method, Inversion Analysis, Steelmanning, Morphological Analysis, Abstraction Laddering, Cascading Failure Simulation, Boundary & Edge Case Sweep (#2062)tools/validate-sidebar-order.js flags duplicates, gaps, missing fields, and translation drift across English and translated docs. Wired into docs:validate-sidebar. Locale-pattern detection prevents nested English subfolders from being silently excluded (#2409)on_complete hooks. New guardrail names prepend/append steps explicitly and requires confirmation. Applied to all BMM planning + execution skills, all persona agents (analyst, tech-writer, pm, ux-designer, architect, dev), and new skills (bmad-spec, bmad-ux) (#2398)config.toml on re-run: loadExistingConfig only read legacy _bmad/<module>/config.yaml, so user-scoped answers (user_name, communication_language) written to _bmad/config.user.toml were ignored and users got re-prompted. Adds parseCentralToml; central toml read first, legacy yaml as fallback (#2411)cloneRepo for every cached custom module, persists the real next ref, and atomically dedupes the refresh. When git fetch fails (network, deleted repo, revoked auth), the previous clone is preserved with a warning instead of being wiped (#2399)--depth 1 clones leave origin/HEAD stale, so git reset --hard origin/HEAD never pulled new commits. Now resolves the default branch via git symbolic-ref and resets against origin/<branch> explicitly, falling back to main (#2332)project_context defined in dev-story, sprint-planning, sprint-status: Skills referenced the variable without resolving it, producing unresolved expansions at activation in some configurations (#2422)_bmad/custom/ (#2414)agents.md and named-agents.md now show the IN trigger and forensic-investigation capability on Amelia's row, closing a v6.7.0 gap (#2410)docs/reference/core-tools.md (en); table-row stubs in cs/fr/vi-vn/zh-cn pending full translationrelease notes
Published 3 weeks ago
MinorContains breaking changesNew planning shapes lead this release. bmad-ux replaces the old single-spine UX skill with a two-spine contract: DESIGN.md (visual identity, Google Labs spec) and EXPERIENCE.md (behavior, flow, IA). bmad-spec distills any messy intent (brain dump, PRD, transcript, brief) into a tight five-field SPEC.md kernel that any downstream skill can consume. Both extend the streamlined Create/Update/Validate + Fast/Coaching template that bmad-prd and bmad-product-brief set in v6.7.0. The handoff from design into engineering is now a sealed file contract, not a translation layer.
Also shipping: Web Bundles for Gemini Gems and ChatGPT Custom GPTs (bmadcode.com/web-bundles) bring six planning bundles to non-IDE users with full IDE schema parity. bmad-automator (story automation) lands on the next channel. bmad-method-ui ships a community-alpha VS Code dashboard + standalone Next.js web UI. 19 new elicitation techniques arrive. Plus a long tail of installer and activation fixes.
bmad-create-ux-design replaced by bmad-ux. Single design.md spine is gone. New skill emits DESIGN.md (visual tokens per the Google Labs spec) and EXPERIENCE.md (behavior, flow, IA, states, a11y), with EXPERIENCE.md referencing DESIGN.md tokens via {path.to.token} syntax. Adds named-protagonist journeys, surface-closure validation, opt-in reviewer gate, and an extensible producer-handoff registry (default: Stitch). Installer auto-removes the legacy skill. PRD and brief templates aligned (form-factor probe, named-protagonist UJs, no standalone Primary Persona) (#2413)bmad-distillator retired, superseded by bmad-spec. Promoted to core because the kernel pattern is domain-agnostic. Installer cleans up automatically. No internal pipelines called it, but custom workflows must switch to bmad-spec.tools/bundle-web-bundles.js zips each bundle into dist/web-bundles/{slug}.zip for GitHub Release attachment. web-bundles/bundles.json carries persona, copy, accent color, knowledge files, and platform feature flags (web-browsing, deep-research, Stitch). Zero deps; execFileSync + strict slug regex (^[a-z0-9][a-z0-9-]*$) eliminates shell-injection surface (#2424)bmad-spec, new core skill: Distills any intent (brain dump, PRD, transcript, brief) into SPEC.md with a five-field kernel (Problem, Capabilities, Constraints, Non-goals, Success signal). Catalogs, tables, diagrams, and editorial-voice content go to named companions; absorbed inputs land in a sources: list downstream skips. Eight-rule Spec Law with lean-prose discipline. Outputs to {output_folder}/specs/spec-{slug}/, works without bmm installed. Headless callers get JSON; interactive runs close conversationally (#2417)bmad-ux, spine-based UX skill: Rewrite around DESIGN.md (visual identity, Google Labs spec) + EXPERIENCE.md (behavior, flow, IA). Six-step activation matches bmad-prd and bmad-product-brief. Fast/Coaching modes. Opt-in reviewer gate (no auto-spend on parallel reviewers for hobby work). Per-category verdicts, no misleading headline grade. Ships three DESIGN.md examples (editorial/Linen & Logic, native mobile/Quill, web SaaS/Drift), two paired EXPERIENCE.md examples, one unpaired DESIGN.md modeling the pure Stitch handoff (#2413)framing category plus additions across 7 categories (all 50 existing methods preserved). Highlights: Chain-of-Thought Scaffolding, Six Thinking Hats, Delphi Method, Inversion Analysis, Steelmanning, Morphological Analysis, Abstraction Laddering, Cascading Failure Simulation, Boundary & Edge Case Sweep (#2062)tools/validate-sidebar-order.js flags duplicates, gaps, missing fields, and translation drift across English and translated docs. Wired into docs:validate-sidebar. Locale-pattern detection prevents nested English subfolders from being silently excluded (#2409)on_complete hooks. New guardrail names prepend/append steps explicitly and requires confirmation. Applied to all BMM planning + execution skills, all persona agents (analyst, tech-writer, pm, ux-designer, architect, dev), and new skills (bmad-spec, bmad-ux) (#2398)config.toml on re-run: loadExistingConfig only read legacy _bmad/<module>/config.yaml, so user-scoped answers (user_name, communication_language) written to _bmad/config.user.toml were ignored and users got re-prompted. Adds parseCentralToml; central toml read first, legacy yaml as fallback (#2411)cloneRepo for every cached custom module, persists the real next ref, and atomically dedupes the refresh. When git fetch fails (network, deleted repo, revoked auth), the previous clone is preserved with a warning instead of being wiped (#2399)--depth 1 clones leave origin/HEAD stale, so git reset --hard origin/HEAD never pulled new commits. Now resolves the default branch via git symbolic-ref and resets against origin/<branch> explicitly, falling back to main (#2332)project_context defined in dev-story, sprint-planning, sprint-status: Skills referenced the variable without resolving it, producing unresolved expansions at activation in some configurations (#2422)_bmad/custom/ (#2414)agents.md and named-agents.md now show the IN trigger and forensic-investigation capability on Amelia's row, closing a v6.7.0 gap (#2410)docs/reference/core-tools.md (en); table-row stubs in cs/fr/vi-vn/zh-cn pending full translationBreakthrough Method for Agile Ai Driven Development