use sprint plan for al workflow level 4 implementations

src/modules/bmm/workflows/4-implementation/story-done/instructions.md

@@ -10,25 +10,55 @@
 <critical>This workflow is run by DEV agent AFTER user confirms a story is approved (Definition of Done is complete)</critical>
 <critical>Workflow: Update story file status to Done</critical>
 
-<step n="1" goal="Locate story and update to Done status">
+<step n="1" goal="Find reviewed story and mark done">
 
-<action>If {{story_path}} explicitly provided → use it</action>
-<action>Otherwise list story-\*.md files from {{story_dir}}, sort by modified time</action>
-<ask>Select the story to mark as Done, or enter path:</ask>
+<action>If {{story_path}} is provided → use it directly; extract story_key from filename or metadata; GOTO mark_done</action>
 
-<action>Read the story file: {{story_path}}</action>
-<action>Extract story ID and title from the file</action>
+<action>Otherwise query sprint-status for reviewed stories:</action>
+
+<invoke-workflow path="{project-root}/bmad/bmm/workflows/helpers/sprint-status">
+  <param>action: list_stories</param>
+  <param>filter_status: review</param>
+  <param>limit: 10</param>
+</invoke-workflow>
+
+<check if="{{result_count}} == 0">
+  <output>📋 No stories in review status found
+
+All stories are either still in development or already done.
+
+**Options:**
+
+1. Run `dev-story` to implement stories
+2. Run `review-story` if stories need review first
+3. Check sprint-status.yaml for current story states
+   </output>
+   <action>HALT</action>
+   </check>
+
+<action>Display available reviewed stories:
+
+**Stories Ready to Mark Done ({{result_count}} found):**
+
+{{result_story_list}}
+
+</action>
+
+<ask>Select the story to mark as Done (enter story key or number):</ask>
+
+<action>Resolve selected story_key from user input</action>
+<action>Find matching story file in {{story_dir}} using story_key pattern</action>
+
+<anchor id="mark_done" />
+
+<action>Read the story file from resolved path</action>
+<action>Extract story_id and story_title from the file</action>
 
 <action>Find the "Status:" line (usually at the top)</action>
+<action>Update story file: Change Status to "Done"</action>
 
-<action>Update story file:</action>
-
-- Change: `Status: Ready for Review` or `Status: In Review` or similar
-- To: `Status: Done`
-
-<action>Add completion notes if Dev Agent Record section exists:</action>
-
-Find "## Dev Agent Record" section and add:
+<action>Add completion notes to Dev Agent Record section:</action>
+<action>Find "## Dev Agent Record" section and add:
 
 ```
 ### Completion Notes
@@ -36,8 +66,24 @@ Find "## Dev Agent Record" section and add:
 **Definition of Done:** All acceptance criteria met, code reviewed, tests passing
 ```
 
+</action>
+
 <action>Save the story file</action>
 
+<invoke-workflow path="{project-root}/bmad/bmm/workflows/helpers/sprint-status">
+  <param>action: update_story_status</param>
+  <param>story_key: {{story_key}}</param>
+  <param>new_status: done</param>
+  <param>validate: true</param>
+</invoke-workflow>
+
+<check if="{{result_success}} == false">
+  <output>⚠️ Story file updated, but could not update sprint-status: {{result_error}}
+
+Story is marked Done in file, but sprint-status.yaml may be out of sync.
+</output>
+</check>
+
 </step>
 
 <step n="2" goal="Confirm completion to user">
@@ -45,10 +91,12 @@ Find "## Dev Agent Record" section and add:
 <output>**Story Approved and Marked Done, {user_name}!**
 
 ✅ Story file updated: `{{story_file}}` → Status: Done
+✅ Sprint status updated: {{result_old_status}} → {{result_new_status}}
 
 **Completed Story:**
 
 - **ID:** {{story_id}}
+- **Key:** {{story_key}}
 - **Title:** {{story_title}}
 - **File:** `{{story_file}}`
 - **Completed:** {{date}}
@@ -56,8 +104,12 @@ Find "## Dev Agent Record" section and add:
 **Next Steps:**
 
 1. Continue with next story in your backlog
-2. Or run `retrospective` workflow if all stories are complete
-   </output>
+   - Run `create-story` for next backlog story
+   - Or run `dev-story` if ready stories exist
+2. Check epic completion status
+   - Run `retrospective` workflow to check if epic is complete
+   - Epic retrospective will verify all stories are done
+     </output>
 
 </step>