bmad-method 6.0.0-alpha.22 → 6.0.0-alpha.23

package/src/modules/bmb/workflows/module/steps-e/step-01-load-target.md

@@ -0,0 +1,81 @@
+---
+name: 'step-01-load-target'
+description: 'Load target for editing'
+
+nextStepFile: './step-02-select-edit.md'
+moduleStandardsFile: '../../data/module-standards.md'
+---
+
+# Step 1: Load Target (Edit Mode)
+
+## STEP GOAL:
+
+Load the target (brief, module.yaml, agent specs, or workflow specs) for editing.
+
+## MANDATORY EXECUTION RULES:
+
+### Universal Rules:
+- 📖 CRITICAL: Read the complete step file before taking any action
+- ✅ Speak in `{communication_language}`
+
+### Role Reinforcement:
+- ✅ You are the **Module Editor** — helpful, ready to assist
+- ✅ Understand what we're editing
+
+---
+
+## MANDATORY SEQUENCE
+
+### 1. Determine Edit Target
+
+"**What would you like to edit?**"
+
+Options:
+- **[B]rief** — Module brief from Brief mode
+- **[Y]aml** — module.yaml configuration
+- **[A]gents** — Agent specifications
+- **[W]orkflows** — Workflow specifications
+- **[D]ocs** — README.md or TODO.md
+
+### 2. Load Target
+
+Based on selection, load the target file(s).
+
+**IF Brief:**
+- Path: `{bmb_creations_output_folder}/modules/module-brief-{code}.md`
+
+**IF Yaml:**
+- Path: `src/modules/{code}/module.yaml`
+
+**IF Agents:**
+- Path: `src/modules/{code}/agents/`
+- List available agent specs
+
+**IF Workflows:**
+- Path: `src/modules/{code}/workflows/`
+- List available workflow specs
+
+**IF Docs:**
+- Path: `src/modules/{code}/README.md` or `TODO.md`
+
+### 3. Display Current Content
+
+Show the current content of the target file.
+
+"**Here's the current content:**"
+
+{display relevant sections or summary}
+
+### 4. Proceed to Selection
+
+"**What would you like to change?**"
+
+Load `{nextStepFile}` to select the edit type.
+
+---
+
+## Success Metrics
+
+✅ Target loaded
+✅ Current content displayed
+✅ Ready to select edit type

package/src/modules/bmb/workflows/module/steps-e/step-02-select-edit.md

@@ -0,0 +1,77 @@
+---
+name: 'step-02-select-edit'
+description: 'Select edit type and gather changes'
+
+nextStepFile: './step-03-apply-edit.md'
+---
+
+# Step 2: Select Edit Type
+
+## STEP GOAL:
+
+Select the type of edit and gather the changes to make.
+
+## MANDATORY EXECUTION RULES:
+
+### Universal Rules:
+- 📖 CRITICAL: Read the complete step file before taking any action
+- ✅ Speak in `{communication_language}`
+
+### Role Reinforcement:
+- ✅ You are the **Module Editor** — precise, collaborative
+- ✅ Understand the change before making it
+
+---
+
+## MANDATORY SEQUENCE
+
+### 1. Select Edit Type
+
+"**What type of edit would you like to make?**"
+
+- **[M]odify** — Change existing content
+- **[A]dd** — Add new content
+- **[D]elete** — Remove content
+- **[R]eplace** — Replace section entirely
+
+### 2. Gather Edit Details
+
+**IF Modify:**
+"**Which section do you want to modify?**"
+"What should it change to?"
+
+**IF Add:**
+"**What do you want to add?**"
+"**Where should it go?**"
+
+**IF Delete:**
+"**What do you want to remove?**"
+
+**IF Replace:**
+"**What section should be replaced?**"
+"**What's the new content?**"
+
+### 3. Confirm Change
+
+"**Please confirm the edit:**"
+
+**Type:** {edit_type}
+**Target:** {section or content}
+**Change:** {description of change}
+
+"**Is this correct?**"
+
+### 4. Store Edit Plan
+
+Store the edit plan for the next step.
+
+Load `{nextStepFile}` to apply the edit.
+
+---
+
+## Success Metrics
+
+✅ Edit type selected
+✅ Change details gathered
+✅ User confirmed
+✅ Edit plan stored

package/src/modules/bmb/workflows/module/steps-e/step-03-apply-edit.md

@@ -0,0 +1,77 @@
+---
+name: 'step-03-apply-edit'
+description: 'Apply the edit and save'
+
+nextStepFile: './step-04-review.md'
+---
+
+# Step 3: Apply Edit
+
+## STEP GOAL:
+
+Apply the confirmed edit to the target file and save.
+
+## MANDATORY EXECUTION RULES:
+
+### Universal Rules:
+- 📖 CRITICAL: Read the complete step file before taking any action
+- ✅ Speak in `{communication_language}`
+
+### Role Reinforcement:
+- ✅ You are the **Module Editor** — making changes
+- ✅ Apply edits precisely
+
+---
+
+## MANDATORY SEQUENCE
+
+### 1. Load Target File
+
+Read the complete target file.
+
+### 2. Apply Edit
+
+Based on the edit plan from step 2:
+
+**IF Modify:**
+- Locate the section
+- Apply the modification
+- Preserve surrounding context
+
+**IF Add:**
+- Find the insertion point
+- Insert new content
+- Maintain formatting
+
+**IF Delete:**
+- Locate the content
+- Remove it
+- Clean up any gaps
+
+**IF Replace:**
+- Locate the section
+- Replace with new content
+- Ensure proper formatting
+
+### 3. Save Changes
+
+Write the modified content back to the target file.
+
+### 4. Report Success
+
+"**✓ Edit applied!**"
+
+**File:** {file_path}
+**Change:** {summary_of_change}
+
+### 5. Proceed to Review
+
+Load `{nextStepFile}` to review the changes.
+
+---
+
+## Success Metrics
+
+✅ Edit applied correctly
+✅ File saved
+✅ Change summary provided

package/src/modules/bmb/workflows/module/steps-e/step-04-review.md

@@ -0,0 +1,80 @@
+---
+name: 'step-04-review'
+description: 'Review changes and offer validation'
+
+nextStepFile: './step-05-confirm.md'
+validationWorkflow: '../steps-v/step-01-load-target.md'
+---
+
+# Step 4: Review Changes
+
+## STEP GOAL:
+
+Review the applied changes and offer to run validation.
+
+## MANDATORY EXECUTION RULES:
+
+### Universal Rules:
+- 📖 CRITICAL: Read the complete step file before taking any action
+- ✅ Speak in `{communication_language}`
+
+### Role Reinforcement:
+- ✅ You are the **Module Editor** — confirming changes
+- ✅ Ensure user is satisfied
+
+---
+
+## MANDATORY SEQUENCE
+
+### 1. Show Diff
+
+Display what changed:
+
+"**Here's what changed:**"
+
+**Before:**
+{before_content}
+
+**After:**
+{after_content}
+
+### 2. Confirm Satisfaction
+
+"**Are you happy with this change?**"
+
+- **[Y]es** — Keep the change
+- **[N]o** — Revert and redo
+- **[M]odify** — Make further adjustments
+
+### 3. Handle Response
+
+**IF Yes:**
+- Mark edit as complete
+- Proceed to step 5
+
+**IF No:**
+- Revert the change
+- Return to step 2 to gather new edit
+
+**IF Modify:**
+- Make additional adjustments
+- Show updated diff
+- Ask again
+
+### 4. Offer Validation
+
+"**Would you like to run validation after this edit?**"
+
+- Validation can check for any issues introduced
+
+### 5. Proceed to Confirm
+
+Load `{nextStepFile}` to confirm completion.
+
+---
+
+## Success Metrics
+
+✅ Changes reviewed
+✅ User satisfaction confirmed
+✅ Validation offered

package/src/modules/bmb/workflows/module/steps-e/step-05-confirm.md

@@ -0,0 +1,75 @@
+---
+name: 'step-05-confirm'
+description: 'Confirm completion and offer next steps'
+
+validationWorkflow: '../steps-v/step-01-load-target.md'
+---
+
+# Step 5: Confirm Completion
+
+## STEP GOAL:
+
+Confirm edit completion and offer next steps including validation.
+
+## MANDATORY EXECUTION RULES:
+
+### Universal Rules:
+- 📖 CRITICAL: Read the complete step file before taking any action
+- ✅ Speak in `{communication_language}`
+
+### Role Reinforcement:
+- ✅ You are the **Module Editor** — completing the job
+- ✅ Guide next steps
+
+---
+
+## MANDATORY SEQUENCE
+
+### 1. Summary of Changes
+
+"**✓ Edit complete!**"
+
+**File edited:** {file_path}
+**Edit type:** {edit_type}
+**Summary:** {summary_of_change}
+
+### 2. Offer Next Actions
+
+"**What would you like to do next?**"
+
+- **[V]alidate** — Run validation to check for issues
+- **[E]dit more** — Make additional changes
+- **[D]one** — Complete edit session
+
+### 3. Handle Response
+
+**IF Validate:**
+"**Loading validation workflow...**"
+Load `{validationWorkflow}`
+
+**IF Edit more:**
+"**Loading edit selection...**"
+Return to step 1
+
+**IF Done:**
+"**Edit session complete!**"
+Summary of what was accomplished.
+
+### 4. Complete Session
+
+If Done selected:
+
+"**Thanks for using the Module Edit workflow!**"
+
+"**Summary:**"
+- Files edited: {count}
+- Changes made: {summary}
+
+---
+
+## Success Metrics
+
+✅ Edit confirmed complete
+✅ Next actions offered
+✅ Validation accessible
+✅ Session properly closed

package/src/modules/bmb/workflows/module/steps-v/step-01-load-target.md

@@ -0,0 +1,96 @@
+---
+name: 'step-01-load-target'
+description: 'Load target for validation'
+
+nextStepFile: './step-02-file-structure.md'
+validationReportOutput: '{bmb_creations_output_folder}/modules/validation-report-{target_code}-{timestamp}.md'
+---
+
+# Step 1: Load Target (Validate Mode)
+
+## STEP GOAL:
+
+Load the target (brief, module, agent specs, or workflow specs) for validation.
+
+## MANDATORY EXECUTION RULES:
+
+### Universal Rules:
+- 📖 CRITICAL: Read the complete step file before taking any action
+- ✅ Speak in `{communication_language}`
+
+### Role Reinforcement:
+- ✅ You are the **Quality Assurance** — thorough, systematic
+- ✅ Understand what we're validating
+
+---
+
+## MANDATORY SEQUENCE
+
+### 1. Determine Validation Target
+
+"**What would you like to validate?**"
+
+Options:
+- **[B]rief** — Module brief from Brief mode
+- **[M]odule** — Built module structure
+- **[A]gents** — Agent specifications
+- **[W]orkflows** — Workflow specifications
+- **[F]ull** — Everything (brief + module + specs)
+
+### 2. Load Target
+
+Based on selection, load the target:
+
+**IF Brief:**
+- Path: `{bmb_creations_output_folder}/modules/module-brief-{code}.md`
+- Ask for module code if not specified
+
+**IF Module:**
+- Path: `src/modules/{code}/`
+- Ask for module code if not specified
+
+**IF Agents:**
+- Path: `src/modules/{code}/agents/`
+- Load all `.spec.md` or `.agent.yaml` files
+
+**IF Workflows:**
+- Path: `src/modules/{code}/workflows/`
+- Load all `.spec.md` files
+
+**IF Full:**
+- Load everything above for a module
+
+### 3. Confirm Target
+
+"**Validating:** {target_type} for {module_code}"
+"**Location:** {path}"
+
+"**Shall I proceed?**"
+
+### 4. Initialize Validation Report
+
+Create the validation report structure:
+
+```yaml
+---
+validationDate: {timestamp}
+targetType: {target_type}
+moduleCode: {module_code}
+targetPath: {path}
+status: IN_PROGRESS
+---
+```
+
+### 5. Proceed to Validation
+
+"**Starting validation checks...**"
+
+Load `{nextStepFile}` to begin file structure validation.
+
+---
+
+## Success Metrics
+
+✅ Target loaded
+✅ Validation report initialized
+✅ User confirmed

package/src/modules/bmb/workflows/module/steps-v/step-02-file-structure.md

@@ -0,0 +1,94 @@
+---
+name: 'step-02-file-structure'
+description: 'Validate file structure compliance'
+
+nextStepFile: './step-03-module-yaml.md'
+moduleStandardsFile: '../../data/module-standards.md'
+validationReportOutput: '{validation_report_output}'
+---
+
+# Step 2: File Structure Validation
+
+## STEP GOAL:
+
+Validate file structure against module standards.
+
+## MANDATORY EXECUTION RULES:
+
+### Universal Rules:
+- 📖 CRITICAL: Read the complete step file before taking any action
+- ✅ Speak in `{communication_language}`
+
+### Role Reinforcement:
+- ✅ You are the **Quality Assurance** — checking structure
+- ✅ Reference standards, ensure compliance
+
+---
+
+## MANDATORY SEQUENCE
+
+### 1. Load Standards
+
+Load `{moduleStandardsFile}` for reference.
+
+### 2. Perform Structure Checks
+
+Check based on target type:
+
+**For Modules:**
+- [ ] module.yaml exists
+- [ ] README.md exists
+- [ ] agents/ folder exists (if agents specified)
+- [ ] workflows/ folder exists (if workflows specified)
+- [ ] _module-installer/ folder (if installer specified)
+
+**For Briefs:**
+- [ ] Brief file exists
+- [ ] Required sections present
+
+**For Agent Specs:**
+- [ ] All expected spec files exist
+
+**For Workflow Specs:**
+- [ ] All expected spec files exist
+
+### 3. Check Module Type Compliance
+
+**IF Extension Module:**
+- [ ] Code matches base module
+- [ ] Folder name is unique (not conflicting)
+
+**IF Global Module:**
+- [ ] Global flag documented
+
+### 4. Record Results
+
+Append to `{validationReportOutput}`:
+
+```markdown
+## File Structure Validation
+
+**Status:** {PASS/FAIL/WARNINGS}
+
+**Checks:**
+{list each check with result}
+
+**Issues Found:**
+{any structural problems}
+```
+
+### 5. Auto-Proceed
+
+"**✓ File structure check complete.**"
+
+Proceeding to next validation...
+
+Load `{nextStepFile}`
+
+---
+
+## Success Metrics
+
+✅ All structure checks performed
+✅ Results recorded
+✅ Auto-proceeds to next validation

package/src/modules/bmb/workflows/module/steps-v/step-03-module-yaml.md

@@ -0,0 +1,99 @@
+---
+name: 'step-03-module-yaml'
+description: 'Validate module.yaml against conventions'
+
+nextStepFile: './step-04-agent-specs.md'
+moduleYamlConventionsFile: '../../data/module-yaml-conventions.md'
+validationReportOutput: '{validation_report_output}'
+targetPath: '{validation_target_path}'
+---
+
+# Step 3: module.yaml Validation
+
+## STEP GOAL:
+
+Validate module.yaml formatting and conventions.
+
+## MANDATORY EXECUTION RULES:
+
+### Universal Rules:
+- 📖 CRITICAL: Read the complete step file before taking any action
+- ✅ Speak in `{communication_language}`
+
+### Role Reinforcement:
+- ✅ You are the **Quality Assurance** — checking configuration
+- ✅ Ensure proper YAML syntax
+
+---
+
+## MANDATORY SEQUENCE
+
+### 1. Load module.yaml
+
+Read `{targetPath}/module.yaml`
+
+**IF not present:**
+- Record as FAIL (required file)
+- Skip to next validation
+
+### 2. Validate Required Fields
+
+Check for required frontmatter:
+- [ ] `code:` present and valid (kebab-case, 2-20 chars)
+- [ ] `name:` present
+- [ ] `header:` present
+- [ ] `subheader:` present
+- [ ] `default_selected:` present (boolean)
+
+### 3. Validate Custom Variables
+
+For each custom variable:
+- [ ] `prompt:` present
+- [ ] `default:` present (or explicitly omitted)
+- [ ] `result:` template valid
+- [ ] Variable naming correct (kebab-case)
+
+**For single-select:**
+- [ ] `single-select:` array present
+- [ ] All options have `value:` and `label:`
+
+**For multi-select:**
+- [ ] `multi-select:` array present
+- [ ] All options have `value:` and `label:`
+
+### 4. Validate Extension Module Code
+
+**IF Extension:**
+- [ ] `code:` matches base module code
+- [ ] This is intentional (not an error)
+
+### 5. Record Results
+
+Append to `{validationReportOutput}`:
+
+```markdown
+## module.yaml Validation
+
+**Status:** {PASS/FAIL/WARNINGS}
+
+**Required Fields:** {status}
+**Custom Variables:** {count} variables
+**Issues Found:**
+{list any issues}
+```
+
+### 6. Auto-Proceed
+
+"**✓ module.yaml check complete.**"
+
+Proceeding to next validation...
+
+Load `{nextStepFile}`
+
+---
+
+## Success Metrics
+
+✅ All module.yaml checks performed
+✅ Results recorded
+✅ Auto-proceeds to next validation