Files
BMAD-METHOD/src/modules/bmm/workflows/4-implementation/story-ready/instructions.md
2025-10-17 23:44:43 -05:00

3.7 KiB

Story Ready Workflow Instructions (SM 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 SM agent AFTER user reviews a drafted story and confirms it's ready for development NO SEARCHING - SM agent reads status file TODO section to know which story was drafted Simple workflow: Update story file status, move story TODO → IN PROGRESS, move next story BACKLOG → TODO

mode: data data_request: next_story No status file or no TODO story found.

This workflow requires an active status file with a TODO story.

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

Use extracted story information:

  • {{todo_story_id}}: Story to mark ready
  • {{todo_story_title}}: Story title
  • {{todo_story_file}}: Story file path
  • {{status_file_path}}: Status file to update

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

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

Update story file:

  • Change: Status: Draft
  • To: Status: Ready

Save the story file

mode: update action: start_story ⚠️ Failed to update status: {{error}} Story file was updated, but status file update failed. Status updated: Story {{in_progress_story}} ready for development. Next TODO: {{next_todo}}

Display summary

Story Marked Ready for Development, {user_name}!

Story file updated: {{todo_story_file}} → Status: Ready Status file updated: Story moved TODO → IN PROGRESS {{#if next_story}} Next story moved: BACKLOG → TODO ({{next_story_id}}: {{next_story_title}}){{/if}} {{#if no_more_stories}} All stories have been drafted - backlog is empty{{/if}}

Current Story (IN PROGRESS):

  • ID: {{todo_story_id}}
  • Title: {{todo_story_title}}
  • File: {{todo_story_file}}
  • Status: Ready for development

Next Steps:

  1. Recommended: Run story-context workflow to generate implementation context

    • This creates a comprehensive context XML for the DEV agent
    • Includes relevant architecture, dependencies, and existing code
  2. Alternative: Skip context generation and go directly to dev-story workflow

    • Faster, but DEV agent will have less context
    • Only recommended for simple, well-understood stories

To proceed:

  • For context generation: Stay with SM agent and run story-context workflow
  • For direct implementation: Load DEV agent and run dev-story workflow