diff --git a/src/modules/bmm/workflows/4-implementation/sprint-status/instructions.md b/src/modules/bmm/workflows/4-implementation/sprint-status/instructions.md
index c31f0bea..dc5241c7 100644
--- a/src/modules/bmm/workflows/4-implementation/sprint-status/instructions.md
+++ b/src/modules/bmm/workflows/4-implementation/sprint-status/instructions.md
@@ -40,15 +40,50 @@ Run `/bmad:bmm:workflows:sprint-planning` to generate it, then rerun sprint-stat
- Epics: keys starting with "epic-" (and not ending with "-retrospective")
- Retrospectives: keys ending with "-retrospective"
- Stories: everything else (e.g., 1-2-login-form)
- If any story has status `drafted`, treat as `ready-for-dev` (legacy status)
+ Map legacy story status "drafted" → "ready-for-dev"
Count story statuses: backlog, ready-for-dev, in-progress, review, done
- Count epic statuses: backlog, contexted
- Detect risks:
- - Stories in review but no reviewer assigned context → suggest `/bmad:bmm:workflows:code-review`
- - Stories in in-progress with no ready-for-dev items behind them → keep focus on the active story
- - All epics backlog/contexted but no stories ready-for-dev → prompt to run `/bmad:bmm:workflows:create-story`
- - Stories in ready-for-dev may be unvalidated → suggest `/bmad:bmm:workflows:validate-create-story` before `dev-story` for quality check
-
+ Map legacy epic status "contexted" → "in-progress"
+ Count epic statuses: backlog, in-progress, done
+ Count retrospective statuses: optional, completed
+
+Validate all statuses against known values:
+
+- Valid story statuses: backlog, ready-for-dev, in-progress, review, done, drafted (legacy)
+- Valid epic statuses: backlog, in-progress, done, contexted (legacy)
+- Valid retrospective statuses: optional, completed
+
+
+
+ How should these be corrected?
+ {{#each invalid_entries}}
+ {{@index}}. {{key}}: "{{status}}" → [select valid status]
+ {{/each}}
+
+Enter corrections (e.g., "1=in-progress, 2=backlog") or "skip" to continue without fixing:
+
+Update sprint-status.yaml with corrected values
+Re-parse the file with corrected statuses
+
+
+
+Detect risks:
+
+- IF any story has status "review": suggest `/bmad:bmm:workflows:code-review`
+- IF any story has status "in-progress" AND no stories have status "ready-for-dev": recommend staying focused on active story
+- IF all epics have status "backlog" AND no stories have status "ready-for-dev": prompt `/bmad:bmm:workflows:create-story`
+
Pick the next recommended workflow using priority:
@@ -71,7 +106,7 @@ Run `/bmad:bmm:workflows:sprint-planning` to generate it, then rerun sprint-stat
**Stories:** backlog {{count_backlog}}, ready-for-dev {{count_ready}}, in-progress {{count_in_progress}}, review {{count_review}}, done {{count_done}}
-**Epics:** backlog {{epic_backlog}}, contexted {{epic_contexted}}
+**Epics:** backlog {{epic_backlog}}, in-progress {{epic_in_progress}}, done {{epic_done}}
**Next Recommendation:** /bmad:bmm:workflows:{{next_workflow_id}} ({{next_story_id}})
@@ -141,8 +176,9 @@ If the command targets a story, set `story_key={{next_story_id}}` when prompted.
count_review = {{count_review}}
count_done = {{count_done}}
epic_backlog = {{epic_backlog}}
- epic_contexted = {{epic_contexted}}
- warnings = {{risks}}
+ epic_in_progress = {{epic_in_progress}}
+ epic_done = {{epic_done}}
+ risks = {{risks}}
Return to caller