diff --git a/src/bmm/tasks/whats-after.md b/src/bmm/tasks/bmad-help.md similarity index 52% rename from src/bmm/tasks/whats-after.md rename to src/bmm/tasks/bmad-help.md index 97274cd0..a2fce675 100644 --- a/src/bmm/tasks/whats-after.md +++ b/src/bmm/tasks/bmad-help.md @@ -1,32 +1,39 @@ --- -name: whats-after -description: Show what workflow steps come next in the BMad Method based on what's been completed +name: bmad-help +description: Get unstuck by showing what workflow steps come next or answering questions about what to do in the BMad Method standalone: true --- -# Task: What's Next? +# Task: BMAD Help -## INPUT +## EXECUTION + +1 Load `./workflows.csv` and `{project-root}/_bmad/_config/agent-manifest.csv`. + +### INPUT Arg handling Task input argument may provide: - A workflow **name** just completed (e.g., "validating the UX", "Create PRD", "done with architecture") - A workflow **code** (e.g., "VU", "CP", "CA") -- Nothing - in which case you should infer from context or ask +- conversational phrase +- Nothing - in which case you should infer from #CONTEXT-INFERENCE ## CONTEXT INFERENCE -If no explicit workflow is provided, check the conversation context: +If no explicit workflow row is provided as just completed, check the conversation context: - Did someone recently state they completed something? (e.g., "I'm done with my PRD") + - Proceed as if that was the presented arg input - Was a workflow just completed in this conversation? + - Proceed as if that was the presented arg input +- Do not actually load or read and of these yet to avoid context bloat, but just use file search to see what can be found in {`config:output_folder`}, {`config:planning_artifacts`}, {`config:implementation_artifacts`} or {`config:project_knowledge`} and try to infer from the file names. If a location has an index.md you can read that if needed. Remember: Artifacts could be nested deep under these locations also. + - Based on fuzzy matching or inference of what a row indicates as output vs what has been found, infer what steps might be complete but need user confirmation - If unclear, ask: "What workflow did you most recently complete?" -## EXECUTION - -Load `./workflows.csv` and `{project-root}/_bmad/_config/agent-manifest.csv`. Find all workflow items after the completed row. Present these in a clear, conversational format. +Find all workflow items after the completed row. Present these in a clear, conversational format. **Phases number to name reference:** Phase 0 (Any Time), Phase 1 (Analysis), Phase 2 (Planning), Phase 3 (Solutioning), Phase 4 (Implementation) -**Present the next steps as follows:** +**If the request is for next steps, present the next steps as follows:** 1. **Optional items first** - List any optional workflows until a required step is reached 2. **Required items next** - List the next required workflow @@ -42,4 +49,6 @@ Load `./workflows.csv` and `{project-root}/_bmad/_config/agent-manifest.csv`. Fi - Note: Running without the agent will not include all specifics of the agent personality or any customizations, but will still have aspects of an expert at what will be done. - For **validation workflows**: recommend using a different high-quality LLM if available -Upon presentation of whats next recommendation - return back to the calling process if one was in progress. +**If the request is more conversational, then give a more conversational response, still following the convention of how to portray specific agents and commands. + +Upon presentation of whats next recommendation - return back to the calling process or conversation thread. diff --git a/src/bmm/tasks/workflows.csv b/src/bmm/tasks/workflows.csv index e2bad0c3..84ba7e78 100644 --- a/src/bmm/tasks/workflows.csv +++ b/src/bmm/tasks/workflows.csv @@ -1,18 +1,26 @@ -phase,name,code,sequence,workflow-file,command,required,agent,options,description -0,Document Project,DP,10,_bmad/bmm/workflows/document-project/workflow.yaml,bmad:bmm:document-project,false,analyst,Create Mode,Analyze an existing project to produce useful documentation -1,Brainstorm Project,BP,10,_bmad/core/workflows/brainstorming/workflow.md,bmad:bmm:brainstorming,false,analyst,data=_bmad/bmm/data/project-context-template.md,Expert Guided Facilitation through a single or multiple techniques -1,Research,RS,20,_bmad/bmm/workflows/1-analysis/research/workflow.md,bmad:bmm:research,false,analyst,Create Mode,Choose from or specify market domain competitive analysis or technical research -1,Create Brief,CB,30,_bmad/bmm/workflows/1-analysis/create-product-brief/workflow.md,bmad:bmm:create-brief,false,analyst,Create Mode,A guided experience to nail down your product idea -1,Validate Brief,VB,40,_bmad/bmm/workflows/1-analysis/create-product-brief/workflow.md,bmad:bmm:validate-brief,false,analyst,Validate Mode,Validates product brief completeness -2,Create PRD,CP,10,_bmad/bmm/workflows/2-plan-workflows/prd/workflow.md,bmad:bmm:create-prd,true,pm,Create Mode,Expert led facilitation to produce your Product Requirements Document -2,Validate PRD,VP,20,_bmad/bmm/workflows/2-plan-workflows/prd/workflow.md,bmad:bmm:validate-prd,false,pm,Validate Mode,Validate PRD is comprehensive lean well organized and cohesive -2,Create UX,CU,30,_bmad/bmm/workflows/2-plan-workflows/create-ux-design/workflow.md,bmad:bmm:create-ux,false,ux-designer,Create Mode,Guidance through realizing the plan for your UX -2,Validate UX,VU,40,_bmad/bmm/workflows/2-plan-workflows/create-ux-design/workflow.md,bmad:bmm:validate-ux,false,ux-designer,Validate Mode,Validates UX design deliverables -3,Create Architecture,CA,10,_bmad/bmm/workflows/3-solutioning/create-architecture/workflow.md,bmad:bmm:create-architecture,true,architect,Create Mode,Guided Workflow to document technical decisions -3,Validate Architecture,VA,20,_bmad/bmm/workflows/3-solutioning/create-architecture/workflow.md,bmad:bmm:validate-architecture,false,architect,Validate Mode,Validates architecture completeness -3,Create Epics and Stories,CE,30,_bmad/bmm/workflows/3-solutioning/create-epics-and-stories/workflow.md,bmad:bmm:create-epics-and-stories,true,pm,Create Mode,Create the Epics and Stories Listing -3,Validate Epics and Stories,VE,40,_bmad/bmm/workflows/3-solutioning/create-epics-and-stories/workflow.md,bmad:bmm:validate-epics-and-stories,false,pm,Validate Mode,Validates epics and stories completeness -3,Test Design,TD,50,_bmad/bmm/workflows/testarch/test-design/workflow.yaml,bmad:bmm:test-design,false,tea,Create Mode,Create comprehensive test scenarios ahead of development -3,Validate Test Design,VT,60,_bmad/bmm/workflows/testarch/test-design/workflow.yaml,bmad:bmm:validate-test-design,false,tea,Validate Mode,Validates test design coverage -3,Implementation Readiness,IR,70,_bmad/bmm/workflows/3-solutioning/check-implementation-readiness/workflow.md,bmad:bmm:implementation-readiness,true,architect,Validate Mode,Ensure PRD UX Architecture and Epics Stories are aligned -4,Sprint Planning,SP,10,_bmad/bmm/workflows/4-implementation/sprint-planning/workflow.yaml,bmad:bmm:sprint-planning,true,sm,Create Mode,Generate sprint plan for development tasks +phase,name,code,sequence,workflow-file,command,required,agent,options,description,output-location,outputs +0,Document Project,DP,10,_bmad/bmm/workflows/document-project/workflow.yaml,bmad:bmm:document-project,false,analyst,Create Mode,Analyze an existing project to produce useful documentation,project-knowledge,* +0,Tech Spec,TS,20,_bmad/bmm/workflows/bmad-quick-flow/quick-spec/workflow.md,bmad:bmm:tech-spec,false,quick-flow-solo-dev,Create Mode,Quick one-off tasks small changes simple apps utilities without extensive planning,planning_artifacts,tech spec +0,Quick Dev,QD,30,_bmad/bmm/workflows/bmad-quick-flow/quick-dev/workflow.md,bmad:bmm:quick-dev,false,quick-flow-solo-dev,Create Mode,Quick one-off tasks small changes simple apps utilities without extensive planning,, +0,Correct Course,CC,40,_bmad/bmm/workflows/4-implementation/correct-course/workflow.yaml,bmad:bmm:correct-course,false,sm,Create Mode,Anytime: Navigate significant changes. May recommend start over update PRD redo architecture sprint planning or correct epics and stories,planning_artifacts,change proposal +1,Brainstorm Project,BP,10,_bmad/core/workflows/brainstorming/workflow.md,bmad:bmm:brainstorming,false,analyst,data=_bmad/bmm/data/project-context-template.md,Expert Guided Facilitation through a single or multiple techniques,planning_artifacts,brainstorming session +1,Research,RS,20,_bmad/bmm/workflows/1-analysis/research/workflow.md,bmad:bmm:research,false,analyst,Create Mode,Choose from or specify market domain competitive analysis or technical research,planning_artifacts|project-knowledge,research documents +1,Create Brief,CB,30,_bmad/bmm/workflows/1-analysis/create-product-brief/workflow.md,bmad:bmm:create-brief,false,analyst,Create Mode,A guided experience to nail down your product idea,planning_artifacts,product brief +1,Validate Brief,VB,40,_bmad/bmm/workflows/1-analysis/create-product-brief/workflow.md,bmad:bmm:validate-brief,false,analyst,Validate Mode,Validates product brief completeness,planning_artifacts,brief validation report +2,Create PRD,CP,10,_bmad/bmm/workflows/2-plan-workflows/prd/workflow.md,bmad:bmm:create-prd,true,pm,Create Mode,Expert led facilitation to produce your Product Requirements Document,planning_artifacts,prd +2,Validate PRD,VP,20,_bmad/bmm/workflows/2-plan-workflows/prd/workflow.md,bmad:bmm:validate-prd,false,pm,Validate Mode,Validate PRD is comprehensive lean well organized and cohesive,planning_artifacts,prd validation report +2,Create UX,CU,30,_bmad/bmm/workflows/2-plan-workflows/create-ux-design/workflow.md,bmad:bmm:create-ux,false,ux-designer,Create Mode,Guidance through realizing the plan for your UX,planning_artifacts,ux design +2,Validate UX,VU,40,_bmad/bmm/workflows/2-plan-workflows/create-ux-design/workflow.md,bmad:bmm:validate-ux,false,ux-designer,Validate Mode,Validates UX design deliverables,planning_artifacts,ux validation report +3,Create Architecture,CA,10,_bmad/bmm/workflows/3-solutioning/create-architecture/workflow.md,bmad:bmm:create-architecture,true,architect,Create Mode,Guided Workflow to document technical decisions,planning_artifacts,architecture +3,Validate Architecture,VA,20,_bmad/bmm/workflows/3-solutioning/create-architecture/workflow.md,bmad:bmm:validate-architecture,false,architect,Validate Mode,Validates architecture completeness,planning_artifacts,architecture validation report +3,Create Epics and Stories,CE,30,_bmad/bmm/workflows/3-solutioning/create-epics-and-stories/workflow.md,bmad:bmm:create-epics-and-stories,true,pm,Create Mode,Create the Epics and Stories Listing,planning_artifacts,epics and stories +3,Validate Epics and Stories,VE,40,_bmad/bmm/workflows/3-solutioning/create-epics-and-stories/workflow.md,bmad:bmm:validate-epics-and-stories,false,pm,Validate Mode,Validates epics and stories completeness,planning_artifacts,epics validation report +3,Test Design,TD,50,_bmad/bmm/workflows/testarch/test-design/workflow.yaml,bmad:bmm:test-design,false,tea,Create Mode,Create comprehensive test scenarios ahead of development,planning_artifacts,test design +3,Validate Test Design,VT,60,_bmad/bmm/workflows/testarch/test-design/workflow.yaml,bmad:bmm:validate-test-design,false,tea,Validate Mode,Validates test design coverage,planning_artifacts,test design validation report +3,Implementation Readiness,IR,70,_bmad/bmm/workflows/3-solutioning/check-implementation-readiness/workflow.md,bmad:bmm:implementation-readiness,true,architect,Validate Mode,Ensure PRD UX Architecture and Epics Stories are aligned,planning_artifacts,readiness report +4,Sprint Planning,SP,10,_bmad/bmm/workflows/4-implementation/sprint-planning/workflow.yaml,bmad:bmm:sprint-planning,true,sm,Create Mode,Generate sprint plan for development tasks,implementation_artifacts,sprint status +4,Sprint Status,SS,20,_bmad/bmm/workflows/4-implementation/sprint-status/workflow.yaml,bmad:bmm:sprint-status,false,sm,Create Mode,Anytime: Summarize sprint status and route to next workflow,, +4,Create Story,CS,30,_bmad/bmm/workflows/4-implementation/create-story/workflow.yaml,bmad:bmm:create-story,true,sm,Create Mode,Story cycle start: Prepare story with context then DS then CR then back to DS if needed or next CS or ER,implementation_artifacts,story +4,Dev Story,DS,40,_bmad/bmm/workflows/4-implementation/dev-story/workflow.yaml,bmad:bmm:dev-story,true,dev,Create Mode,Story cycle: Execute story implementation tasks and tests then CR then back to DS if fixes needed,, +4,Code Review,CR,50,_bmad/bmm/workflows/4-implementation/code-review/workflow.yaml,bmad:bmm:code-review,false,dev,Create Mode,Story cycle: If issues back to DS if approved then next CS or ER if epic complete,, +4,Retrospective,ER,60,_bmad/bmm/workflows/4-implementation/retrospective/workflow.yaml,bmad:bmm:retrospective,false,sm,Create Mode,Optional at epic end: Review completed work lessons learned and next epic or if major issues consider CC,implementation_artifacts,retrospective diff --git a/src/bmm/workflows/1-analysis/create-product-brief/steps/step-06-complete.md b/src/bmm/workflows/1-analysis/create-product-brief/steps/step-06-complete.md index 2a88eb0e..0635e771 100644 --- a/src/bmm/workflows/1-analysis/create-product-brief/steps/step-06-complete.md +++ b/src/bmm/workflows/1-analysis/create-product-brief/steps/step-06-complete.md @@ -128,7 +128,7 @@ Recap that the brief captures everything needed to guide subsequent product deve ### 5. Suggest next steps -Execute task `_bmad/bmm/tasks/whats-after.md` with argument `Validate PRD`. +Execute task `_bmad/bmm/tasks/bmad-help.md` with argument `Validate PRD`. --- diff --git a/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-14-complete.md b/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-14-complete.md index 63df6fc8..799b6de6 100644 --- a/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-14-complete.md +++ b/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-14-complete.md @@ -82,7 +82,7 @@ Update the main workflow status file: ### 3. Suggest Next Steps -Execute task `_bmad/bmm/tasks/whats-after.md` with argument `Create UX`. +Execute task `_bmad/bmm/tasks/bmad-help.md` with argument `Create UX`. ### 5. Final Completion Confirmation diff --git a/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-12-complete.md b/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-12-complete.md index cfa54d79..9588a99c 100644 --- a/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-12-complete.md +++ b/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-12-complete.md @@ -87,7 +87,7 @@ Offer validation workflows to ensure PRD is ready for implementation: ### 4. Suggest Next Workflows -Execute task `_bmad/bmm/tasks/whats-after.md` with argument `Create PRD`. +Execute task `_bmad/bmm/tasks/bmad-help.md` with argument `Create PRD`. ### 5. Final Completion Confirmation diff --git a/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-13-report-complete.md b/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-13-report-complete.md index 8f8320ad..5b0c4b57 100644 --- a/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-13-report-complete.md +++ b/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-13-report-complete.md @@ -197,7 +197,7 @@ Display: - **IF X (Exit):** - Display: "**Validation Report Saved:** {validationReportPath}" - Display: "**Summary:** {overall status} - {recommendation}" - - Exit and Execute task `_bmad/bmm/tasks/whats-after.md` with argument `Validate PRD`. + - Exit and Execute task `_bmad/bmm/tasks/bmad-help.md` with argument `Validate PRD`. - **IF Any other:** Help user, then redisplay menu diff --git a/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-06-final-assessment.md b/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-06-final-assessment.md index 6fce97e1..2feca5ad 100644 --- a/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-06-final-assessment.md +++ b/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-06-final-assessment.md @@ -115,7 +115,7 @@ The assessment found [number] issues requiring attention. Review the detailed re The implementation readiness workflow is now complete. The report contains all findings and recommendations for the user to consider. -Execute task `_bmad/bmm/tasks/whats-after.md` with argument `implementation readiness`. +Execute task `_bmad/bmm/tasks/bmad-help.md` with argument `implementation readiness`. --- diff --git a/src/bmm/workflows/3-solutioning/create-architecture/steps/step-08-complete.md b/src/bmm/workflows/3-solutioning/create-architecture/steps/step-08-complete.md index 43ed4ce6..22a20d3a 100644 --- a/src/bmm/workflows/3-solutioning/create-architecture/steps/step-08-complete.md +++ b/src/bmm/workflows/3-solutioning/create-architecture/steps/step-08-complete.md @@ -41,7 +41,7 @@ completedAt: '{{current_date}}' ### 3. Next Steps Guidance -Execute task `_bmad/bmm/tasks/whats-after.md` with argument `Create Architecture`. +Execute task `_bmad/bmm/tasks/bmad-help.md` with argument `Create Architecture`. Upon Completion of task output: offer to answer any questions about the Architecture Document. diff --git a/src/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-04-final-validation.md b/src/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-04-final-validation.md index 5688d10f..715821ea 100644 --- a/src/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-04-final-validation.md +++ b/src/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-04-final-validation.md @@ -144,6 +144,6 @@ If all validations pass: When C is selected, the workflow is complete and the epics.md is ready for development. -Execute task `_bmad/bmm/tasks/whats-after.md` with argument `Create Epics and Stories`. +Execute task `_bmad/bmm/tasks/bmad-help.md` with argument `Create Epics and Stories`. Upon Completion of task output: offer to answer any questions about the Epics and Stories. diff --git a/tools/cli/installers/lib/ide/STANDARDIZATION_PLAN.md b/tools/cli/installers/lib/ide/STANDARDIZATION_PLAN.md index 1dd39746..4af15755 100644 --- a/tools/cli/installers/lib/ide/STANDARDIZATION_PLAN.md +++ b/tools/cli/installers/lib/ide/STANDARDIZATION_PLAN.md @@ -51,7 +51,7 @@ Examples: - Agent: bmad:bmm:agents:pm.md - Agent: bmad:core:agents:dev.md - Workflow: bmad:bmm:workflows:correct-course.md -- Task: bmad:bmm:tasks:whats-after.md +- Task: bmad:bmm:tasks:bmad-help.md - Tool: bmad:core:tools:code-review.md - Custom: bmad:custom:agents:fred-commit-poet.md ``` @@ -66,7 +66,7 @@ Format: bmad-{module}-{type}-{name}.md Examples: - Agent: bmad-bmm-agents-pm.md - Workflow: bmad-bmm-workflows-correct-course.md -- Task: bmad-bmm-tasks-whats-after.md +- Task: bmad-bmm-tasks-bmad-help.md - Custom: bmad-custom-agents-fred-commit-poet.md ``` diff --git a/tools/cli/installers/lib/ide/shared/task-tool-command-generator.js b/tools/cli/installers/lib/ide/shared/task-tool-command-generator.js index 2b1bfe9a..de2af163 100644 --- a/tools/cli/installers/lib/ide/shared/task-tool-command-generator.js +++ b/tools/cli/installers/lib/ide/shared/task-tool-command-generator.js @@ -118,7 +118,7 @@ Follow all instructions in the ${type} file exactly as written. /** * Generate task and tool commands using COLON format (for folder-based IDEs) - * Creates flat files like: bmad:bmm:whats-after.md + * Creates flat files like: bmad:bmm:bmad-help.md * * @param {string} projectDir - Project directory * @param {string} bmadDir - BMAD installation directory @@ -166,7 +166,7 @@ Follow all instructions in the ${type} file exactly as written. /** * Generate task and tool commands using DASH format (for flat IDEs) - * Creates flat files like: bmad-bmm-whats-after.md + * Creates flat files like: bmad-bmm-bmad-help.md * * @param {string} projectDir - Project directory * @param {string} bmadDir - BMAD installation directory @@ -214,7 +214,7 @@ Follow all instructions in the ${type} file exactly as written. /** * Write task/tool artifacts using COLON format (for folder-based IDEs) - * Creates flat files like: bmad:bmm:whats-after.md + * Creates flat files like: bmad:bmm:bmad-help.md * * @param {string} baseCommandsDir - Base commands directory for the IDE * @param {Array} artifacts - Task/tool artifacts with relativePath @@ -240,7 +240,7 @@ Follow all instructions in the ${type} file exactly as written. /** * Write task/tool artifacts using DASH format (for flat IDEs) - * Creates flat files like: bmad-bmm-whats-after.md + * Creates flat files like: bmad-bmm-bmad-help.md * * @param {string} baseCommandsDir - Base commands directory for the IDE * @param {Array} artifacts - Task/tool artifacts with relativePath