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

1. Resolve customization: uv run {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --key workflow. On failure, read {skill-root}/customize.toml directly and use defaults.

2. Execute each entry in {workflow.activation_steps_prepend} in order.

3. 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.

4. Load {project-root}/_bmad/bmm/config.yaml (and config.user.yaml if present). Resolve {user_name}, {communication_language}, {document_output_language}, {project_name}, {planning_artifacts}, {implementation_artifacts}, {project_knowledge} (skip gracefully if unset), {date}. Stay in {communication_language} for every turn, not just the greeting.

5. Greet {user_name}, 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.