diff --git a/src/modules/bmgd/workflows/4-production/create-story/instructions.xml b/src/modules/bmgd/workflows/4-production/create-story/instructions.xml index 524a979b..01c76354 100644 --- a/src/modules/bmgd/workflows/4-production/create-story/instructions.xml +++ b/src/modules/bmgd/workflows/4-production/create-story/instructions.xml @@ -119,7 +119,8 @@ - 🔬 EXHAUSTIVE ARTIFACT ANALYSIS - This is where you prevent future developer fuckups! + 📋 REQUIREMENTS ANALYSIS - Extract complete context for story planning + 🎯 Focus: Requirements, acceptance criteria, and dependencies. Gap analysis happens at dev-time. - + Get last 5 commit titles to understand recent work patterns - Analyze 1-5 most recent commits for relevance to current story: - - Files created/modified + Analyze 1-5 most recent commits for context: - Code patterns and conventions used - Library dependencies added/changed - Architecture decisions implemented - Testing approaches used - Extract actionable insights for current story implementation + This provides context for requirements, not codebase gap analysis (happens at dev-time) @@ -178,30 +178,9 @@ Identify any architectural decisions that override previous patterns - - 🌐 ENSURE LATEST TECH KNOWLEDGE - Prevent outdated implementations! **WEB INTELLIGENCE:** Identify specific - technical areas that require latest version knowledge: - - - From architecture analysis, identify specific libraries, APIs, or - frameworks - For each critical technology, research latest stable version and key changes: - - Latest API documentation and breaking changes - - Security vulnerabilities or updates - - Performance improvements or deprecations - - Best practices for current version - - **EXTERNAL CONTEXT INCLUSION:** Include in story any critical latest information the developer needs: - - Specific library versions and why chosen - - API endpoints with parameters and authentication - - Recent security patches or considerations - - Performance optimization techniques - - Migration considerations if upgrading - - - - - 📝 CREATE ULTIMATE STORY FILE - The developer's master implementation guide! + + 📝 CREATE STORY FILE - Requirements foundation with draft tasks for dev-time validation + ⚠️ Tasks generated here are DRAFT based on requirements analysis. They will be validated and refined against actual codebase at dev-time. Initialize from template.md: {default_output_file} @@ -234,26 +213,26 @@ git_intelligence_summary - - - latest_tech_information - - project_context_reference + + Add clear notation to Tasks/Subtasks section: + "⚠️ DRAFT TASKS - Generated from requirements analysis. + Will be validated and refined against actual codebase when dev-story runs." + + story_completion_status Set story Status to: "ready-for-dev" - Add completion note: "Ultimate - context engine analysis completed - comprehensive developer guide created" + Add completion note: "Story planning complete with requirements analysis and draft implementation tasks" - + Validate against checklist at {installed_path}/checklist.md using _bmad/core/tasks/validate-workflow.xml Save story document unconditionally @@ -268,7 +247,7 @@ Report completion - **🎯 ULTIMATE BMad Method STORY CONTEXT CREATED, {user_name}!** + **🎯 BMad Method STORY CREATED, {user_name}!** **Story Details:** - Story ID: {{story_id}} @@ -276,22 +255,25 @@ - File: {{story_file}} - Status: ready-for-dev - **Next Steps:** - 1. Review the comprehensive story in {{story_file}} - 2. **Optional Quality Competition:** Run the scrum masters `*validate-create-story` to have a fresh LLM systematically review and - improve the story context - 3. Run dev agents `dev-story` for optimized implementation - 4. Run `code-review` when complete (auto-marks done) + **What Was Created:** + - ✅ Complete requirements analysis from epics/PRD/architecture + - ✅ Acceptance criteria and success metrics + - ✅ DRAFT implementation tasks (based on requirements) + - ✅ Developer context and architecture guardrails - **Quality Competition Option:** The `*validate-create-story` command runs the story context through an independent LLM in fresh - context that will: + **Next Steps:** + 1. Review the story in {{story_file}} + 2. **Optional Quality Competition:** Run `*validate-create-story` to have a fresh LLM review and improve the story + 3. Run `dev-story` - will perform gap analysis and refine tasks against actual codebase + 4. Run `code-review` when implementation complete + + **Note:** Tasks are DRAFT and will be validated against current codebase when dev-story runs. + + **Quality Competition Option:** The `*validate-create-story` command runs the story through an independent LLM that will: - Systematically re-analyze all source documents - Identify any misses, omissions, or improvements - - Compete to create a more comprehensive story context - Present findings interactively for your approval - - Apply improvements to create the ultimate developer implementation guide - - **The developer now has everything needed for flawless implementation!** + - Apply improvements to enhance the story before development diff --git a/src/modules/bmgd/workflows/4-production/create-story/template.md b/src/modules/bmgd/workflows/4-production/create-story/template.md index c4e129f5..506c8267 100644 --- a/src/modules/bmgd/workflows/4-production/create-story/template.md +++ b/src/modules/bmgd/workflows/4-production/create-story/template.md @@ -16,11 +16,19 @@ so that {{benefit}}. ## Tasks / Subtasks +⚠️ **DRAFT TASKS** - Generated from requirements analysis. Will be validated and refined against actual codebase when dev-story runs. + - [ ] Task 1 (AC: #) - [ ] Subtask 1.1 - [ ] Task 2 (AC: #) - [ ] Subtask 2.1 +## Gap Analysis + +_This section will be populated by dev-story when gap analysis runs._ + +--- + ## Dev Notes - Relevant architecture patterns and constraints diff --git a/src/modules/bmm/workflows/4-implementation/create-story/instructions.xml b/src/modules/bmm/workflows/4-implementation/create-story/instructions.xml index 52405e71..75d967be 100644 --- a/src/modules/bmm/workflows/4-implementation/create-story/instructions.xml +++ b/src/modules/bmm/workflows/4-implementation/create-story/instructions.xml @@ -175,7 +175,8 @@ - 🔬 EXHAUSTIVE ARTIFACT ANALYSIS - This is where you prevent future developer fuckups! + 📋 REQUIREMENTS ANALYSIS - Extract complete context for story planning + 🎯 Focus: Requirements, acceptance criteria, and dependencies. Gap analysis happens at dev-time. - + Get last 5 commit titles to understand recent work patterns - Analyze 1-5 most recent commits for relevance to current story: - - Files created/modified + Analyze 1-5 most recent commits for context: - Code patterns and conventions used - Library dependencies added/changed - Architecture decisions implemented - Testing approaches used - Extract actionable insights for current story implementation + This provides context for requirements, not codebase gap analysis (happens at dev-time) @@ -234,30 +234,9 @@ Identify any architectural decisions that override previous patterns - - 🌐 ENSURE LATEST TECH KNOWLEDGE - Prevent outdated implementations! **WEB INTELLIGENCE:** Identify specific - technical areas that require latest version knowledge: - - - From architecture analysis, identify specific libraries, APIs, or - frameworks - For each critical technology, research latest stable version and key changes: - - Latest API documentation and breaking changes - - Security vulnerabilities or updates - - Performance improvements or deprecations - - Best practices for current version - - **EXTERNAL CONTEXT INCLUSION:** Include in story any critical latest information the developer needs: - - Specific library versions and why chosen - - API endpoints with parameters and authentication - - Recent security patches or considerations - - Performance optimization techniques - - Migration considerations if upgrading - - - - - 📝 CREATE ULTIMATE STORY FILE - The developer's master implementation guide! + + 📝 CREATE STORY FILE - Requirements foundation with draft tasks for dev-time validation + ⚠️ Tasks generated here are DRAFT based on requirements analysis. They will be validated and refined against actual codebase at dev-time. Initialize from template.md: {default_output_file} @@ -267,7 +246,7 @@ story_requirements - + developer_context_section **DEV AGENT GUARDRAILS:** technical_requirements @@ -290,26 +269,26 @@ git_intelligence_summary - - - latest_tech_information - - project_context_reference + + Add clear notation to Tasks/Subtasks section: + "⚠️ DRAFT TASKS - Generated from requirements analysis. + Will be validated and refined against actual codebase when dev-story runs." + + story_completion_status Set story Status to: "ready-for-dev" - Add completion note: "Ultimate - context engine analysis completed - comprehensive developer guide created" + Add completion note: "Story planning complete with requirements analysis and draft implementation tasks" - + Validate against checklist at {installed_path}/checklist.md using _bmad/core/tasks/validate-workflow.xml Save story document unconditionally @@ -324,7 +303,7 @@ Report completion - **🎯 ULTIMATE BMad Method STORY CONTEXT CREATED, {user_name}!** + **🎯 BMad Method STORY CREATED, {user_name}!** **Story Details:** - Story ID: {{story_id}} @@ -332,12 +311,18 @@ - File: {{story_file}} - Status: ready-for-dev - **Next Steps:** - 1. Review the comprehensive story in {{story_file}} - 2. Run dev agents `dev-story` for optimized implementation - 3. Run `code-review` when complete (auto-marks done) + **What Was Created:** + - ✅ Complete requirements analysis from epics/PRD/architecture + - ✅ Acceptance criteria and success metrics + - ✅ DRAFT implementation tasks (based on requirements) + - ✅ Developer context and architecture guardrails - **The developer now has everything needed for flawless implementation!** + **Next Steps:** + 1. Review the story in {{story_file}} + 2. Run `dev-story` - will perform gap analysis and refine tasks against actual codebase + 3. Run `code-review` when implementation complete + + **Note:** Tasks are DRAFT and will be validated against current codebase when dev-story runs. diff --git a/src/modules/bmm/workflows/4-implementation/create-story/template.md b/src/modules/bmm/workflows/4-implementation/create-story/template.md index c4e129f5..506c8267 100644 --- a/src/modules/bmm/workflows/4-implementation/create-story/template.md +++ b/src/modules/bmm/workflows/4-implementation/create-story/template.md @@ -16,11 +16,19 @@ so that {{benefit}}. ## Tasks / Subtasks +⚠️ **DRAFT TASKS** - Generated from requirements analysis. Will be validated and refined against actual codebase when dev-story runs. + - [ ] Task 1 (AC: #) - [ ] Subtask 1.1 - [ ] Task 2 (AC: #) - [ ] Subtask 2.1 +## Gap Analysis + +_This section will be populated by dev-story when gap analysis runs._ + +--- + ## Dev Notes - Relevant architecture patterns and constraints