Story Approved Workflow Instructions (DEV Agent)

The workflow execution engine is governed by: {project_root}/bmad/core/tasks/workflow.xml You MUST have already loaded and processed: {installed_path}/workflow.yaml Communicate all responses in {communication_language} and language MUST be tailored to {user_skill_level} Generate all documents in {document_output_language}

This workflow is run by DEV agent AFTER user confirms a story is approved (Definition of Done is complete) NO SEARCHING - DEV agent reads status file IN PROGRESS section to know which story was being worked on Workflow: Update story file status, move story IN PROGRESS → DONE, move TODO → IN PROGRESS, move BACKLOG → TODO

mode: data data_request: all ❌ No status file or no IN PROGRESS story found.

This workflow requires an active status file with an IN PROGRESS story.

Run workflow-status to check your project state. Exit workflow

Use extracted story queue:

{{in_progress_story}}: Current story to mark done
{{todo_story_id}}: Next story (move to IN PROGRESS)
{{stories_sequence}}: All stories
{{stories_done}}: Completed stories
{{status_file_path}}: Status file to update

Read the story file: {story_dir}/{current_story_file}

Find the "Status:" line (usually at the top)

Update story file:

Change: Status: Ready or Status: In Review
To: Status: Done

Add completion notes if Dev Agent Record section exists:

Find "## Dev Agent Record" section and add:

### Completion Notes
**Completed:** {{date}}
**Definition of Done:** All acceptance criteria met, code reviewed, tests passing, deployed

Save the story file

mode: update action: complete_story ⚠️ Failed to update status: {{error}} Story file was updated, but status file update failed. Status updated: Story {{completed_story}} marked done. 🎉 All stories complete! Phase 4 done! {{stories_remaining}} stories remaining.

Display summary

Story Approved and Marked Done, {user_name}!

✅ Story file updated: {{current_story_file}} → Status: Done ✅ Status file updated: Story moved IN PROGRESS → DONE {{#if todo_story}}✅ Next story moved: TODO → IN PROGRESS ({{todo_story_id}}: {{todo_story_title}}){{/if}} {{#if next_backlog_story}}✅ Next story moved: BACKLOG → TODO ({{next_backlog_story_id}}: {{next_backlog_story_title}}){{/if}}

Completed Story:

ID: {{current_story_id}}
Title: {{current_story_title}}
File: {{current_story_file}}
Points: {{current_story_points}}
Completed: {{date}}

Progress Summary:

Stories Completed: {{done_count}} / {{total_stories}}
Points Completed: {{done_points}} / {{total_points}}
Progress: {{progress_percentage}}%

{{#if all_stories_complete}} 🎉 ALL STORIES COMPLETE!

Congratulations! You have completed all stories for this project.

Next Steps:

Run retrospective workflow with PM agent to review the project
Close out the project
Celebrate! 🎊 {{/if}}

{{#if todo_story}} Next Story (IN PROGRESS):

ID: {{todo_story_id}}
Title: {{todo_story_title}}
File: {{todo_story_file}}
Status: {{todo_story_status}}

Next Steps: {{#if todo_story_status == 'Draft'}}

Review the drafted story {{todo_story_file}}
Load SM agent and run story-ready workflow to approve it
Then return to DEV agent to implement {{else}}
Stay with DEV agent and run dev-story workflow
Implement story {{todo_story_id}} {{/if}} {{/if}}

{{#if backlog_not_empty AND todo_empty}} Next Story (TODO):

ID: {{next_backlog_story_id}}
Title: {{next_backlog_story_title}}

Next Steps:

Load SM agent
Run create-story workflow to draft story {{next_backlog_story_id}} {{/if}}

```

4.8 KiB Raw Blame History

Story Approved Workflow Instructions (DEV Agent)

4.8 KiB

Raw Blame History