bmad-method 6.0.0-alpha.1 → 6.0.0-alpha.11

package/src/modules/bmm/workflows/diagrams/create-flowchart/instructions.md

@@ -0,0 +1,241 @@
+# Create Flowchart - Workflow Instructions
+
+```xml
+<critical>The workflow execution engine is governed by: {project_root}/{bmad_folder}/core/tasks/workflow.xml</critical>
+<critical>You MUST have already loaded and processed: {installed_path}/workflow.yaml</critical>
+<critical>This workflow creates a flowchart visualization in Excalidraw format for processes, pipelines, or logic flows.</critical>
+
+<workflow>
+
+  <step n="0" goal="Contextual Analysis (Smart Elicitation)">
+    <critical>Before asking any questions, analyze what the user has already told you</critical>
+
+    <action>Review the user's initial request and conversation history</action>
+    <action>Extract any mentioned: flowchart type, complexity, decision points, save location</action>
+
+    <check if="ALL requirements are clear from context">
+      <action>Summarize your understanding</action>
+      <action>Skip directly to Step 4 (Plan Flowchart Layout)</action>
+    </check>
+
+    <check if="SOME requirements are clear">
+      <action>Note what you already know</action>
+      <action>Only ask about missing information in Step 1</action>
+    </check>
+
+    <check if="requirements are unclear or minimal">
+      <action>Proceed with full elicitation in Step 1</action>
+    </check>
+  </step>
+
+  <step n="1" goal="Gather Requirements" elicit="true">
+    <action>Ask Question 1: "What type of process flow do you need to visualize?"</action>
+    <action>Present numbered options:
+      1. Business Process Flow - Document business workflows, approval processes, or operational procedures
+      2. Algorithm/Logic Flow - Visualize code logic, decision trees, or computational processes
+      3. User Journey Flow - Map user interactions, navigation paths, or experience flows
+      4. Data Processing Pipeline - Show data transformation, ETL processes, or processing stages
+      5. Other - Describe your specific flowchart needs
+    </action>
+    <action>WAIT for user selection (1-5)</action>
+
+    <action>Ask Question 2: "How many main steps are in this flow?"</action>
+    <action>Present numbered options:
+      1. Simple (3-5 steps) - Quick process with few decision points
+      2. Medium (6-10 steps) - Standard workflow with some branching
+      3. Complex (11-20 steps) - Detailed process with multiple decision points
+      4. Very Complex (20+ steps) - Comprehensive workflow requiring careful layout
+    </action>
+    <action>WAIT for user selection (1-4)</action>
+    <action>Store selection in {{complexity}}</action>
+
+    <action>Ask Question 3: "Does your flow include decision points (yes/no branches)?"</action>
+    <action>Present numbered options:
+      1. No decisions - Linear flow from start to end
+      2. Few decisions (1-2) - Simple branching with yes/no paths
+      3. Multiple decisions (3-5) - Several conditional branches
+      4. Complex decisions (6+) - Extensive branching logic
+    </action>
+    <action>WAIT for user selection (1-4)</action>
+    <action>Store selection in {{decision_points}}</action>
+
+    <action>Ask Question 4: "Where should the flowchart be saved?"</action>
+    <action>Present numbered options:
+      1. Default location - docs/flowcharts/[auto-generated-name].excalidraw
+      2. Custom path - Specify your own file path
+      3. Project root - Save in main project directory
+      4. Specific folder - Choose from existing folders
+    </action>
+    <action>WAIT for user selection (1-4)</action>
+    <check if="selection is 2 or 4">
+      <action>Ask for specific path</action>
+      <action>WAIT for user input</action>
+    </check>
+    <action>Store final path in {{default_output_file}}</action>
+  </step>
+
+  <step n="2" goal="Check for Existing Theme" elicit="true">
+    <action>Check if theme.json exists at output location</action>
+    <check if="theme.json exists">
+      <action>Ask: "Found existing theme. Use it? (yes/no)"</action>
+      <action>WAIT for user response</action>
+      <check if="user says yes">
+        <action>Load and use existing theme</action>
+        <action>Skip to Step 4</action>
+      </check>
+      <check if="user says no">
+        <action>Proceed to Step 3</action>
+      </check>
+    </check>
+    <check if="theme.json does not exist">
+      <action>Proceed to Step 3</action>
+    </check>
+  </step>
+
+  <step n="3" goal="Create Theme" elicit="true">
+    <action>Ask: "Let's create a theme for your flowchart. Choose a color scheme:"</action>
+    <action>Present numbered options:
+      1. Professional Blue
+         - Primary Fill: #e3f2fd (light blue)
+         - Accent/Border: #1976d2 (blue)
+         - Decision: #fff3e0 (light orange)
+         - Text: #1e1e1e (dark gray)
+
+      2. Success Green
+         - Primary Fill: #e8f5e9 (light green)
+         - Accent/Border: #388e3c (green)
+         - Decision: #fff9c4 (light yellow)
+         - Text: #1e1e1e (dark gray)
+
+      3. Neutral Gray
+         - Primary Fill: #f5f5f5 (light gray)
+         - Accent/Border: #616161 (gray)
+         - Decision: #e0e0e0 (medium gray)
+         - Text: #1e1e1e (dark gray)
+
+      4. Warm Orange
+         - Primary Fill: #fff3e0 (light orange)
+         - Accent/Border: #f57c00 (orange)
+         - Decision: #ffe0b2 (peach)
+         - Text: #1e1e1e (dark gray)
+
+      5. Custom Colors - Define your own color palette
+    </action>
+    <action>WAIT for user selection (1-5)</action>
+    <action>Store selection in {{theme_choice}}</action>
+
+    <check if="selection is 5 (Custom)">
+      <action>Ask: "Primary fill color (hex code)?"</action>
+      <action>WAIT for user input</action>
+      <action>Store in {{custom_colors.primary_fill}}</action>
+      <action>Ask: "Accent/border color (hex code)?"</action>
+      <action>WAIT for user input</action>
+      <action>Store in {{custom_colors.accent}}</action>
+      <action>Ask: "Decision color (hex code)?"</action>
+      <action>WAIT for user input</action>
+      <action>Store in {{custom_colors.decision}}</action>
+    </check>
+
+    <action>Create theme.json with selected colors</action>
+    <action>Show theme preview with all colors</action>
+    <action>Ask: "Theme looks good?"</action>
+    <action>Present numbered options:
+      1. Yes, use this theme - Proceed with theme
+      2. No, adjust colors - Modify color selections
+      3. Start over - Choose different preset
+    </action>
+    <action>WAIT for selection (1-3)</action>
+    <check if="selection is 2 or 3">
+      <action>Repeat Step 3</action>
+    </check>
+  </step>
+
+  <step n="4" goal="Plan Flowchart Layout">
+    <action>List all steps and decision points based on gathered requirements</action>
+    <action>Show user the planned structure</action>
+    <action>Ask: "Structure looks correct? (yes/no)"</action>
+    <action>WAIT for user response</action>
+    <check if="user says no">
+      <action>Adjust structure based on feedback</action>
+      <action>Repeat this step</action>
+    </check>
+  </step>
+
+  <step n="5" goal="Load Template and Resources">
+    <action>Load {{templates}} file</action>
+    <action>Extract `flowchart` section from YAML</action>
+    <action>Load {{library}} file</action>
+    <action>Load theme.json and merge colors with template</action>
+    <action>Load {{helpers}} for element creation guidelines</action>
+  </step>
+
+  <step n="6" goal="Build Flowchart Elements">
+    <critical>Follow guidelines from {{helpers}} for proper element creation</critical>
+
+    <action>Build ONE section at a time following these rules:</action>
+
+    <substep>For Each Shape with Label:
+      1. Generate unique IDs (shape-id, text-id, group-id)
+      2. Create shape with groupIds: [group-id]
+      3. Calculate text width: (text.length × fontSize × 0.6) + 20, round to nearest 10
+      4. Create text element with:
+         - containerId: shape-id
+         - groupIds: [group-id] (SAME as shape)
+         - textAlign: "center"
+         - verticalAlign: "middle"
+         - width: calculated width
+      5. Add boundElements to shape referencing text
+    </substep>
+
+    <substep>For Each Arrow:
+      1. Determine arrow type needed:
+         - Straight: For forward flow (left-to-right, top-to-bottom)
+         - Elbow: For upward flow, backward flow, or complex routing
+      2. Create arrow with startBinding and endBinding
+      3. Set startBinding.elementId to source shape ID
+      4. Set endBinding.elementId to target shape ID
+      5. Set gap: 10 for both bindings
+      6. If elbow arrow, add intermediate points for direction changes
+      7. Update boundElements on both connected shapes
+    </substep>
+
+    <substep>Alignment:
+      - Snap all x, y to 20px grid
+      - Align shapes vertically (same x for vertical flow)
+      - Space elements: 60px between shapes
+    </substep>
+
+    <substep>Build Order:
+      1. Start point (circle) with label
+      2. Each process step (rectangle) with label
+      3. Each decision point (diamond) with label
+      4. End point (circle) with label
+      5. Connect all with bound arrows
+    </substep>
+  </step>
+
+  <step n="7" goal="Optimize and Save">
+    <action>Strip unused elements and elements with isDeleted: true</action>
+    <action>Save to {{default_output_file}}</action>
+  </step>
+
+  <step n="8" goal="Validate JSON Syntax">
+    <critical>NEVER delete the file if validation fails - always fix syntax errors</critical>
+    <action>Run: node -e "JSON.parse(require('fs').readFileSync('{{default_output_file}}', 'utf8')); console.log('✓ Valid JSON')"</action>
+    <check if="validation fails (exit code 1)">
+      <action>Read the error message carefully - it shows the syntax error and position</action>
+      <action>Open the file and navigate to the error location</action>
+      <action>Fix the syntax error (add missing comma, bracket, or quote as indicated)</action>
+      <action>Save the file</action>
+      <action>Re-run validation with the same command</action>
+      <action>Repeat until validation passes</action>
+    </check>
+    <action>Once validation passes, confirm with user: "Flowchart created at {{default_output_file}}. Open to view?"</action>
+  </step>
+
+  <step n="9" goal="Validate Content">
+    <invoke-task>Validate against checklist at {{validation}} using {{bmad_folder}}/core/tasks/validate-workflow.xml</invoke-task>
+  </step>
+
+</workflow>
+```

package/src/modules/bmm/workflows/diagrams/create-flowchart/workflow.yaml

@@ -0,0 +1,27 @@
+name: create-excalidraw-flowchart
+description: "Create a flowchart visualization in Excalidraw format for processes, pipelines, or logic flows"
+author: "BMad"
+
+# Config values
+config_source: "{project-root}/{bmad_folder}/bmm/config.yaml"
+output_folder: "{config_source}:output_folder"
+
+# Workflow components
+installed_path: "{project-root}/{bmad_folder}/bmm/workflows/diagrams/create-flowchart"
+shared_path: "{project-root}/{bmad_folder}/bmm/workflows/diagrams/_shared"
+instructions: "{installed_path}/instructions.md"
+validation: "{installed_path}/checklist.md"
+
+# Core Excalidraw resources (universal knowledge)
+helpers: "{project-root}/{bmad_folder}/core/resources/excalidraw/excalidraw-helpers.md"
+json_validation: "{project-root}/{bmad_folder}/core/resources/excalidraw/validate-json-instructions.md"
+
+# Domain-specific resources (technical diagrams)
+templates: "{shared_path}/excalidraw-templates.yaml"
+library: "{shared_path}/excalidraw-library.json"
+
+# Output file (respects user's configured output_folder)
+default_output_file: "{output_folder}/diagrams/flowchart-{timestamp}.excalidraw"
+
+standalone: true
+web_bundle: false

package/src/modules/bmm/workflows/diagrams/create-wireframe/checklist.md

@@ -0,0 +1,38 @@
+# Create Wireframe - Validation Checklist
+
+## Layout Structure
+
+- [ ] Screen dimensions appropriate for device type
+- [ ] Grid alignment (20px) maintained
+- [ ] Consistent spacing between UI elements
+- [ ] Proper hierarchy (header, content, footer)
+
+## UI Elements
+
+- [ ] All interactive elements clearly marked
+- [ ] Buttons, inputs, and controls properly sized
+- [ ] Text labels readable and appropriately sized
+- [ ] Navigation elements clearly indicated
+
+## Fidelity
+
+- [ ] Matches requested fidelity level (low/medium/high)
+- [ ] Appropriate level of detail
+- [ ] Placeholder content used where needed
+- [ ] No unnecessary decoration for low-fidelity
+
+## Annotations
+
+- [ ] Key interactions annotated
+- [ ] Flow indicators present if multi-screen
+- [ ] Important notes included
+- [ ] Element purposes clear
+
+## Technical Quality
+
+- [ ] All elements properly grouped
+- [ ] Text elements have containerId
+- [ ] Snapped to grid
+- [ ] No elements with `isDeleted: true`
+- [ ] JSON is valid
+- [ ] File saved to correct location

package/src/modules/bmm/workflows/diagrams/create-wireframe/instructions.md

@@ -0,0 +1,133 @@
+# Create Wireframe - Workflow Instructions
+
+```xml
+<critical>The workflow execution engine is governed by: {project_root}/{bmad_folder}/core/tasks/workflow.xml</critical>
+<critical>You MUST have already loaded and processed: {installed_path}/workflow.yaml</critical>
+<critical>This workflow creates website or app wireframes in Excalidraw format.</critical>
+
+<workflow>
+
+  <step n="0" goal="Contextual Analysis">
+    <action>Review user's request and extract: wireframe type, fidelity level, screen count, device type, save location</action>
+    <check if="ALL requirements clear"><action>Skip to Step 5</action></check>
+  </step>
+
+  <step n="1" goal="Identify Wireframe Type" elicit="true">
+    <action>Ask: "What type of wireframe do you need?"</action>
+    <action>Present options:
+      1. Website (Desktop)
+      2. Mobile App (iOS/Android)
+      3. Web App (Responsive)
+      4. Tablet App
+      5. Multi-platform
+    </action>
+    <action>WAIT for selection</action>
+  </step>
+
+  <step n="2" goal="Gather Requirements" elicit="true">
+    <action>Ask fidelity level (Low/Medium/High)</action>
+    <action>Ask screen count (Single/Few 2-3/Multiple 4-6/Many 7+)</action>
+    <action>Ask device dimensions or use standard</action>
+    <action>Ask save location</action>
+  </step>
+
+  <step n="3" goal="Check Theme" elicit="true">
+    <action>Check for existing theme.json, ask to use if exists</action>
+  </step>
+
+  <step n="4" goal="Create Theme" elicit="true">
+    <action>Ask: "Choose a wireframe style:"</action>
+    <action>Present numbered options:
+      1. Classic Wireframe
+         - Background: #ffffff (white)
+         - Container: #f5f5f5 (light gray)
+         - Border: #9e9e9e (gray)
+         - Text: #424242 (dark gray)
+
+      2. High Contrast
+         - Background: #ffffff (white)
+         - Container: #eeeeee (light gray)
+         - Border: #212121 (black)
+         - Text: #000000 (black)
+
+      3. Blueprint Style
+         - Background: #1a237e (dark blue)
+         - Container: #3949ab (blue)
+         - Border: #7986cb (light blue)
+         - Text: #ffffff (white)
+
+      4. Custom - Define your own colors
+    </action>
+    <action>WAIT for selection</action>
+    <action>Create theme.json based on selection</action>
+    <action>Confirm with user</action>
+  </step>
+
+  <step n="5" goal="Plan Wireframe Structure">
+    <action>List all screens and their purposes</action>
+    <action>Map navigation flow between screens</action>
+    <action>Identify key UI elements for each screen</action>
+    <action>Show planned structure, confirm with user</action>
+  </step>
+
+  <step n="6" goal="Load Resources">
+    <action>Load {{templates}} and extract `wireframe` section</action>
+    <action>Load {{library}}</action>
+    <action>Load theme.json</action>
+    <action>Load {{helpers}}</action>
+  </step>
+
+  <step n="7" goal="Build Wireframe Elements">
+    <critical>Follow {{helpers}} for proper element creation</critical>
+
+    <substep>For Each Screen:
+      - Create container/frame
+      - Add header section
+      - Add content areas
+      - Add navigation elements
+      - Add interactive elements (buttons, inputs)
+      - Add labels and annotations
+    </substep>
+
+    <substep>Build Order:
+      1. Screen containers
+      2. Layout sections (header, content, footer)
+      3. Navigation elements
+      4. Content blocks
+      5. Interactive elements
+      6. Labels and annotations
+      7. Flow indicators (if multi-screen)
+    </substep>
+
+    <substep>Fidelity Guidelines:
+      - Low: Basic shapes, minimal detail, placeholder text
+      - Medium: More defined elements, some styling, representative content
+      - High: Detailed elements, realistic sizing, actual content examples
+    </substep>
+  </step>
+
+  <step n="8" goal="Optimize and Save">
+    <action>Strip unused elements and elements with isDeleted: true</action>
+    <action>Save to {{default_output_file}}</action>
+  </step>
+
+  <step n="9" goal="Validate JSON Syntax">
+    <critical>NEVER delete the file if validation fails - always fix syntax errors</critical>
+    <action>Run: node -e "JSON.parse(require('fs').readFileSync('{{default_output_file}}', 'utf8')); console.log('✓ Valid JSON')"</action>
+    <check if="validation fails (exit code 1)">
+      <action>Read the error message carefully - it shows the syntax error and position</action>
+      <action>Open the file and navigate to the error location</action>
+      <action>Fix the syntax error (add missing comma, bracket, or quote as indicated)</action>
+      <action>Save the file</action>
+      <action>Re-run validation with the same command</action>
+      <action>Repeat until validation passes</action>
+    </check>
+    <action>Once validation passes, confirm with user</action>
+  </step>
+
+  <step n="10" goal="Validate Content">
+    <invoke-task>Validate against {{validation}}</invoke-task>
+  </step>
+
+</workflow>
+```

package/src/modules/bmm/workflows/diagrams/create-wireframe/workflow.yaml

@@ -0,0 +1,27 @@
+name: create-excalidraw-wireframe
+description: "Create website or app wireframes in Excalidraw format"
+author: "BMad"
+
+# Config values
+config_source: "{project-root}/{bmad_folder}/bmm/config.yaml"
+output_folder: "{config_source}:output_folder"
+
+# Workflow components
+installed_path: "{project-root}/{bmad_folder}/bmm/workflows/diagrams/create-wireframe"
+shared_path: "{project-root}/{bmad_folder}/bmm/workflows/diagrams/_shared"
+instructions: "{installed_path}/instructions.md"
+validation: "{installed_path}/checklist.md"
+
+# Core Excalidraw resources (universal knowledge)
+helpers: "{project-root}/{bmad_folder}/core/resources/excalidraw/excalidraw-helpers.md"
+json_validation: "{project-root}/{bmad_folder}/core/resources/excalidraw/validate-json-instructions.md"
+
+# Domain-specific resources (technical diagrams)
+templates: "{shared_path}/excalidraw-templates.yaml"
+library: "{shared_path}/excalidraw-library.json"
+
+# Output file (respects user's configured output_folder)
+default_output_file: "{output_folder}/diagrams/wireframe-{timestamp}.excalidraw"
+
+standalone: true
+web_bundle: false

package/src/modules/bmm/workflows/document-project/checklist.md

@@ -181,7 +181,7 @@
 
 ### Missing Information (to note for user)
 
-- ***
+-
 
 ## Deep-Dive Mode Validation (if deep-dive was performed)
 

package/src/modules/bmm/workflows/document-project/instructions.md

@@ -1,7 +1,7 @@
 # Document Project Workflow Router
 
-<critical>The workflow execution engine is governed by: {project-root}/bmad/core/tasks/workflow.xml</critical>
-<critical>You MUST have already loaded and processed: {project-root}/bmad/bmm/workflows/document-project/workflow.yaml</critical>
+<critical>The workflow execution engine is governed by: {project-root}/{bmad_folder}/core/tasks/workflow.xml</critical>
+<critical>You MUST have already loaded and processed: {project-root}/{bmad_folder}/bmm/workflows/document-project/workflow.yaml</critical>
 <critical>Communicate all responses in {communication_language}</critical>
 
 <workflow>
@@ -10,7 +10,7 @@
 
 <step n="1" goal="Validate workflow and get project info">
 
-<invoke-workflow path="{project-root}/bmad/bmm/workflows/workflow-status">
+<invoke-workflow path="{project-root}/{bmad_folder}/bmm/workflows/workflow-status">
   <param>mode: data</param>
   <param>data_request: project_config</param>
 </invoke-workflow>
@@ -36,7 +36,7 @@
   </check>
 
   <!-- Now validate sequencing -->
-  <invoke-workflow path="{project-root}/bmad/bmm/workflows/workflow-status">
+  <invoke-workflow path="{project-root}/{bmad_folder}/bmm/workflows/workflow-status">
     <param>mode: validate</param>
     <param>calling_workflow: document-project</param>
   </invoke-workflow>
@@ -179,7 +179,7 @@ Your choice [1/2/3]:
 <step n="4" goal="Update status and complete">
 
 <check if="status_file_found == true">
-  <invoke-workflow path="{project-root}/bmad/bmm/workflows/workflow-status">
+  <invoke-workflow path="{project-root}/{bmad_folder}/bmm/workflows/workflow-status">
     <param>mode: update</param>
     <param>action: complete_workflow</param>
     <param>workflow_name: document-project</param>

package/src/modules/bmm/workflows/document-project/workflow.yaml

@@ -5,7 +5,7 @@ description: "Analyzes and documents brownfield projects by scanning codebase, a
 author: "BMad"
 
 # Critical variables
-config_source: "{project-root}/bmad/bmm/config.yaml"
+config_source: "{project-root}/{bmad_folder}/bmm/config.yaml"
 output_folder: "{config_source}:output_folder"
 user_name: "{config_source}:user_name"
 communication_language: "{config_source}:communication_language"
@@ -14,7 +14,7 @@ user_skill_level: "{config_source}:user_skill_level"
 date: system-generated
 
 # Module path and component files
-installed_path: "{project-root}/bmad/bmm/workflows/document-project"
+installed_path: "{project-root}/{bmad_folder}/bmm/workflows/document-project"
 template: false # This is an action workflow with multiple output files
 instructions: "{installed_path}/instructions.md"
 validation: "{installed_path}/checklist.md"
@@ -22,11 +22,6 @@ validation: "{installed_path}/checklist.md"
 # Required data files - CRITICAL for project type detection and documentation requirements
 documentation_requirements_csv: "{installed_path}/documentation-requirements.csv"
 
-# Optional input - project root to scan (defaults to current working directory)
-recommended_inputs:
-  - project_root: "User will specify or use current directory"
-  - existing_readme: "README.md at project root (if exists)"
-  - project_config: "package.json, go.mod, requirements.txt, etc. (auto-detected)"
 # Output configuration - Multiple files generated in output folder
 # Primary output: {output_folder}/index.md
 # Additional files generated by sub-workflows based on project structure

package/src/modules/bmm/workflows/document-project/workflows/deep-dive-instructions.md

@@ -137,10 +137,10 @@ This will read EVERY file in this area. Proceed? [y/n]
 <action>For each file in file\*inventory, document: - **File Path:** Full path - **Purpose:** What this file does (1-2 sentences) - **Lines of Code:** Total LOC - **Exports:** Complete list with signatures
 
 - Functions: `functionName(param: Type): ReturnType` - Description
-  _ Classes: `ClassName` - Description with key methods
-  _ Types/Interfaces: `TypeName` - Description
-  \_ Constants: `CONSTANT_NAME: Type` - Description - **Imports/Dependencies:** What it uses and why - **Used By:** Files that import this (dependents) - **Key Implementation Details:** Important logic, algorithms, patterns - **State Management:** If applicable (Redux, Context, local state) - **Side Effects:** API calls, database queries, file I/O, external services - **Error Handling:** Try/catch blocks, error boundaries, validation - **Testing:** Associated test files and coverage - **Comments/TODOs:** Any inline documentation or planned work
-  </action>
+  - Classes: `ClassName` - Description with key methods
+  - Types/Interfaces: `TypeName` - Description
+  - Constants: `CONSTANT_NAME: Type` - Description - **Imports/Dependencies:** What it uses and why - **Used By:** Files that import this (dependents) - **Key Implementation Details:** Important logic, algorithms, patterns - **State Management:** If applicable (Redux, Context, local state) - **Side Effects:** API calls, database queries, file I/O, external services - **Error Handling:** Try/catch blocks, error boundaries, validation - **Testing:** Associated test files and coverage - **Comments/TODOs:** Any inline documentation or planned work
+    </action>
 
 <template-output>comprehensive_file_inventory</template-output>
 </step>

package/src/modules/bmm/workflows/document-project/workflows/deep-dive.yaml

@@ -4,22 +4,22 @@ description: "Exhaustive deep-dive documentation of specific project areas"
 author: "BMad"
 
 # This is a sub-workflow called by document-project/workflow.yaml
-parent_workflow: "{project-root}/bmad/bmm/workflows/document-project/workflow.yaml"
+parent_workflow: "{project-root}/{bmad_folder}/bmm/workflows/document-project/workflow.yaml"
 
 # Critical variables inherited from parent
-config_source: "{project-root}/bmad/bmb/config.yaml"
+config_source: "{project-root}/{bmad_folder}/bmb/config.yaml"
 output_folder: "{config_source}:output_folder"
 user_name: "{config_source}:user_name"
 date: system-generated
 
 # Module path and component files
-installed_path: "{project-root}/bmad/bmm/workflows/document-project/workflows"
+installed_path: "{project-root}/{bmad_folder}/bmm/workflows/document-project/workflows"
 template: false # Action workflow
 instructions: "{installed_path}/deep-dive-instructions.md"
-validation: "{project-root}/bmad/bmm/workflows/document-project/checklist.md"
+validation: "{project-root}/{bmad_folder}/bmm/workflows/document-project/checklist.md"
 
 # Templates
-deep_dive_template: "{project-root}/bmad/bmm/workflows/document-project/templates/deep-dive-template.md"
+deep_dive_template: "{project-root}/{bmad_folder}/bmm/workflows/document-project/templates/deep-dive-template.md"
 
 # Runtime inputs (passed from parent workflow)
 workflow_mode: "deep_dive"

package/src/modules/bmm/workflows/document-project/workflows/full-scan-instructions.md

@@ -325,11 +325,11 @@ findings.batches_completed: [
   </check>
 
 <action>Build API contracts catalog</action>
-<action>IMMEDIATELY write to: {output*folder}/api-contracts-{part_id}.md</action>
+<action>IMMEDIATELY write to: {output_folder}/api-contracts-{part_id}.md</action>
 <action>Validate document has all required sections</action>
 <action>Update state file with output generated</action>
 <action>PURGE detailed API data, keep only: "{{api_count}} endpoints documented"</action>
-<template-output>api_contracts*{part_id}</template-output>
+<template-output>api_contracts\*{part_id}</template-output>
 </check>
 
 <check if="requires_data_models == true">
@@ -346,11 +346,11 @@ findings.batches_completed: [
   </check>
 
 <action>Build database schema documentation</action>
-<action>IMMEDIATELY write to: {output*folder}/data-models-{part_id}.md</action>
+<action>IMMEDIATELY write to: {output_folder}/data-models-{part_id}.md</action>
 <action>Validate document completeness</action>
 <action>Update state file with output generated</action>
 <action>PURGE detailed schema data, keep only: "{{table_count}} tables documented"</action>
-<template-output>data_models*{part_id}</template-output>
+<template-output>data_models\*{part_id}</template-output>
 </check>
 
 <check if="requires_state_management == true">
@@ -758,15 +758,15 @@ When a document SHOULD be generated but wasn't (due to quick scan, missing data,
 ### Generated Documentation
 
 - [Project Overview](./project-overview.md)
-- [Architecture](./architecture{{#if multi-part}}-{part*id}{{/if}}.md){{#unless architecture_file_exists}} *(To be generated)\_{{/unless}}
+- [Architecture](./architecture{{#if multi-part}}-{part\*id}{{/if}}.md){{#unless architecture_file_exists}} (To be generated) {{/unless}}
 - [Source Tree Analysis](./source-tree-analysis.md)
-- [Component Inventory](./component-inventory{{#if multi-part}}-{part*id}{{/if}}.md){{#unless component_inventory_exists}} *(To be generated)\_{{/unless}}
-- [Development Guide](./development-guide{{#if multi-part}}-{part*id}{{/if}}.md){{#unless dev_guide_exists}} *(To be generated)_{{/unless}}
-  {{#if deployment_found}}- [Deployment Guide](./deployment-guide.md){{#unless deployment_guide_exists}} _(To be generated)_{{/unless}}{{/if}}
+- [Component Inventory](./component-inventory{{#if multi-part}}-{part\*id}{{/if}}.md){{#unless component_inventory_exists}} (To be generated) {{/unless}}
+- [Development Guide](./development-guide{{#if multi-part}}-{part\*id}{{/if}}.md){{#unless dev_guide_exists}} (To be generated) {{/unless}}
+  {{#if deployment_found}}- [Deployment Guide](./deployment-guide.md){{#unless deployment_guide_exists}} (To be generated) {{/unless}}{{/if}}
   {{#if contribution_found}}- [Contribution Guide](./contribution-guide.md){{/if}}
-  {{#if api_documented}}- [API Contracts](./api-contracts{{#if multi-part}}-{part_id}{{/if}}.md){{#unless api_contracts_exists}} _(To be generated)_{{/unless}}{{/if}}
-  {{#if data_models_documented}}- [Data Models](./data-models{{#if multi-part}}-{part_id}{{/if}}.md){{#unless data_models_exists}} _(To be generated)_{{/unless}}{{/if}}
-  {{#if multi-part}}- [Integration Architecture](./integration-architecture.md){{#unless integration_arch_exists}} _(To be generated)\_{{/unless}}{{/if}}
+  {{#if api_documented}}- [API Contracts](./api-contracts{{#if multi-part}}-{part_id}{{/if}}.md){{#unless api_contracts_exists}} (To be generated) {{/unless}}{{/if}}
+  {{#if data_models_documented}}- [Data Models](./data-models{{#if multi-part}}-{part_id}{{/if}}.md){{#unless data_models_exists}} (To be generated) {{/unless}}{{/if}}
+  {{#if multi-part}}- [Integration Architecture](./integration-architecture.md){{#unless integration_arch_exists}} (To be generated) {{/unless}}{{/if}}
 
 ### Existing Documentation
 
@@ -850,10 +850,10 @@ Set {{incomplete_docs_list}} = {{incomplete_docs_strict}} + {{incomplete_docs_fu
 For each item store structure:
 {
 "title": "Architecture – Server",
-"file*path": "./architecture-server.md",
+"file\*path": "./architecture-server.md",
 "doc_type": "architecture",
 "part_id": "server",
-"line_text": "- [Architecture – Server](./architecture-server.md) *(To be generated)\_",
+"line_text": "- [Architecture – Server](./architecture-server.md) (To be generated)",
 "fuzzy_match": false
 }
 </action>