diff --git a/src/modules/bmm/workflows/2-plan/README.md b/src/modules/bmm/workflows/2-plan/README.md index 560f0c05..5bceeffa 100644 --- a/src/modules/bmm/workflows/2-plan/README.md +++ b/src/modules/bmm/workflows/2-plan/README.md @@ -70,10 +70,10 @@ plan-project/ │ ├── prd-template.md # Product Requirements Document template │ └── workflow.yaml ├── tech-spec/ -│ ├── epic-stories-template.md # Epic-to-story handoff template +│ ├── epics-template.md # Epic-to-story handoff template │ ├── instructions-level0-story.md │ ├── instructions-level1-stories.md -│ ├── instructions-sm.md # Level 0 tech-spec instructions +│ ├── instructions.md # Level 0 tech-spec instructions │ ├── tech-spec-template.md # Technical Specification template │ ├── user-story-template.md # Story template for Level 0/1 │ └── workflow.yaml diff --git a/src/modules/bmm/workflows/2-plan/instructions-router.md b/src/modules/bmm/workflows/2-plan/instructions-router.md index 8247deb1..98bef0b1 100644 --- a/src/modules/bmm/workflows/2-plan/instructions-router.md +++ b/src/modules/bmm/workflows/2-plan/instructions-router.md @@ -91,7 +91,7 @@ After updating your plan, return here if needed. Check for existing workflow outputs based on level in status file: - Level 0: Check for tech-spec.md -- Level 1-2: Check for PRD.md, epic-stories.md, tech-spec.md +- Level 1-2: Check for PRD.md, epics.md, tech-spec.md - Level 3-4: Check for PRD.md, epics.md diff --git a/src/modules/bmm/workflows/2-plan/tech-spec/epic-stories-template.md b/src/modules/bmm/workflows/2-plan/tech-spec/epics-template.md similarity index 100% rename from src/modules/bmm/workflows/2-plan/tech-spec/epic-stories-template.md rename to src/modules/bmm/workflows/2-plan/tech-spec/epics-template.md diff --git a/src/modules/bmm/workflows/2-plan/tech-spec/instructions-level1-stories.md b/src/modules/bmm/workflows/2-plan/tech-spec/instructions-level1-stories.md index 563abe6a..2ba1eaf8 100644 --- a/src/modules/bmm/workflows/2-plan/tech-spec/instructions-level1-stories.md +++ b/src/modules/bmm/workflows/2-plan/tech-spec/instructions-level1-stories.md @@ -58,14 +58,14 @@ - "Admin Dashboard" → "admin-dashboard" -Initialize epic-stories.md summary document using epic_stories_template +Initialize epics.md summary document using epics_template -epic_title -epic_slug -epic_goal -epic_scope -epic_success_criteria -epic_dependencies +epic_title +epic_slug +epic_goal +epic_scope +epic_success_criteria +epic_dependencies @@ -105,9 +105,6 @@ For each story (2-3 total), generate separate story file Story filename format: "story-{epic_slug}-{n}.md" where n = 1, 2, or 3 -Each story should represent a deliverable unit of work -Stories should have clear acceptance criteria from tech spec -Estimate story points based on time estimates in tech spec **Story Generation Guidelines:** @@ -140,58 +137,27 @@ - Dev Agent Record: Empty sections for context workflow to populate -For story 1: -Set story_path_1 = "{dev_story_location}/story-{epic_slug}-1.md" -Initialize from user_story_template + + Set story_path_{n} = "{dev_story_location}/story-{epic_slug}-{n}.md" + Create story file from user_story_template with the following content: -story_title -role -capability -benefit -acceptance_criteria -tasks_subtasks -technical_summary -files_to_modify -test_locations -story_points -time_estimate -architecture_references + + - story_title: User-focused deliverable title + - role: User role (e.g., developer, user, admin) + - capability: What they want to do + - benefit: Why it matters + - acceptance_criteria: Specific, measurable criteria from tech spec + - tasks_subtasks: Implementation tasks with AC references + - technical_summary: High-level approach, key decisions + - files_to_modify: List of files that will change + - test_locations: Where tests will be added + - story_points: Estimated effort (1/2/3/5) + - time_estimate: Days/hours estimate + - architecture_references: Links to tech-spec.md sections + + -For story 2: -Set story_path_2 = "{dev_story_location}/story-{epic_slug}-2.md" -Initialize from user_story_template - -story_title -role -capability -benefit -acceptance_criteria -tasks_subtasks -technical_summary -files_to_modify -test_locations -story_points -time_estimate -architecture_references - - - For story 3: - Set story_path_3 = "{dev_story_location}/story-{epic_slug}-3.md" - Initialize from user_story_template - -story_title -role -capability -benefit -acceptance_criteria -tasks_subtasks -technical_summary -files_to_modify -test_locations -story_points -time_estimate -architecture_references - +Generate exactly {story_count} story files (2 or 3 based on Step 3 decision) @@ -220,11 +186,11 @@ Epic: Icon Reliability 2. **Story 2** → Test and deploy (depends on Story 1) -story_summaries -story_map -total_points -estimated_timeline -implementation_sequence +story_summaries +story_map +total_points +estimated_timeline +implementation_sequence @@ -290,7 +256,7 @@ Initialize empty table: ``` | tech-spec.md | Complete | {output_folder}/tech-spec.md | {{date}} | -| epic-stories.md | Complete | {output_folder}/epic-stories.md | {{date}} | +| epics.md | Complete | {output_folder}/epics.md | {{date}} | | story-{epic_slug}-1.md | Draft | {dev_story_location}/story-{epic_slug}-1.md | {{date}} | | story-{epic_slug}-2.md | Draft | {dev_story_location}/story-{epic_slug}-2.md | {{date}} | {{#if story_3}} @@ -335,7 +301,7 @@ Initialize empty table: **Generated Artifacts:** - `tech-spec.md` → Technical source of truth -- `epic-stories.md` → Epic and story summary +- `epics.md` → Epic and story summary - `story-{epic_slug}-1.md` → First story (ready for implementation) - `story-{epic_slug}-2.md` → Second story {{#if story_3}} diff --git a/src/modules/bmm/workflows/2-plan/tech-spec/instructions-sm.md b/src/modules/bmm/workflows/2-plan/tech-spec/instructions.md similarity index 97% rename from src/modules/bmm/workflows/2-plan/tech-spec/instructions-sm.md rename to src/modules/bmm/workflows/2-plan/tech-spec/instructions.md index 963b4ae5..69baf948 100644 --- a/src/modules/bmm/workflows/2-plan/tech-spec/instructions-sm.md +++ b/src/modules/bmm/workflows/2-plan/tech-spec/instructions.md @@ -118,7 +118,7 @@ Run cohesion validation? (y/n) Invoke instructions-level1-stories.md to generate epic and stories - Epic and stories will be saved to epic-stories.md + Epic and stories will be saved to epics.md Stories link to tech-spec.md implementation tasks @@ -133,7 +133,7 @@ Run cohesion validation? (y/n) - Confirm epic-stories.md generated successfully + Confirm epics.md generated successfully ## Summary @@ -145,7 +145,7 @@ Run cohesion validation? (y/n) -- **Level 1 Output**: tech-spec.md + epic-stories.md +- **Level 1 Output**: tech-spec.md + epics.md - **No PRD required** - **Ready for sprint planning with epic/story breakdown** diff --git a/src/modules/bmm/workflows/2-plan/tech-spec/tech-spec-template.md b/src/modules/bmm/workflows/2-plan/tech-spec/tech-spec-template.md index d918de73..372fad6c 100644 --- a/src/modules/bmm/workflows/2-plan/tech-spec/tech-spec-template.md +++ b/src/modules/bmm/workflows/2-plan/tech-spec/tech-spec-template.md @@ -53,7 +53,3 @@ ## Deployment Strategy {{deployment_strategy}} - ---- - -_This tech spec is for Level 0-2 projects (BMad Method v6). It provides the technical details needed for implementation. Level 3+ projects use the separate architecture workflow for comprehensive technical design._ diff --git a/src/modules/bmm/workflows/2-plan/tech-spec/user-story-template.md b/src/modules/bmm/workflows/2-plan/tech-spec/user-story-template.md index 8f9f6e7c..c2e75358 100644 --- a/src/modules/bmm/workflows/2-plan/tech-spec/user-story-template.md +++ b/src/modules/bmm/workflows/2-plan/tech-spec/user-story-template.md @@ -54,8 +54,3 @@ so that {{benefit}}. ### File List - ---- - -_Generated as part of Level 0 Tech Spec workflow (BMad Method v6)_ -_Story Format: Compatible with story-context and dev-story workflows_ diff --git a/src/modules/bmm/workflows/2-plan/tech-spec/workflow.yaml b/src/modules/bmm/workflows/2-plan/tech-spec/workflow.yaml index 24911a20..e705c097 100644 --- a/src/modules/bmm/workflows/2-plan/tech-spec/workflow.yaml +++ b/src/modules/bmm/workflows/2-plan/tech-spec/workflow.yaml @@ -12,7 +12,7 @@ date: system-generated # Workflow components installed_path: "{project-root}/bmad/bmm/workflows/2-plan/tech-spec" -instructions: "{installed_path}/instructions-sm.md" +instructions: "{installed_path}/instructions.md" template: "{installed_path}/tech-spec-template.md" # Story generation instructions (invoked based on level) @@ -21,12 +21,12 @@ instructions_level1_stories: "{installed_path}/instructions-level1-stories.md" # Templates user_story_template: "{installed_path}/user-story-template.md" -epic_stories_template: "{installed_path}/epic-stories-template.md" +epics_template: "{installed_path}/epics-template.md" # Output configuration default_output_file: "{output_folder}/tech-spec.md" user_story_file: "{output_folder}/user-story.md" -epic_stories_file: "{output_folder}/epic-stories.md" +epics_file: "{output_folder}/epics.md" # Recommended input documents (optional for Level 0) recommended_inputs: @@ -57,15 +57,15 @@ web_bundle: name: "tech-spec-sm" description: "Technical specification workflow for Level 0-1 projects. Creates focused tech spec with story generation. Level 0: tech-spec + user story. Level 1: tech-spec + epic/stories." author: "BMad" - instructions: "bmad/bmm/workflows/2-plan/tech-spec/instructions-sm.md" + instructions: "bmad/bmm/workflows/2-plan/tech-spec/instructions.md" use_advanced_elicitation: true web_bundle_files: - - "bmad/bmm/workflows/2-plan/tech-spec/instructions-sm.md" + - "bmad/bmm/workflows/2-plan/tech-spec/instructions.md" - "bmad/bmm/workflows/2-plan/tech-spec/instructions-level0-story.md" - "bmad/bmm/workflows/2-plan/tech-spec/instructions-level1-stories.md" - "bmad/bmm/workflows/2-plan/tech-spec/tech-spec-template.md" - "bmad/bmm/workflows/2-plan/tech-spec/user-story-template.md" - - "bmad/bmm/workflows/2-plan/tech-spec/epic-stories-template.md" + - "bmad/bmm/workflows/2-plan/tech-spec/epics-template.md" # Technical frameworks available frameworks: - "Technical Design Patterns" diff --git a/src/modules/bmm/workflows/2-plan/ux/instructions-ux.md b/src/modules/bmm/workflows/2-plan/ux/instructions-ux.md index 6e1f228c..bdbff856 100644 --- a/src/modules/bmm/workflows/2-plan/ux/instructions-ux.md +++ b/src/modules/bmm/workflows/2-plan/ux/instructions-ux.md @@ -35,7 +35,7 @@ If no: We'll gather basic requirements to create the UX spec Load the following documents if available: - PRD.md (primary source for requirements and user journeys) -- epics.md or epic-stories.md (helps understand feature grouping) +- epics.md (helps understand feature grouping) - tech-spec.md (understand technical constraints) - solution-architecture.md (if Level 3-4 project) - bmm-workflow-status.md (understand project level and scope) diff --git a/src/modules/bmm/workflows/2-plan/workflow.yaml b/src/modules/bmm/workflows/2-plan/workflow.yaml index db62e81b..6e96679d 100644 --- a/src/modules/bmm/workflows/2-plan/workflow.yaml +++ b/src/modules/bmm/workflows/2-plan/workflow.yaml @@ -58,7 +58,7 @@ scale_parameters: level_4: "40+ stories, 5+ epics, enterprise PRD + architect handoff" #Do not load these directly - instructions-router.md will load the proper file based on project type/level when needed -instructions_sm: "{installed_path}/tech-spec/instructions-sm.md" +instructions_sm: "{installed_path}/tech-spec/instructions.md" instructions_med: "{installed_path}/prd/instructions-med.md" instructions_lg: "{installed_path}/prd/instructions-lg.md" instructions_ux: "{installed_path}/ux/instructions-ux.md" @@ -75,7 +75,7 @@ web_bundle: validation: "bmad/bmm/workflows/2-plan/checklist.md" use_advanced_elicitation: true # Do not load these directly - instructions-router.md will load the proper file based on project type/level when needed - instructions_sm: "bmad/bmm/workflows/2-plan/tech-spec/instructions-sm.md" + instructions_sm: "bmad/bmm/workflows/2-plan/tech-spec/instructions.md" instructions_med: "bmad/bmm/workflows/2-plan/prd/instructions-med.md" instructions_lg: "bmad/bmm/workflows/2-plan/prd/instructions-lg.md" instructions_ux: "bmad/bmm/workflows/2-plan/ux/instructions-ux.md" @@ -99,7 +99,7 @@ web_bundle: level_4: "40+ stories, 5+ epics, enterprise PRD + architect handoff" web_bundle_files: - "bmad/bmm/workflows/2-plan/instructions-router.md" - - "bmad/bmm/workflows/2-plan/tech-spec/instructions-sm.md" + - "bmad/bmm/workflows/2-plan/tech-spec/instructions.md" - "bmad/bmm/workflows/2-plan/prd/instructions-med.md" - "bmad/bmm/workflows/2-plan/prd/instructions-lg.md" - "bmad/bmm/workflows/2-plan/prd/prd-template.md"