bmad-method 6.0.0-alpha.20 → 6.0.0-alpha.21

package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-02-discovery.md

@@ -9,7 +9,7 @@ workflow_path: '{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd'
 thisStepFile: '{workflow_path}/steps/step-02-discovery.md'
 nextStepFile: '{workflow_path}/steps/step-03-success.md'
 workflowFile: '{workflow_path}/workflow.md'
-outputFile: '{output_folder}/prd.md'
+outputFile: '{planning_artifacts}/prd.md'
 
 # Data Files
 projectTypesCSV: '{workflow_path}/project-types.csv'
@@ -64,7 +64,7 @@ This step will generate content and present choices:
 
 - **A (Advanced Elicitation)**: Use discovery protocols to develop deeper insights about the generated content
 - **P (Party Mode)**: Bring multiple perspectives to discuss and improve the generated content
-- **C (Continue)**: Save the content to the document and proceed to next step
+- **C (Continue)**: Append and save the content to the `{outputFile}` and proceed to next step
 
 ## PROTOCOL INTEGRATION:
 
@@ -373,7 +373,7 @@ Show the generated content to the user and present:
 #### IF C (Continue):
 
 - Append the final content to `{outputFile}`
-- Update frontmatter: `stepsCompleted: [1, 2]`
+- Update frontmatter: add this step name to the end of the steps completed array
 - Load `{nextStepFile}`
 
 ## CRITICAL STEP COMPLETION NOTE

package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-03-success.md

@@ -9,7 +9,7 @@ workflow_path: '{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd'
 thisStepFile: '{workflow_path}/steps/step-03-success.md'
 nextStepFile: '{workflow_path}/steps/step-04-journeys.md'
 workflowFile: '{workflow_path}/workflow.md'
-outputFile: '{output_folder}/prd.md'
+outputFile: '{planning_artifacts}/prd.md'
 
 # Task References
 advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
@@ -244,8 +244,8 @@ Show the generated content and present choices:
 
 #### If 'C' (Continue):
 
-- Append the final content to `{output_folder}/prd.md`
-- Update frontmatter: `stepsCompleted: [1, 2, 3]`
+- Append the final content to `{outputFile}`
+- Update frontmatter: add this step to the end of the steps completed array
 - Load `./step-04-journeys.md`
 
 ## APPEND TO DOCUMENT:

package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-04-journeys.md

@@ -9,7 +9,7 @@ workflow_path: '{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd'
 thisStepFile: '{workflow_path}/steps/step-04-journeys.md'
 nextStepFile: '{workflow_path}/steps/step-05-domain.md'
 workflowFile: '{workflow_path}/workflow.md'
-outputFile: '{output_folder}/prd.md'
+outputFile: '{planning_artifacts}/prd.md'
 
 # Task References
 advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
@@ -238,8 +238,8 @@ Show the generated journey content and present choices:
 
 #### If 'C' (Continue):
 
-- Append the final content to `{output_folder}/prd.md`
-- Update frontmatter: `stepsCompleted: [1, 2, 3, 4]`
+- Append the final content to `{outputFile}`
+- Update frontmatter: add this step name to the end of the steps completed array
 - Load `{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd/steps/step-05-domain.md` (or determine if step is optional based on domain complexity)
 
 ## APPEND TO DOCUMENT:

package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-05-domain.md

@@ -9,7 +9,7 @@ workflow_path: '{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd'
 thisStepFile: '{workflow_path}/steps/step-05-domain.md'
 nextStepFile: '{workflow_path}/steps/step-06-innovation.md'
 workflowFile: '{workflow_path}/workflow.md'
-outputFile: '{output_folder}/prd.md'
+outputFile: '{planning_artifacts}/prd.md'
 
 # Data Files
 domainComplexityCSV: '{workflow_path}/domain-complexity.csv'
@@ -223,8 +223,8 @@ Show the generated domain content and present choices:
 
 #### If 'C' (Continue):
 
-- Append the content to `{output_folder}/prd.md`
-- Update frontmatter: `stepsCompleted: [1, 2, 3, 4, 5]`
+- Append the content to `{outputFile}`
+- Update frontmatter: add this step name to the end of the steps completed array
 - Load `{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd/steps/step-06-innovation.md`
 
 ## APPEND TO DOCUMENT:

package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-06-innovation.md

@@ -9,7 +9,7 @@ workflow_path: '{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd'
 thisStepFile: '{workflow_path}/steps/step-06-innovation.md'
 nextStepFile: '{workflow_path}/steps/step-07-project-type.md'
 workflowFile: '{workflow_path}/workflow.md'
-outputFile: '{output_folder}/prd.md'
+outputFile: '{planning_artifacts}/prd.md'
 
 # Data Files
 projectTypesCSV: '{workflow_path}/project-types.csv'
@@ -202,8 +202,8 @@ Show the generated innovation content and present choices:
 
 #### If 'C' (Continue):
 
-- Append the final content to `{output_folder}/prd.md`
-- Update frontmatter: `stepsCompleted: [1, 2, 3, 4, 5, 6]`
+- Append the final content to `{outputFile}`
+- Update frontmatter: add this step name to the end of the steps completed array
 - Load `{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd/steps/step-07-project-type.md`
 
 ## NO INNOVATION DETECTED:

package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-07-project-type.md

@@ -9,7 +9,7 @@ workflow_path: '{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd'
 thisStepFile: '{workflow_path}/steps/step-07-project-type.md'
 nextStepFile: '{workflow_path}/steps/step-08-scoping.md'
 workflowFile: '{workflow_path}/workflow.md'
-outputFile: '{output_folder}/prd.md'
+outputFile: '{planning_artifacts}/prd.md'
 
 # Data Files
 projectTypesCSV: '{workflow_path}/project-types.csv'
@@ -198,8 +198,8 @@ Show the generated project-type content and present choices:
 
 #### If 'C' (Continue):
 
-- Append the final content to `{output_folder}/prd.md`
-- Update frontmatter: `stepsCompleted: [1, 2, 3, 4, 5, 6, 7]`
+- Append the final content to `{outputFile}`
+- Update frontmatter: add this step name to the end of the steps completed array
 - Load `{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd/steps/step-08-scoping.md`
 
 ## APPEND TO DOCUMENT:

package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-08-scoping.md

@@ -9,7 +9,7 @@ workflow_path: '{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd'
 thisStepFile: '{workflow_path}/steps/step-08-scoping.md'
 nextStepFile: '{workflow_path}/steps/step-09-functional.md'
 workflowFile: '{workflow_path}/workflow.md'
-outputFile: '{output_folder}/prd.md'
+outputFile: '{planning_artifacts}/prd.md'
 
 # Task References
 advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
@@ -259,8 +259,8 @@ Show the scoping decisions and present choices:
 
 #### If 'C' (Continue):
 
-- Append the final content to `{output_folder}/prd.md`
-- Update frontmatter: `stepsCompleted: [1, 2, 3, 4, 5, 6, 7, 8]`
+- Append the final content to `{outputFile}`
+- Update frontmatter: add this step name to the end of the steps completed array
 - Load `./step-09-functional.md`
 
 ## APPEND TO DOCUMENT:

package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-09-functional.md

@@ -9,7 +9,7 @@ workflow_path: '{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd'
 thisStepFile: '{workflow_path}/steps/step-09-functional.md'
 nextStepFile: '{workflow_path}/steps/step-10-nonfunctional.md'
 workflowFile: '{workflow_path}/workflow.md'
-outputFile: '{output_folder}/prd.md'
+outputFile: '{planning_artifacts}/prd.md'
 
 # Task References
 advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
@@ -225,8 +225,8 @@ Show the generated functional requirements and present choices:
 
 #### If 'C' (Continue):
 
-- Append the final content to `{output_folder}/prd.md`
-- Update frontmatter: `stepsCompleted: [1, 2, 3, 4, 5, 6, 7, 8, 9]`
+- Append the final content to `{outputFile}`
+- Update frontmatter: add this step name to the end of the steps completed array
 - Load `{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd/steps/step-10-nonfunctional.md`
 
 ## APPEND TO DOCUMENT:

package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-10-nonfunctional.md

@@ -9,7 +9,7 @@ workflow_path: '{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd'
 thisStepFile: '{workflow_path}/steps/step-10-nonfunctional.md'
 nextStepFile: '{workflow_path}/steps/step-11-complete.md'
 workflowFile: '{workflow_path}/workflow.md'
-outputFile: '{output_folder}/prd.md'
+outputFile: '{planning_artifacts}/prd.md'
 
 # Task References
 advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
@@ -225,8 +225,8 @@ Show the generated NFR content and present choices:
 
 #### If 'C' (Continue):
 
-- Append the final content to `{output_folder}/prd.md`
-- Update frontmatter: `stepsCompleted: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]`
+- Append the final content to `{outputFile}`
+- Update frontmatter: add this step name to the end of the steps completed array
 - Load `{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd/steps/step-11-complete.md`
 
 ## APPEND TO DOCUMENT:

package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-11-complete.md

@@ -8,7 +8,7 @@ workflow_path: '{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd'
 # File References
 thisStepFile: '{workflow_path}/steps/step-11-complete.md'
 workflowFile: '{workflow_path}/workflow.md'
-outputFile: '{output_folder}/prd.md'
+outputFile: '{planning_artifacts}/prd.md'
 ---
 
 # Step 11: Workflow Completion
@@ -72,13 +72,13 @@ I've successfully collaborated with you to create a comprehensive Product Requir
 - ✅ Comprehensive Functional Requirements (capability contract)
 - ✅ Non-Functional Requirements for quality attributes
 
-**The complete PRD is now available at:** `{output_folder}/prd.md`
+**The complete PRD is now available at:** `{outputFile}`
 
 This document is now ready to guide UX design, technical architecture, and development planning."
 
 ### 2. Workflow Status Update
 
-Update the main workflow status file:
+Update the main workflow status file if there is one:
 
 - Load `{status_file}` from workflow configuration (if exists)
 - Update workflow_status["prd"] = "{default_output_file}"
@@ -109,7 +109,6 @@ Provide guidance on logical next workflows:
 
 - UX design and architecture can happen in parallel
 - Epics/stories are richer when created after UX/architecture
-- Consider your team's capacity and priorities
 
 **What would be most valuable to tackle next?**
 
@@ -133,24 +132,8 @@ Perform final validation of the PRD:
 
 ### 5. Final Completion Confirmation
 
-Confirm completion with user:
-"**Your PRD for {{project_name}} is now complete and ready for the next phase!**
-
-The document contains everything needed to guide:
-
-- UX/UI design decisions
-- Technical architecture planning
-- Development prioritization and sprint planning
-
-**Ready to continue with:**
-
-- UX design workflow?
-- Architecture workflow?
-- Epic and story creation?
-
-**Or would you like to review the complete PRD first?**
-
-[Workflow Complete]"
+- Confirm completion with user and summarize what you have done.
+- Update frontmatter: add this final step name to the end of the steps completed array.
 
 ## SUCCESS METRICS:
 
@@ -195,27 +178,6 @@ The document contains everything needed to guide:
 - [ ] Workflow status file updated
 - [ ] Next steps clearly communicated
 
-## NEXT STEPS GUIDANCE:
-
-**Immediate Options:**
-
-1. **UX Design** - If product has UI components
-2. **Technical Architecture** - System design and technology choices
-3. **Epic Creation** - Break down FRs into implementable stories
-4. **Review** - Validate PRD with stakeholders before proceeding
-
-**Recommended Sequence:**
-For products with UI: UX → Architecture → Epics
-For API/backend products: Architecture → Epics
-Consider team capacity and timeline constraints
-
-## WORKFLOW FINALIZATION:
-
-- Set `lastStep = 11` in document frontmatter
-- Update workflow status file with completion timestamp
-- Provide completion summary to user
-- Do NOT load any additional steps
-
 ## FINAL REMINDER:
 
 This workflow is now complete. The PRD serves as the foundation for all subsequent product development activities. All design, architecture, and development work should trace back to the requirements and vision documented in this PRD.

package/src/modules/bmm/workflows/2-plan-workflows/prd/workflow.md

@@ -52,7 +52,7 @@ This uses **step-file architecture** for disciplined execution:
 
 Load and read full config from {main_config} and resolve:
 
-- `project_name`, `output_folder`, `user_name`
+- `project_name`, `output_folder`, `planning_artifacts`, `user_name`
 - `communication_language`, `document_output_language`, `user_skill_level`
 - `date` as system-generated current datetime
 

package/src/modules/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-01-document-discovery.md

@@ -68,23 +68,23 @@ Search for each document type using these patterns:
 
 #### A. PRD Documents
 
-- Whole: `{output_folder}/*prd*.md`
-- Sharded: `{output_folder}/*prd*/index.md` and related files
+- Whole: `{planning_artifacts}/*prd*.md`
+- Sharded: `{planning_artifacts}/*prd*/index.md` and related files
 
 #### B. Architecture Documents
 
-- Whole: `{output_folder}/*architecture*.md`
-- Sharded: `{output_folder}/*architecture*/index.md` and related files
+- Whole: `{planning_artifacts}/*architecture*.md`
+- Sharded: `{planning_artifacts}/*architecture*/index.md` and related files
 
 #### C. Epics & Stories Documents
 
-- Whole: `{output_folder}/*epic*.md`
-- Sharded: `{output_folder}/*epic*/index.md` and related files
+- Whole: `{planning_artifacts}/*epic*.md`
+- Sharded: `{planning_artifacts}/*epic*/index.md` and related files
 
 #### D. UX Design Documents
 
-- Whole: `{output_folder}/*ux*.md`
-- Sharded: `{output_folder}/*ux*/index.md` and related files
+- Whole: `{planning_artifacts}/*ux*.md`
+- Sharded: `{planning_artifacts}/*ux*/index.md` and related files
 
 ### 3. Organize Findings
 

package/src/modules/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-02-prd-analysis.md

@@ -10,7 +10,7 @@ thisStepFile: '{workflow_path}/steps/step-02-prd-analysis.md'
 nextStepFile: '{workflow_path}/steps/step-03-epic-coverage-validation.md'
 workflowFile: '{workflow_path}/workflow.md'
 outputFile: '{planning_artifacts}/implementation-readiness-report-{{date}}.md'
-epicsFile: '{output_folder}/*epic*.md' # Will be resolved to actual file
+epicsFile: '{planning_artifacts}/*epic*.md' # Will be resolved to actual file
 ---
 
 # Step 2: PRD Analysis

package/src/modules/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-04-ux-alignment.md

@@ -64,8 +64,8 @@ I will:
 
 Search patterns:
 
-- `{output_folder}/*ux*.md` (whole document)
-- `{output_folder}/*ux*/index.md` (sharded)
+- `{planning_artifacts}/*ux*.md` (whole document)
+- `{planning_artifacts}/*ux*/index.md` (sharded)
 - Look for UI-related terms in other documents
 
 ### 3. If UX Document Exists

package/src/modules/bmm/workflows/3-solutioning/create-architecture/steps/step-01-init.md

@@ -36,7 +36,7 @@ Initialize the Architecture workflow by detecting continuation state, discoverin
 
 First, check if the output document already exists:
 
-- Look for existing {output_folder}||{planning_artifacts} architecture.md or \*\*/architecture/
+- Look for existing {planning_artifacts}/`*architecture*.md`
 - If exists, read the complete file(s) including frontmatter
 - If not exists, this is a fresh workflow
 
@@ -54,58 +54,30 @@ If no document exists or no `stepsCompleted` in frontmatter:
 
 #### A. Input Document Discovery
 
-Discover and load context documents using smart discovery:
+Discover and load context documents using smart discovery. Documents can be in the following locations:
+- {planning_artifacts}/**
+- {output_folder}/**
+- {product_knowledge}/**
+- docs/**
 
-**PRD Document (Priority: Analysis → Main → Sharded → Whole):**
+Also - when searching - documents can be a single markdown file, or a folder with an index and multiple files. For Example, if searching for `*foo*.md` and not found, also search for a folder called *foo*/index.md (which indicates sharded content)
 
-1. Check analysis folders: {output_folder} and {planning_artifacts} for a `*prd*.md`
-2. If no main files: Check for sharded PRD folder: `**/*prd*/**/*.md`
-3. If sharded folder exists: Load EVERY file in that folder completely
-4. Add discovered files to `inputDocuments` frontmatter
+Try to discover the following:
+- Product Brief (`*brief*.md`)
+- Product Requirements Document (`*prd*.md`)
+- UX Design (`*ux-design*.md`) and other
+- Research Documents (`*research*.md`)
+- Project Documentation (generally multiple documents might be found for this in the `{product_knowledge}` or `docs` folder.)
+- Project Context (`**/project-context.md`)
 
-**Epics/Stories Document (Priority: Analysis → Main → Sharded → Whole):**
-
-1. Check folders: {output_folder} and {planning_artifacts} for a `*epic*.md`
-2. If no analysis files: Try main folder: `{output_folder}/*epic*.md`
-3. If no main files: Check for sharded epics folder: `{output_folder}/*epic*/**/*.md`
-4. If sharded folder exists: Load EVERY file in that folder completely
-5. Add discovered files to `inputDocuments` frontmatter
-
-**UX Design Specification (Priority: Analysis → Main → Sharded → Whole):**
-
-1. Check folders: {output_folder} and {planning_artifacts} for a `*ux*.md`
-2. If no main files: Check for sharded UX folder: `{output_folder}/*ux*/**/*.md`
-3. If sharded folder exists: Load EVERY file in that folder completely
-4. Add discovered files to `inputDocuments` frontmatter
-
-**Research Documents (Priority: Analysis → Main):**
-
-1. Check folders {output_folder} and {planning_artifacts} for `/research/*research*.md`
-2. If no files: Try folder: `{output_folder}/*research*.md`
-3. Add discovered files to `inputDocuments` frontmatter
-
-**Project Documentation (Existing Projects):**
-
-1. Look for index file: `{project_knowledge}/index.md`
-2. CRITICAL: Load index.md to understand what project files are available
-3. Read available files from index to understand existing project context
-4. This provides essential context for extending existing project with new architecture
-5. Add discovered files to `inputDocuments` frontmatter
-6. IF no index.md, ask user which files from the folder to include
-
-**Project Context Rules (Critical for AI Agents):**
-
-1. Check for project context file: `**/project-context.md`
-2. If exists: Load COMPLETE file contents - this contains critical rules for AI agents
-3. Add to frontmatter `hasProjectContext: true` and track file path
-4. Report to user: "Found existing project context with {number_of_rules} agent rules"
-5. This file contains language-specific patterns, testing rules, and implementation guidelines that must be followed
+<critical>Confirm what you have found with the user, along with asking if the user wants to provide anything else. Only after this confirmation will you proceed to follow the loading rules</critical>
 
 **Loading Rules:**
 
-- Load ALL discovered files completely (no offset/limit)
-- For sharded folders, load ALL files to get complete picture
-- For existing projects, use index.md as guide to what's relevant
+- Load ALL discovered files completely that the user confirmed or provided (no offset/limit)
+- If there is a project context, whatever is relevant should try to be biased in the remainder of this whole workflow process
+- For sharded folders, load ALL files to get complete picture, using the index first to potentially know the potential of each document
+- index.md is a guide to what's relevant whenever available
 - Track all successfully loaded files in frontmatter `inputDocuments` array
 
 #### B. Validate Required Inputs
@@ -117,13 +89,13 @@ Before proceeding, verify we have the essential inputs:
 - If no PRD found: "Architecture requires a PRD to work from. Please run the PRD workflow first or provide the PRD file path."
 - Do NOT proceed without PRD
 
-**Other Inputs:**
+**Other Input that might exist:**
 
-- UX Spec: "Provides UI/UX architectural requirements" (Optional)
+- UX Spec: "Provides UI/UX architectural requirements"
 
 #### C. Create Initial Document
 
-Copy the template from `{installed_path}/architecture-decision-template.md` to `{output_folder}/architecture.md`
+Copy the template from `{installed_path}/architecture-decision-template.md` to `{planning_artifacts}/architecture.md`
 
 #### D. Complete Initialization and Report
 
@@ -131,7 +103,7 @@ Complete setup and report to user:
 
 **Document Setup:**
 
-- Created: `{output_folder}/architecture.md` from template
+- Created: `{planning_artifacts}/architecture.md` from template
 - Initialized frontmatter with workflow state
 
 **Input Documents Discovered:**
@@ -141,7 +113,6 @@ Report what was found:
 **Documents Found:**
 
 - PRD: {number of PRD files loaded or "None found - REQUIRED"}
-- Epics/Stories: {number of epic files loaded or "None found"}
 - UX Design: {number of UX files loaded or "None found"}
 - Research: {number of research files loaded or "None found"}
 - Project docs: {number of project files loaded or "None found"}
@@ -177,6 +148,6 @@ Ready to begin architectural decision making. Do you have any other documents yo
 
 ## NEXT STEP:
 
-After user selects [C] to continue, load `./step-02-context.md` to analyze the project context and begin architectural decision making.
+After user selects [C] to continue, only after ensuring all the template output has been created, then load `./step-02-context.md` to analyze the project context and begin architectural decision making.
 
 Remember: Do NOT proceed to step-02 until user explicitly selects [C] from the menu and setup is confirmed!

package/src/modules/bmm/workflows/3-solutioning/create-architecture/steps/step-02-context.md

@@ -185,7 +185,7 @@ Show the generated content and present choices:
 
 #### If 'C' (Continue):
 
-- Append the final content to `{output_folder}/architecture.md`
+- Append the final content to `{planning_artifacts}/architecture.md`
 - Update frontmatter: `stepsCompleted: [1, 2]`
 - Load `./step-03-starter.md`
 

package/src/modules/bmm/workflows/3-solutioning/create-architecture/steps/step-03-starter.md

@@ -292,7 +292,7 @@ Show the generated content and present choices:
 
 #### If 'C' (Continue):
 
-- Append the final content to `{output_folder}/architecture.md`
+- Append the final content to `{planning_artifacts}/architecture.md`
 - Update frontmatter: `stepsCompleted: [1, 2, 3]`
 - Load `./step-04-decisions.md`
 

package/src/modules/bmm/workflows/3-solutioning/create-architecture/steps/step-04-decisions.md

@@ -279,7 +279,7 @@ Show the generated decisions content and present choices:
 
 #### If 'C' (Continue):
 
-- Append the final content to `{output_folder}/architecture.md`
+- Append the final content to `{planning_artifacts}/architecture.md`
 - Update frontmatter: `stepsCompleted: [1, 2, 3, 4]`
 - Load `./step-05-patterns.md`
 

package/src/modules/bmm/workflows/3-solutioning/create-architecture/steps/step-05-patterns.md

@@ -320,7 +320,7 @@ Show the generated patterns content and present choices:
 
 #### If 'C' (Continue):
 
-- Append the final content to `{output_folder}/architecture.md`
+- Append the final content to `{planning_artifacts}/architecture.md`
 - Update frontmatter: `stepsCompleted: [1, 2, 3, 4, 5]`
 - Load `./step-06-structure.md`
 

package/src/modules/bmm/workflows/3-solutioning/create-architecture/steps/step-06-structure.md

@@ -340,7 +340,7 @@ Show the generated project structure content and present choices:
 
 #### If 'C' (Continue):
 
-- Append the final content to `{output_folder}/architecture.md`
+- Append the final content to `{planning_artifacts}/architecture.md`
 - Update frontmatter: `stepsCompleted: [1, 2, 3, 4, 5, 6]`
 - Load `./step-07-validation.md`
 

package/src/modules/bmm/workflows/3-solutioning/create-architecture/steps/step-07-validation.md

@@ -320,7 +320,7 @@ Show the validation results and present choices:
 
 #### If 'C' (Continue):
 
-- Append the final content to `{output_folder}/architecture.md`
+- Append the final content to `{planning_artifacts}/architecture.md`
 - Update frontmatter: `stepsCompleted: [1, 2, 3, 4, 5, 6, 7]`
 - Load `./step-08-complete.md`
 

package/src/modules/bmm/workflows/3-solutioning/create-architecture/steps/step-08-complete.md

@@ -116,7 +116,7 @@ Provide specific next steps for implementation:
 
 **Immediate Next Steps:**
 
-1. **Review the complete architecture document** at `{output_folder}/architecture.md`
+1. **Review the complete architecture document** at `{planning_artifacts}/architecture.md`
 2. **Begin with project initialization** using the starter template command documented
 3. **Create first implementation story** for project setup
 4. **Start implementing user stories** following the architectural decisions
@@ -151,7 +151,7 @@ Prepare the final content to append to the document:
 **Architecture Decision Workflow:** COMPLETED ✅
 **Total Steps Completed:** 8
 **Date Completed:** {{current_date}}
-**Document Location:** {output_folder}/architecture.md
+**Document Location:** {planning_artifacts}/architecture.md
 
 ### Final Architecture Deliverables
 
@@ -243,15 +243,15 @@ The chosen starter template and architectural patterns provide a production-read
 
 **Save Final Document:**
 
-- Ensure all content is properly appended to `{output_folder}/architecture.md`
+- Ensure all content is properly appended to `{planning_artifacts}/architecture.md`
 - Update frontmatter with completion status
 - Verify document is complete and coherent
 
 **Workflow Status Update:**
 If not in standalone mode, update workflow status:
 
-- Load `{output_folder}/bmm-workflow-status.yaml`
-- Update workflow_status["create-architecture"] = "{output_folder}/architecture.md"
+- Load `{planning_artifacts}/bmm-workflow-status.yaml`
+- Update workflow_status["create-architecture"] = "{planning_artifacts}/architecture.md"
 - Save file with all structure and comments preserved
 
 ### 6. Present Completion to User
@@ -268,7 +268,7 @@ Your architecture for {{project_name}} is comprehensive, validated, and ready fo
 - Implementation guidance for the development phase
 
 **📍 Where to find it:**
-`{output_folder}/architecture.md`
+`{planning_artifacts}/architecture.md`
 
 **🚀 What's next:**
 

package/src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-01-validate-prerequisites.md

@@ -94,7 +94,7 @@ Before proceeding, Ask the user if there are any other documents, or if what you
 
 ### 3. Extract Functional Requirements (FRs)
 
-From the PRD document (full or sharded), extract ALL functional requirements:
+From the PRD document (full or sharded), read then entire document and extract ALL functional requirements:
 
 **Extraction Method:**
 

package/src/modules/bmm/workflows/4-implementation/create-story/workflow.yaml

@@ -22,7 +22,7 @@ variables:
   sprint_status: "{implementation_artifacts}/sprint-status.yaml || {output_folder}/sprint-status.yaml" # Primary source for story tracking
   epics_file: "{output_folder}/epics.md" # Enhanced epics+stories with BDD and source hints
   prd_file: "{output_folder}/PRD.md" # Fallback for requirements (if not in epics file)
-  architecture_file: "{output_folder}/architecture.md" # Fallback for constraints (if not in epics file)
+  architecture_file: "{planning_artifacts}/architecture.md" # Fallback for constraints (if not in epics file)
   ux_file: "{output_folder}/ux.md" # Fallback for UX requirements (if not in epics file)
   story_title: "" # Will be elicited if not derivable
 

package/src/modules/cis/agents/brainstorming-coach.agent.yaml

@@ -15,15 +15,6 @@ agent:
     principles: Psychological safety unlocks breakthroughs. Wild ideas today become innovations tomorrow. Humor and play are serious innovation tools.
 
   menu:
-    - trigger: brainstorm
+    - trigger: BS or fuzzy match on brainstorm
       workflow: "{project-root}/_bmad/core/workflows/brainstorming/workflow.yaml"
-      description: Guide me through Brainstorming any topic
-
-    - trigger: party-mode
-      exec: "{project-root}/_bmad/core/workflows/party-mode/workflow.md"
-      description: Consult with other expert agents from the party
-
-    - trigger: advanced-elicitation
-      exec: "{project-root}/_bmad/core/tasks/advanced-elicitation.xml"
-      description: Advanced elicitation techniques to challenge the LLM to get better results
-      web-only: true
+      description: "[BS] Guide me through Brainstorming any topic"

package/src/modules/cis/agents/creative-problem-solver.agent.yaml

@@ -15,15 +15,6 @@ agent:
     principles: Every problem is a system revealing weaknesses. Hunt for root causes relentlessly. The right question beats a fast answer.
 
   menu:
-    - trigger: solve
+    - trigger: PS or fuzzy match on problem-solving
       workflow: "{project-root}/_bmad/cis/workflows/problem-solving/workflow.yaml"
-      description: Apply systematic problem-solving methodologies
-
-    - trigger: party-mode
-      exec: "{project-root}/_bmad/core/workflows/party-mode/workflow.md"
-      description: Consult with other expert agents from the party
-
-    - trigger: advanced-elicitation
-      exec: "{project-root}/_bmad/core/tasks/advanced-elicitation.xml"
-      description: Advanced elicitation techniques to challenge the LLM to get better results
-      web-only: true
+      description: "[PS] Apply systematic problem-solving methodologies"