BMAD-METHOD/docs/how-to
Alex Verkhovsky 513f440a23
refactor(installer): restructure installer with clean separation of concerns (#2129)
* refactor(installer): restructure installer with clean separation of concerns

Move tools/cli/ to tools/installer/ with major structural cleanup:

- InstallPaths async factory for path resolution and directory creation
- Config value object (frozen) replaces mutable config bag
- ExistingInstall value object replaces stateful Detector class
- OfficialModules + CustomModules + ExternalModuleManager replace monolithic ModuleManager
- install() is prompt-free; all user interaction in ui.js
- Update state returned explicitly instead of mutating customConfig
- Delete dead code: dependency-resolver, _base-ide, IdeConfigManager,
  platform-codes helpers, npx wrapper, xml-utils
- Flatten directory structure: custom/handler → custom-handler,
  tools/cli/ → tools/installer/, lib/ directories removed
- Update all path references in package.json, tests, CI, and docs

* fix(installer): guard ExistingInstall.version and surface module.yaml errors

Guard ExistingInstall.version access with .installed check in
uninstall.js, ui.js, and installer.js to prevent throwing on
empty/partial _bmad dirs. Surface invalid module.yaml parse errors
as warnings instead of silently returning empty results.
2026-03-27 06:50:07 -06:00
..
customize-bmad.md fix(docs): community feedback — typo, locale 404s, llms-full (#2091) 2026-03-21 16:42:57 -06:00
established-projects.md refactor: consolidate agents into phase-based skill directories (#2050) 2026-03-18 01:01:33 -05:00
get-answers-about-bmad.md refactor: consolidate agents into phase-based skill directories (#2050) 2026-03-18 01:01:33 -05:00
install-bmad.md docs: mention next install channel (#1887) 2026-03-11 02:34:26 -06:00
non-interactive-installation.md refactor(installer): restructure installer with clean separation of concerns (#2129) 2026-03-27 06:50:07 -06:00
project-context.md docs: fix duplicate sidebar order number (#2071) 2026-03-20 11:38:35 -06:00
quick-fixes.md docs: rewrite quick-fixes how-to around Quick Dev workflow 2026-03-19 00:05:30 -06:00
shard-large-documents.md docs: fix duplicate sidebar order number (#2071) 2026-03-20 11:38:35 -06:00
upgrade-to-v6.md docs: update terminology from commands to skills across all documentation (#1850) 2026-03-07 16:14:25 -07:00