BMAD-METHOD/bmad/bmm/workflows/2-plan-workflows/tech-spec/instructions-level0-story.md

Level 0 - Minimal User Story Generation

This generates a single user story for Level 0 atomic changes Level 0 = single file change, bug fix, or small isolated task This workflow runs AFTER tech-spec.md has been completed Output format MUST match create-story template for compatibility with story-context and dev-story workflows

Read the completed tech-spec.md file from {output_folder}/tech-spec.md Load bmm-workflow-status.yaml from {output_folder}/bmm-workflow-status.yaml (if exists) Extract dev_story_location from config (where stories are stored)

Extract from the ENHANCED tech-spec structure:

• Problem statement from "The Change → Problem Statement" section
• Solution overview from "The Change → Proposed Solution" section
• Scope from "The Change → Scope" section
• Source tree from "Implementation Details → Source Tree Changes" section
• Time estimate from "Implementation Guide → Implementation Steps" section
• Acceptance criteria from "Implementation Guide → Acceptance Criteria" section
• Framework dependencies from "Development Context → Framework/Libraries" section
• Existing code references from "Development Context → Relevant Existing Code" section
• File paths from "Developer Resources → File Paths Reference" section
• Key code locations from "Developer Resources → Key Code Locations" section
• Testing locations from "Developer Resources → Testing Locations" section

Derive a short URL-friendly slug from the feature/change name Max slug length: 3-5 words, kebab-case format

- "Migrate JS Library Icons" → "icon-migration" - "Fix Login Validation Bug" → "login-fix" - "Add OAuth Integration" → "oauth-integration"

Set story_filename = "story-{slug}.md" Set story_path = "{dev_story_location}/story-{slug}.md"

Create 1 story that describes the technical change as a deliverable Story MUST use create-story template format for compatibility

**Story Point Estimation:** - 1 point = < 1 day (2-4 hours) - 2 points = 1-2 days - 3 points = 2-3 days - 5 points = 3-5 days (if this high, question if truly Level 0)

Story Title Best Practices:

• Use active, user-focused language
• Describe WHAT is delivered, not HOW
• Good: "Icon Migration to Internal CDN"
• Bad: "Run curl commands to download PNGs"

Story Description Format:

• As a [role] (developer, user, admin, etc.)
• I want [capability/change]
• So that [benefit/value]

Acceptance Criteria:

• Extract from tech-spec "Testing Approach" section
• Must be specific, measurable, and testable
• Include performance criteria if specified

Tasks/Subtasks:

• Map directly to tech-spec "Implementation Guide" tasks
• Use checkboxes for tracking
• Reference AC numbers: (AC: #1), (AC: #2)
• Include explicit testing subtasks

Dev Notes:

• Extract technical constraints from tech-spec
• Include file paths from "Developer Resources → File Paths Reference"
• Include existing code references from "Development Context → Relevant Existing Code"
• Reference architecture patterns if applicable
• Cite tech-spec sections for implementation details
• Note dependencies (internal and external)

NEW: Comprehensive Context

Since tech-spec is now context-rich, populate all new template fields:

• dependencies: Extract from "Development Context" and "Implementation Details → Integration Points"
• existing_code_references: Extract from "Development Context → Relevant Existing Code" and "Developer Resources → Key Code Locations"

Initialize story file using user_story_template

story_title role capability benefit acceptance_criteria tasks_subtasks technical_summary files_to_modify test_locations story_points time_estimate dependencies existing_code_references architecture_references

mode: update action: complete_workflow workflow_name: tech-spec ✅ Tech-spec complete! Next: {{next_workflow}}

Load {{status_file_path}} Set STORIES_SEQUENCE: [{slug}] Set TODO_STORY: {slug} Set TODO_TITLE: {{story_title}} Set IN_PROGRESS_STORY: (empty) Set STORIES_DONE: [] Save {{status_file_path}}

Story queue initialized with single story: {slug}

Display completion summary

Level 0 Planning Complete!

Generated Artifacts:

• tech-spec.md → Technical source of truth
• story-{slug}.md → User story ready for implementation

Story Location: {story_path}

Next Steps:

🎯 RECOMMENDED - Direct to Development (Level 0):

Since the tech-spec is now CONTEXT-RICH with:

• ✅ Brownfield codebase analysis (if applicable)
• ✅ Framework and library details with exact versions
• ✅ Existing patterns and code references
• ✅ Complete file paths and integration points

You can skip story-context and go straight to dev!

1. Load DEV agent: {project-root}/bmad/bmm/agents/dev.md
2. Run dev-story workflow
3. Begin implementation immediately

Option B - Generate Additional Context (optional):

Only needed for extremely complex scenarios:

1. Load SM agent: {project-root}/bmad/bmm/agents/sm.md
2. Run story-context workflow (generates additional XML context)
3. Then load DEV agent and run dev-story workflow

Progress Tracking:

• All decisions logged in: bmm-workflow-status.yaml
• Next action clearly identified

Ready to proceed? Choose your path:

1. Go directly to dev-story (RECOMMENDED - tech-spec has all context)
2. Generate additional story context (for complex edge cases)
3. Exit for now

Select option (1-3):