BMAD-METHOD/docs/how-to
Brian Madison 14f9b8a851 feat(installer): interactive channel switch, upgrade refusal, unified docs
Builds on the channel-resolution foundation. The installer now lets users
flip a module between stable, next, and pinned after install — either
interactively via a "Review channel assignments?" gate, or by flag. Quick
and modify re-installs classify stable upgrades; under non-interactive
flows, patches and minors apply automatically but majors are refused with
a pointer to --pin.

Fallback behavior for GitHub rate-limit / network failures is now cache-
aware: re-installs reuse the recorded ref silently; fresh installs abort
with actionable guidance (set GITHUB_TOKEN or use --next/--pin). Bundled
modules (core, bmm) warn when targeted by --pin or --next so users aren't
left wondering why the flag had no effect.

Install summary labels no longer mangle "main" into "vmain"; next-channel
entries render as "main @ <short-sha>" instead. Bundled modules are now
correctly skipped from all channel prompts and tag-API lookups.

Docs consolidated into a single how-to. install-bmad.md now covers the
interactive flow, the channel model (stable/next/pinned plus the npm
dist-tag axis for core/bmm), the re-install upgrade prompts, the full
flag reference, copy-paste recipes, and troubleshooting. The old
non-interactive-installation.md is reduced to a redirect stub.
2026-04-23 20:51:30 -05:00
..
customize-bmad.md feat(core-skills): add bmad-customize — guided authoring for _bmad/custom overrides (#2289) 2026-04-20 22:14:54 -05:00
established-projects.md feat(installer): universal source support for custom module installs (#2233) 2026-04-09 18:44:40 -05:00
expand-bmad-for-your-org.md feat(core-skills): add bmad-customize — guided authoring for _bmad/custom overrides (#2289) 2026-04-20 22:14:54 -05:00
get-answers-about-bmad.md feat(installer): universal source support for custom module installs (#2233) 2026-04-09 18:44:40 -05:00
install-bmad.md feat(installer): interactive channel switch, upgrade refusal, unified docs 2026-04-23 20:51:30 -05:00
install-custom-modules.md feat(installer): universal source support for custom module installs (#2233) 2026-04-09 18:44:40 -05:00
non-interactive-installation.md feat(installer): interactive channel switch, upgrade refusal, unified docs 2026-04-23 20:51:30 -05:00
project-context.md feat(installer): universal source support for custom module installs (#2233) 2026-04-09 18:44:40 -05:00
quick-fixes.md feat(installer): universal source support for custom module installs (#2233) 2026-04-09 18:44:40 -05:00
shard-large-documents.md feat(installer): universal source support for custom module installs (#2233) 2026-04-09 18:44:40 -05:00
upgrade-to-v6.md feat(installer): universal source support for custom module installs (#2233) 2026-04-09 18:44:40 -05:00