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

package/src/modules/bmm/workflows/1-analysis/create-product-brief/steps/step-01-init.md

@@ -67,7 +67,7 @@ First, check if the output document already exists:
 
 **Workflow State Detection:**
 
-- Look for file at `{output_folder}/analysis/*product-brief*.md`
+- Look for file `{outputFile}`
 - If exists, read the complete file including frontmatter
 - If not exists, this is a fresh workflow
 
@@ -88,47 +88,35 @@ If no document exists or no `stepsCompleted` in frontmatter:
 
 #### A. Input Document Discovery
 
-Discover and load context documents using smart discovery:
+load context documents using smart discovery. Documents can be in the following locations:
+- {planning_artifacts}/**
+- {output_folder}/**
+- {product_knowledge}/**
+- docs/**
 
-**Research Documents (Priority: 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 for sharded research folder: `{output_folder}/analysis/research/**/*.md`
-2. If folder exists: Load EVERY file in that folder completely
-3. If no folder exists: Try whole file: `{output_folder}/analysis/research/*research*.md`
-4. Add discovered files to `inputDocuments` frontmatter
+Try to discover the following:
+- Brainstorming Reports (`*brainstorming*.md`)
+- 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`)
 
-**Brainstorming Documents (Priority: Sharded → Whole):**
+<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>
 
-1. Check for sharded brainstorming folder: `{output_folder}/analysis/*brainstorm*/**/*.md`
-2. If folder exists: Load useful brainstorming files completely
-3. If no folder exists: Try whole file: `{output_folder}/analysis/*brainstorm*.md`
-4. Add discovered files to `inputDocuments` frontmatter
+**Loading Rules:**
 
-**Project Documentation (Existing Projects):**
-
-1. Look for index file: `{output_folder}/**/index.md`
-2. Load index.md to understand what project files are available
-3. Read available files from index to understand existing project context
-4. Add discovered files to `inputDocuments` frontmatter
+- 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. Create Initial Document
 
 **Document Setup:**
 
-- Copy the template from `{productBriefTemplate}` to `{outputFile}`
-- Initialize frontmatter with proper structure:
-
-```yaml
----
-stepsCompleted: []
-inputDocuments: []
-workflowType: 'product-brief'
-lastStep: 0
-project_name: '{{project_name}}'
-user_name: '{{user_name}}'
-date: '{{date}}'
----
-```
+- Copy the template from `{productBriefTemplate}` to `{outputFile}`, and update the frontmatter fields
 
 #### C. Present Initialization Results
 
@@ -145,6 +133,7 @@ date: '{{date}}'
 - Research: {number of research files loaded or "None found"}
 - Brainstorming: {number of brainstorming files loaded or "None found"}
 - Project docs: {number of project files loaded or "None found"}
+- Project Context: {number of project context files loaded or "None found"}
 
 **Files loaded:** {list of specific file names or "No additional documents found"}
 

package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-01-init.md

@@ -35,7 +35,7 @@ Initialize the UX design workflow by detecting continuation state and setting up
 
 First, check if the output document already exists:
 
-- Look for file at `{planning_artifacts}/ux-design-specification.md`
+- Look for file at `{planning_artifacts}/*ux-design-specification*.md`
 - If exists, read the complete file including frontmatter
 - If not exists, this is a fresh workflow
 
@@ -53,59 +53,34 @@ 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 (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 folder: `{planning_artifacts}/*prd*.md`
-2. If no files: Try main folder: `{output_folder}/*prd*.md`
-3. If no main files: Check for sharded PRD folder: `**/*prd*/**/*.md`
-4. If sharded folder exists: Load EVERY file in that folder completely for UX context
-5. Add discovered files to `inputDocuments` frontmatter
+Try to discover the following:
+- Product Brief (`*brief*.md`)
+- Research Documents (`*prd*.md`)
+- Project Documentation (generally multiple documents might be found for this in the `{product_knowledge}` or `docs` folder.)
+- Project Context (`**/project-context.md`)
 
-**Product Brief (Priority: Analysis → Main → Sharded → Whole):**
-
-1. Check analysis folder: `{planning_artifacts}/*brief*.md`
-2. If no analysis files: Try main folder: `{output_folder}/*brief*.md`
-3. If no main files: Check for sharded brief folder: `**/*brief*/**/*.md`
-4. If sharded folder exists: Load EVERY file in that folder completely
-5. Add discovered files to `inputDocuments` frontmatter
-
-**Research Documents (Priority: Analysis → Main → Sharded → Whole):**
-
-1. Check analysis folder: `{planning_artifacts}/research/*research*.md`
-2. If no analysis files: Try main folder: `{output_folder}/*research*.md`
-3. If no main files: Check for sharded research folder: `{output_folder}/*research*/**/*.md`
-4. Load useful research files completely
-5. Add discovered files to `inputDocuments` frontmatter
-
-**Other Context (Priority: Analysis → Main → Sharded):**
-
-- Epics: `{output_folder}/analysis/*epic*.md` or `{output_folder}/*epic*.md` or `{output_folder}/*epic*/**/*.md`
-- Brainstorming: `{output_folder}/analysis/brainstorming/*brainstorming*.md` or `{output_folder}/*brainstorming*.md`
+<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
+- 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. Create Initial Document
 
 Copy the template from `{installed_path}/ux-design-template.md` to `{planning_artifacts}/ux-design-specification.md`
-Initialize frontmatter with:
-
-```yaml
----
-stepsCompleted: []
-inputDocuments: []
-workflowType: 'ux-design'
-lastStep: 0
-project_name: '{{project_name}}'
-user_name: '{{user_name}}'
-date: '{{date}}'
----
-```
+Initialize frontmatter in the template.
 
 #### C. Complete Initialization and Report
 
@@ -134,7 +109,7 @@ Do you have any other documents you'd like me to include, or shall we continue t
 
 ## NEXT STEP:
 
-After user selects [C] to continue, load `./step-02-discovery.md` to begin the UX discovery phase.
+After user selects [C] to continue, ensure the file `{planning_artifacts}/ux-design-specification.md` has been created and saved, and then load `./step-02-discovery.md` to begin the UX discovery phase.
 
 Remember: Do NOT proceed to step-02 until output file has been updated and user explicitly selects [C] to continue!
 

package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-02-discovery.md

@@ -16,7 +16,7 @@
 - 🎯 Show your analysis before taking any action
 - ⚠️ Present A/P/C menu after generating project understanding content
 - 💾 ONLY save when user chooses C (Continue)
-- 📖 Update frontmatter `stepsCompleted: [1, 2]` before loading next step
+- 📖 Update output file frontmatter, adding this step to the end of the list of stepsCompleted.
 - 🚫 FORBIDDEN to load next step until C is selected
 
 ## COLLABORATION MENUS (A/P/C):

package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-03-core-experience.md

@@ -16,7 +16,7 @@
 - 🎯 Show your analysis before taking any action
 - ⚠️ Present A/P/C menu after generating core experience content
 - 💾 ONLY save when user chooses C (Continue)
-- 📖 Update frontmatter `stepsCompleted: [1, 2, 3]` before loading next step
+- 📖 Update output file frontmatter, adding this step to the end of the list of stepsCompleted.
 - 🚫 FORBIDDEN to load next step until C is selected
 
 ## COLLABORATION MENUS (A/P/C):
@@ -177,7 +177,7 @@ Show the generated core experience content and present choices:
 #### If 'C' (Continue):
 
 - Append the final content to `{planning_artifacts}/ux-design-specification.md`
-- Update frontmatter: `stepsCompleted: [1, 2, 3]`
+- Update frontmatter: append step to end of stepsCompleted array
 - Load `./step-04-emotional-response.md`
 
 ## APPEND TO DOCUMENT:

package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-04-emotional-response.md

@@ -16,7 +16,7 @@
 - 🎯 Show your analysis before taking any action
 - ⚠️ Present A/P/C menu after generating emotional response content
 - 💾 ONLY save when user chooses C (Continue)
-- 📖 Update frontmatter `stepsCompleted: [1, 2, 3, 4]` before loading next step
+- 📖 Update output file frontmatter, adding this step to the end of the list of stepsCompleted.
 - 🚫 FORBIDDEN to load next step until C is selected
 
 ## COLLABORATION MENUS (A/P/C):
@@ -180,7 +180,7 @@ Show the generated emotional response content and present choices:
 #### If 'C' (Continue):
 
 - Append the final content to `{planning_artifacts}/ux-design-specification.md`
-- Update frontmatter: `stepsCompleted: [1, 2, 3, 4]`
+- Update frontmatter: append step to end of stepsCompleted array
 - Load `./step-05-inspiration.md`
 
 ## APPEND TO DOCUMENT:

package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-05-inspiration.md

@@ -16,7 +16,7 @@
 - 🎯 Show your analysis before taking any action
 - ⚠️ Present A/P/C menu after generating inspiration analysis content
 - 💾 ONLY save when user chooses C (Continue)
-- 📖 Update frontmatter `stepsCompleted: [1, 2, 3, 4, 5]` before loading next step
+- 📖 Update output file frontmatter, adding this step to the end of the list of stepsCompleted.
 - 🚫 FORBIDDEN to load next step until C is selected
 
 ## COLLABORATION MENUS (A/P/C):
@@ -195,7 +195,7 @@ Show the generated inspiration analysis content and present choices:
 #### If 'C' (Continue):
 
 - Append the final content to `{planning_artifacts}/ux-design-specification.md`
-- Update frontmatter: `stepsCompleted: [1, 2, 3, 4, 5]`
+- Update frontmatter: append step to end of stepsCompleted array
 - Load and execute`./step-06-design-system.md`
 
 ## APPEND TO DOCUMENT:

package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-06-design-system.md

@@ -16,7 +16,7 @@
 - 🎯 Show your analysis before taking any action
 - ⚠️ Present A/P/C menu after generating design system decision content
 - 💾 ONLY save when user chooses C (Continue)
-- 📖 Update frontmatter `stepsCompleted: [1, 2, 3, 4, 5, 6]` before loading next step
+- 📖 Update output file frontmatter, adding this step to the end of the list of stepsCompleted.
 - 🚫 FORBIDDEN to load next step until C is selected
 
 ## COLLABORATION MENUS (A/P/C):
@@ -213,7 +213,7 @@ Show the generated design system content and present choices:
 #### If 'C' (Continue):
 
 - Append the final content to `{planning_artifacts}/ux-design-specification.md`
-- Update frontmatter: `stepsCompleted: [1, 2, 3, 4, 5, 6]`
+- Update frontmatter: append step to end of stepsCompleted array
 - Load `./step-07-defining-experience.md`
 
 ## APPEND TO DOCUMENT:

package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-07-defining-experience.md

@@ -16,7 +16,7 @@
 - 🎯 Show your analysis before taking any action
 - ⚠️ Present A/P/C menu after generating defining experience content
 - 💾 ONLY save when user chooses C (Continue)
-- 📖 Update frontmatter `stepsCompleted: [1, 2, 3, 4, 5, 6, 7]` before loading next step
+- 📖 Update output file frontmatter, adding this step to the end of the list of stepsCompleted.
 - 🚫 FORBIDDEN to load next step until C is selected
 
 ## COLLABORATION MENUS (A/P/C):
@@ -215,7 +215,7 @@ Show the generated defining experience content and present choices:
 #### If 'C' (Continue):
 
 - Append the final content to `{planning_artifacts}/ux-design-specification.md`
-- Update frontmatter: `stepsCompleted: [1, 2, 3, 4, 5, 6, 7]`
+- Update frontmatter: append step to end of stepsCompleted array
 - Load `./step-08-visual-foundation.md`
 
 ## APPEND TO DOCUMENT:

package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-08-visual-foundation.md

@@ -16,7 +16,7 @@
 - 🎯 Show your analysis before taking any action
 - ⚠️ Present A/P/C menu after generating visual foundation content
 - 💾 ONLY save when user chooses C (Continue)
-- 📖 Update frontmatter `stepsCompleted: [1, 2, 3, 4, 5, 6, 7, 8]` before loading next step
+- 📖 Update output file frontmatter, adding this step to the end of the list of stepsCompleted.
 - 🚫 FORBIDDEN to load next step until C is selected
 
 ## COLLABORATION MENUS (A/P/C):
@@ -185,7 +185,7 @@ Show the generated visual foundation content and present choices:
 #### If 'C' (Continue):
 
 - Append the final content to `{planning_artifacts}/ux-design-specification.md`
-- Update frontmatter: `stepsCompleted: [1, 2, 3, 4, 5, 6, 7, 8]`
+- Update frontmatter: append step to end of stepsCompleted array
 - Load `./step-09-design-directions.md`
 
 ## APPEND TO DOCUMENT:

package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-09-design-directions.md

@@ -16,7 +16,7 @@
 - 🎯 Show your analysis before taking any action
 - ⚠️ Present A/P/C menu after generating design direction content
 - 💾 Generate HTML visualizer for design directions
-- 📖 Update frontmatter `stepsCompleted: [1, 2, 3, 4, 5, 6, 7, 8, 9]` before loading next step
+- 📖 Update output file frontmatter, adding this step to the end of the list of stepsCompleted.
 - 🚫 FORBIDDEN to load next step until C is selected
 
 ## COLLABORATION MENUS (A/P/C):
@@ -65,7 +65,7 @@ Each mockup will show a complete vision for {{project_name}} with all our design
 Generate interactive visual exploration:
 "🎨 Design Direction Mockups Generated!
 
-I'm creating a comprehensive HTML design direction showcase at `{output_folder}/ux-design-directions.html`
+I'm creating a comprehensive HTML design direction showcase at `{planning_artifacts}/ux-design-directions.html`
 
 **What you'll see:**
 
@@ -185,7 +185,7 @@ Show the generated design direction content and present choices:
 #### If 'C' (Continue):
 
 - Append the final content to `{planning_artifacts}/ux-design-specification.md`
-- Update frontmatter: `stepsCompleted: [1, 2, 3, 4, 5, 6, 7, 8, 9]`
+- Update frontmatter: append step to end of stepsCompleted array
 - Load `./step-10-user-journeys.md`
 
 ## APPEND TO DOCUMENT:

package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-10-user-journeys.md

@@ -16,7 +16,7 @@
 - 🎯 Show your analysis before taking any action
 - ⚠️ Present A/P/C menu after generating user journey content
 - 💾 ONLY save when user chooses C (Continue)
-- 📖 Update frontmatter `stepsCompleted: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]` before loading next step
+- 📖 Update output file frontmatter, adding this step to the end of the list of stepsCompleted.
 - 🚫 FORBIDDEN to load next step until C is selected
 
 ## COLLABORATION MENUS (A/P/C):
@@ -203,7 +203,7 @@ Show the generated user journey content and present choices:
 #### If 'C' (Continue):
 
 - Append the final content to `{planning_artifacts}/ux-design-specification.md`
-- Update frontmatter: `stepsCompleted: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]`
+- Update frontmatter: append step to end of stepsCompleted array
 - Load `./step-11-component-strategy.md`
 
 ## APPEND TO DOCUMENT:

package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-11-component-strategy.md

@@ -16,7 +16,7 @@
 - 🎯 Show your analysis before taking any action
 - ⚠️ Present A/P/C menu after generating component strategy content
 - 💾 ONLY save when user chooses C (Continue)
-- 📖 Update frontmatter `stepsCompleted: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11]` before loading next step
+- 📖 Update output file frontmatter, adding this step to the end of the list of stepsCompleted.
 - 🚫 FORBIDDEN to load next step until C is selected
 
 ## COLLABORATION MENUS (A/P/C):
@@ -209,7 +209,7 @@ Show the generated component strategy content and present choices:
 #### If 'C' (Continue):
 
 - Append the final content to `{planning_artifacts}/ux-design-specification.md`
-- Update frontmatter: `stepsCompleted: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11]`
+- Update frontmatter: append step to end of stepsCompleted array
 - Load `./step-12-ux-patterns.md`
 
 ## APPEND TO DOCUMENT:

package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-12-ux-patterns.md

@@ -16,7 +16,7 @@
 - 🎯 Show your analysis before taking any action
 - ⚠️ Present A/P/C menu after generating UX patterns content
 - 💾 ONLY save when user chooses C (Continue)
-- 📖 Update frontmatter `stepsCompleted: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12]` before loading next step
+- 📖 Update output file frontmatter, adding this step to the end of the list of stepsCompleted.
 - 🚫 FORBIDDEN to load next step until C is selected
 
 ## COLLABORATION MENUS (A/P/C):
@@ -198,7 +198,7 @@ Show the generated UX patterns content and present choices:
 #### If 'C' (Continue):
 
 - Append the final content to `{planning_artifacts}/ux-design-specification.md`
-- Update frontmatter: `stepsCompleted: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12]`
+- Update frontmatter: append step to end of stepsCompleted array
 - Load `./step-13-responsive-accessibility.md`
 
 ## APPEND TO DOCUMENT:

package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-13-responsive-accessibility.md

@@ -16,7 +16,7 @@
 - 🎯 Show your analysis before taking any action
 - ⚠️ Present A/P/C menu after generating responsive/accessibility content
 - 💾 ONLY save when user chooses C (Continue)
-- 📖 Update frontmatter `stepsCompleted: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13]` before loading next step
+- 📖 Update output file frontmatter, adding this step to the end of the list of stepsCompleted.
 - 🚫 FORBIDDEN to load next step until C is selected
 
 ## COLLABORATION MENUS (A/P/C):
@@ -225,7 +225,7 @@ Show the generated responsive and accessibility content and present choices:
 #### If 'C' (Continue):
 
 - Append the final content to `{planning_artifacts}/ux-design-specification.md`
-- Update frontmatter: `stepsCompleted: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13]`
+- Update frontmatter: append step to end of stepsCompleted array
 - Load `./step-14-complete.md`
 
 ## APPEND TO DOCUMENT:

package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-14-complete.md

@@ -21,6 +21,7 @@
 ## TERMINATION STEP PROTOCOLS:
 
 - This is a FINAL step - workflow completion required
+- 📖 Update output file frontmatter, adding this step to the end of the list of stepsCompleted to indicate all is finished..
 - Output completion summary and next step guidance
 - Update the main workflow status file with finalized document
 - Suggest potential next workflow steps for the user
@@ -64,8 +65,8 @@ I've successfully collaborated with you to create a comprehensive UX design spec
 
 **Supporting Visual Assets:**
 
-- Color themes visualizer: `{output_folder}/ux-color-themes.html`
-- Design directions mockups: `{output_folder}/ux-design-directions.html`
+- Color themes visualizer: `{planning_artifacts}/ux-color-themes.html`
+- Design directions mockups: `{planning_artifacts}/ux-design-directions.html`
 
 This specification is now ready to guide visual design, implementation, and development."
 
@@ -222,5 +223,5 @@ This UX design workflow is now complete. The specification serves as the foundat
 **Core Deliverables:**
 
 - ✅ UX Design Specification: `{planning_artifacts}/ux-design-specification.md`
-- ✅ Color Themes Visualizer: `{output_folder}/ux-color-themes.html`
-- ✅ Design Directions: `{output_folder}/ux-design-directions.html`
+- ✅ Color Themes Visualizer: `{planning_artifacts}/ux-color-themes.html`
+- ✅ Design Directions: `{planning_artifacts}/ux-design-directions.html`

package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/workflow.md

@@ -37,21 +37,6 @@ Load config from `{project-root}/_bmad/bmm/config.yaml` and resolve:
 - `template_path` = `{installed_path}/ux-design-template.md`
 - `default_output_file` = `{planning_artifacts}/ux-design-specification.md`
 
-### Output Files
-
-- Color themes: `{output_folder}/ux-color-themes.html`
-- Design directions: `{output_folder}/ux-design-directions.html`
-
-### Input Document Discovery
-
-Discover context documents for UX context (Priority: Analysis folder first, then main folder, then sharded):
-
-- PRD: `{planning_artifacts}/*prd*.md` or `{output_folder}/*prd*.md` or `{output_folder}/*prd*/**/*.md`
-- Product brief: `{output_folder}/analysis/*brief*.md` or `{output_folder}/*brief*.md` or `{output_folder}/*brief*/**/*.md`
-- Epics: `{output_folder}/analysis/*epic*.md` or `{output_folder}/*epic*.md` or `{output_folder}/*epic*/**/*.md`
-- Research: `{output_folder}/analysis/research/*research*.md` or `{output_folder}/*research*.md` or `{output_folder}/*research*/**/*.md`
-- Brainstorming: `{output_folder}/analysis/brainstorming/*brainstorming*.md` or `{output_folder}/*brainstorming*.md`
-
 ## EXECUTION
 
 Load and execute `steps/step-01-init.md` to begin the UX design workflow.

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

@@ -1,11 +1,6 @@
 ---
 stepsCompleted: []
 inputDocuments: []
-documentCounts:
-  briefs: 0
-  research: 0
-  brainstorming: 0
-  projectDocs: 0
 workflowType: 'prd'
 lastStep: 0
 ---

package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-01-init.md

@@ -10,7 +10,8 @@ thisStepFile: '{workflow_path}/steps/step-01-init.md'
 nextStepFile: '{workflow_path}/steps/step-02-discovery.md'
 continueStepFile: '{workflow_path}/steps/step-01b-continue.md'
 workflowFile: '{workflow_path}/workflow.md'
-outputFile: '{output_folder}/prd.md'
+outputFile: '{planning_artifacts}/prd.md'
+
 
 # Template References
 prdTemplate: '{workflow_path}/prd-template.md'
@@ -51,7 +52,7 @@ Initialize the PRD workflow by detecting continuation state, discovering input d
 
 - 🎯 Show your analysis of current state before taking any action
 - 💾 Initialize document structure and update frontmatter appropriately
-- 📖 Set up frontmatter `stepsCompleted: [1]` before loading next step
+- Update frontmatter: add this step name to the end of the steps completed array (it should be the first entry in the steps array since this is step 1)
 - 🚫 FORBIDDEN to load next step until user selects 'C' (Continue)
 
 ## CONTEXT BOUNDARIES:
@@ -75,7 +76,7 @@ First, check if the output document already exists:
 
 ### 2. Handle Continuation (If Document Exists)
 
-If the document exists and has frontmatter with `stepsCompleted`:
+If the document exists and has frontmatter with `stepsCompleted` BUT `step-11-complete` is NOT in the list, follow the Continuation Protocol since the document is incomplete:
 
 **Continuation Protocol:**
 
@@ -90,58 +91,28 @@ If no document exists or no `stepsCompleted` in frontmatter:
 
 #### A. Input Document Discovery
 
-Discover and load context documents using smart discovery.
-
-**IMPORTANT: Track document counts as you discover files.**
-
-Initialize counters:
-
-```
-briefCount = 0
-researchCount = 0
-brainstormingCount = 0
-projectDocsCount = 0
-```
-
-**Product Brief (Priority: Analysis → Main → Sharded → Whole):**
-
-1. Check analysis folder: `{output_folder}/analysis/*brief*.md`
-2. If no analysis files: Try main folder: `{output_folder}/*brief*.md`
-3. If no main files: Check for sharded brief folder: `{output_folder}/*brief*/**/*.md`
-4. If sharded folder exists: Load EVERY file in that folder completely
-5. Add discovered files to `inputDocuments` frontmatter
-6. **Update briefCount with number of files found**
+Discover and load context documents using smart discovery. Documents can be in the following locations:
+- {planning_artifacts}/**
+- {output_folder}/**
+- {product_knowledge}/**
+- docs/**
 
-**Research Documents (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 folder: `{output_folder}/analysis/research/*research*.md`
-2. If no analysis files: Try main folder: `{output_folder}/*research*.md`
-3. If no main files: Check for sharded research folder: `{output_folder}/*research*/**/*.md`
-4. Load useful research files completely
-5. Add discovered files to `inputDocuments` frontmatter
-6. **Update researchCount with number of files found**
+Try to discover the following:
+- Product Brief (`*brief*.md`)
+- 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`)
 
-**Brainstorming Documents (Priority: Analysis → Main):**
-
-1. Check analysis folder: `{output_folder}/analysis/brainstorming/*brainstorming*.md`
-2. If no analysis files: Try main folder: `{output_folder}/*brainstorming*.md`
-3. Add discovered files to `inputDocuments` frontmatter
-4. **Update brainstormingCount with number of files found**
-
-**Project Documentation (Existing Projects - Brownfield):**
-
-1. Look for index file: `{output_folder}/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 PRD
-5. Add discovered files to `inputDocuments` frontmatter
-6. **Update projectDocsCount with number of files found (including index.md)**
+<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. Create Initial Document
@@ -149,24 +120,7 @@ projectDocsCount = 0
 **Document Setup:**
 
 - Copy the template from `{prdTemplate}` to `{outputFile}`
-- Initialize frontmatter with proper structure including document counts:
-
-```yaml
----
-stepsCompleted: []
-inputDocuments: []
-documentCounts:
-  briefs: { { briefCount } }
-  research: { { researchCount } }
-  brainstorming: { { brainstormingCount } }
-  projectDocs: { { projectDocsCount } }
-workflowType: 'prd'
-lastStep: 0
-project_name: '{{project_name}}'
-user_name: '{{user_name}}'
-date: '{{date}}'
----
-```
+- Initialize frontmatter with proper structure including inputDocuments array.
 
 #### C. Present Initialization Results
 
@@ -202,7 +156,7 @@ Display menu after setup report:
 
 #### Menu Handling Logic:
 
-- IF C: Update frontmatter with `stepsCompleted: [1]`, then load, read entire file, then execute {nextStepFile}
+- IF C: Update frontmatter with `stepsCompleted: [1]`, then load, read entire {nextStepFile}, then execute {nextStepFile}
 - IF user provides additional files: Load them, update inputDocuments and documentCounts, redisplay report
 - IF user asks questions: Answer and redisplay menu
 
@@ -225,7 +179,6 @@ ONLY WHEN [C continue option] is selected and [frontmatter properly updated with
 - Fresh workflow initialized with template and proper frontmatter
 - Input documents discovered and loaded using sharded-first logic
 - All discovered files tracked in frontmatter `inputDocuments`
-- **Document counts stored in frontmatter `documentCounts`**
 - User clearly informed of brownfield vs greenfield status
 - Menu presented and user input handled correctly
 - Frontmatter updated with `stepsCompleted: [1]` before proceeding

package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-01b-continue.md

@@ -8,7 +8,7 @@ workflow_path: '{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd'
 # File References
 thisStepFile: '{workflow_path}/steps/step-01b-continue.md'
 workflowFile: '{workflow_path}/workflow.md'
-outputFile: '{output_folder}/prd.md'
+outputFile: '{planning_artifacts}/prd.md'
 ---
 
 # Step 1B: Workflow Continuation
@@ -41,7 +41,7 @@ Resume the PRD workflow from where it was left off, ensuring smooth continuation
 ## EXECUTION PROTOCOLS:
 
 - 🎯 Show your analysis of current state before taking action
-- 💾 Keep existing frontmatter `stepsCompleted` values
+- Update frontmatter: add this step name to the end of the steps completed array
 - 📖 Only load documents that were already tracked in `inputDocuments`
 - 🚫 FORBIDDEN to discover new input documents during continuation