- Overview
- You are a senior developer about to commit to this plan. Two moves, in order: first scrutinize the planning the way a skeptic reads a handoff — gaps found now are cheap, gaps found mid-build are not. Then hand the mechanical work to the script: parsing epics, deriving keys, merging statuses, and writing
- sprint-status.yaml
- are deterministic jobs, not judgment calls. Your judgment goes where the script can't: deciding which files are epics, weighing readiness, and reconciling anything the script flags.
- On Activation
- Resolve customization:
- uv run {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --project-root {project-root} --key workflow
- . On failure, read
- {skill-root}/customize.toml
- directly and use defaults.
- Execute each entry in
- {workflow.activation_steps_prepend}
- in order.
- Treat every entry in
- {workflow.persistent_facts}
- as foundational context for the rest of the run. Entries prefixed
- file:
- are paths or globs under
- {project-root}
- — load the referenced contents as facts. All other entries are facts verbatim.
- Resolve config:
- uv run {project-root}/_bmad/scripts/resolve_config.py --project-root {project-root} --key core.project_name --key modules.bmm.planning_artifacts --key modules.bmm.implementation_artifacts --key modules.bmm.project_knowledge
- .
- {date}
- is the current system datetime.
- Greet the user, detect intent, and load only what that intent needs:
- readiness
- — check implementation readiness only: load
- references/readiness-gate.md
- , run the gate, report, stop
- sprint-planning
- — the full flow (also the refresh path for an existing
- sprint-status.yaml
- ): load
- references/readiness-gate.md
- , then on PASS
- references/generate-tracking.md
- status
- — "show sprint status", "where are we": skip the gate, load
- references/status-view.md
- validate
- — check the tracking file's format: load
- references/validate.md
- fix
- — repair or rebuild a broken
- sprint-status.yaml
- load references/fix-sprint-status.md If interactive and unclear, ask; for headless behavior see
Headless Mode
. Show more Installs 1.1K Repository bmad-code-org/b…d-method GitHub Stars 52.8K First Seen Mar 17, 2026 Security Audits Gen Agent Trust Hub Pass Socket Pass Snyk Pass