Module Setup

Overview

Installs, configures, and upgrades the bmad-loop module in a project.

This module is unusual: alongside its automation skills it relies on the bmad-loop orchestrator tool — the Python program that actually drives the loop — installed as the bmad-loop package from its public Git repository. The skills do nothing on their own.

The BMAD installer owns _bmad/ registration; this skill does not. When bmad-loop is installed through the BMAD installer (npx bmad-method install), the installer stages the skills under _bmad/bmad-loop/, writes that module's own config and help files, records it in _bmad/_config/ (manifest, skill manifest, files manifest), and rebuilds the /bmad-help catalog. It regenerates the central _bmad/config.toml on every run, so nothing outside the installer should write there.

So this skill's job is the part the installer structurally cannot do:

1. Install or upgrade the orchestrator tool (the installer copies skill directories only — it cannot carry a Python package).
2. Run bmad-loop init to register the per-CLI hooks, lay down the bundled skills, and write .bmad-loop/policy.toml + gitignore entries.
3. Preflight with bmad-loop validate and point the user at per-role adapter config.

It also refreshes one file — _bmad/bmad-loop/module-help.csv — so the module's help entries are present even on a project that installed the tool directly rather than through the BMAD installer. Nothing else under _bmad/ is written or deleted.

Module identity (name, code, version) comes from ./assets/module.yaml.