@devo-bmad-custom/agent-orchestration 1.0.2 → 1.0.4

package/src/bmb/workflows/module/steps-v/step-07-installation.md

@@ -1,102 +1,102 @@
----
-name: 'step-07-installation'
-description: 'Installation readiness check'
-
-nextStepFile: './step-08-report.md'
-moduleHelpGenerateWorkflow: '../module-help-generate.md'
-validationReportOutput: '{validation_report_output}'
-targetPath: '{validation_target_path}'
-moduleHelpCsvFile: '{validation_target_path}/module-help.csv'
----
-
-# Step 7: Installation Readiness
-
-## STEP GOAL:
-
-Check if the module is ready for installation.
-
-## 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 readiness
-- ✅ Installation should work
-
----
-
-## MANDATORY SEQUENCE
-
-### 1. Check module.yaml Install Variables
-
-**IF custom variables exist:**
-- [ ] All variables have prompts
-- [ ] Defaults are reasonable
-- [ ] Result templates are valid
-
-**Path Variables:**
-- [ ] Paths use `{project-root}/` prefix
-- [ ] Output paths are user-configurable
-
-### 2. Check module-help.csv
-
-**CRITICAL:** Every module must have `module-help.csv` at its root.
-
-**Check:**
-- [ ] `module-help.csv` exists at `{moduleHelpCsvFile}`
-- [ ] Has valid header: `module,phase,name,code,sequence,workflow-file,command,required,agent,options,description,output-location,outputs,`
-- [ ] `anytime` entries at TOP with EMPTY sequence
-- [ ] Phased entries BELOW anytime (phase-1, phase-2, etc.)
-- [ ] Agent-only entries have EMPTY `workflow-file`
-
-**If missing:**
-- FAIL - Module is not ready for installation without help registry
-- Suggest running `{moduleHelpGenerateWorkflow}`
-
-### 3. Module Type Installation
-
-**IF Extension:**
-- [ ] `code:` matches base (for proper merge)
-- [ ] Folder name is unique
-
-**IF Global:**
-- [ ] `global: true` or documented
-- [ ] Global impact is minimal/intentional
-
-### 4. Record Results
-
-Append to `{validationReportOutput}`:
-
-```markdown
-## Installation Readiness
-
-**Status:** {PASS/FAIL/WARNINGS}
-
-**Install Variables:** {count} variables
-**Install Variables:** {count} variables
-**Help Registry:** {present/missing} - {status}
-**Ready to Install:** {yes/no}
-
-**Issues Found:**
-{list any issues}
-```
-
-### 5. Auto-Proceed
-
-"**✓ Installation readiness check complete.**"
-
-Proceeding to final report...
-
-Load `{nextStepFile}`
-
----
-
-## Success Metrics
-
-✅ Installation readiness assessed
-✅ module-help.csv presence and structure validated
-✅ Module type compatibility checked
-✅ Results recorded
+---
+name: 'step-07-installation'
+description: 'Installation readiness check'
+
+nextStepFile: './step-08-report.md'
+moduleHelpGenerateWorkflow: '../module-help-generate.md'
+validationReportOutput: '{validation_report_output}'
+targetPath: '{validation_target_path}'
+moduleHelpCsvFile: '{validation_target_path}/module-help.csv'
+---
+
+# Step 7: Installation Readiness
+
+## STEP GOAL:
+
+Check if the module is ready for installation.
+
+## 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 readiness
+- ✅ Installation should work
+
+---
+
+## MANDATORY SEQUENCE
+
+### 1. Check module.yaml Install Variables
+
+**IF custom variables exist:**
+- [ ] All variables have prompts
+- [ ] Defaults are reasonable
+- [ ] Result templates are valid
+
+**Path Variables:**
+- [ ] Paths use `{project-root}/` prefix
+- [ ] Output paths are user-configurable
+
+### 2. Check module-help.csv
+
+**CRITICAL:** Every module must have `module-help.csv` at its root.
+
+**Check:**
+- [ ] `module-help.csv` exists at `{moduleHelpCsvFile}`
+- [ ] Has valid header: `module,phase,name,code,sequence,workflow-file,command,required,agent,options,description,output-location,outputs,`
+- [ ] `anytime` entries at TOP with EMPTY sequence
+- [ ] Phased entries BELOW anytime (phase-1, phase-2, etc.)
+- [ ] Agent-only entries have EMPTY `workflow-file`
+
+**If missing:**
+- FAIL - Module is not ready for installation without help registry
+- Suggest running `{moduleHelpGenerateWorkflow}`
+
+### 3. Module Type Installation
+
+**IF Extension:**
+- [ ] `code:` matches base (for proper merge)
+- [ ] Folder name is unique
+
+**IF Global:**
+- [ ] `global: true` or documented
+- [ ] Global impact is minimal/intentional
+
+### 4. Record Results
+
+Append to `{validationReportOutput}`:
+
+```markdown
+## Installation Readiness
+
+**Status:** {PASS/FAIL/WARNINGS}
+
+**Install Variables:** {count} variables
+**Install Variables:** {count} variables
+**Help Registry:** {present/missing} - {status}
+**Ready to Install:** {yes/no}
+
+**Issues Found:**
+{list any issues}
+```
+
+### 5. Auto-Proceed
+
+"**✓ Installation readiness check complete.**"
+
+Proceeding to final report...
+
+Load `{nextStepFile}`
+
+---
+
+## Success Metrics
+
+✅ Installation readiness assessed
+✅ module-help.csv presence and structure validated
+✅ Module type compatibility checked
+✅ Results recorded

package/src/bmb/workflows/module/steps-v/step-08-report.md

@@ -1,197 +1,197 @@
----
-name: 'step-08-report'
-description: 'Generate final validation report'
-
-validationReportOutput: '{validation_report_output}'
-agentValidationWorkflow: '{project-root}/_bmad/bmb/workflows/agent/steps-v/step-01-validate.md'
-workflowValidationWorkflow: '{project-root}/_bmad/bmb/workflows/workflow/steps-v/step-01-validate.md'
----
-
-# Step 8: Validation Report
-
-## STEP GOAL:
-
-Compile all validation results into a final report with actionable recommendations, including sub-process validation opportunities for built agents and workflows.
-
-## 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** — reporting results
-- ✅ Clear, actionable feedback
-- ✅ Sub-process validation for built components
-
----
-
-## MANDATORY SEQUENCE
-
-### 1. Compile Overall Status
-
-Review all validation sections and determine overall status:
-
-**PASS:** All checks passed, ready to proceed
-**WARNINGS:** Minor issues found, can proceed with fixes
-**FAIL:** Critical issues found, must fix before proceeding
-
-### 2. Generate Summary
-
-Add to `{validationReportOutput}`:
-
-```markdown
----
-
-## Overall Summary
-
-**Status:** {PASS/WARNINGS/FAIL}
-
-**Breakdown:**
-- File Structure: {status}
-- module.yaml: {status}
-- Agent Specs: {status} ({built_count} built, {spec_count} specs)
-- Workflow Specs: {status} ({built_count} built, {spec_count} specs)
-- Documentation: {status}
-- Installation Readiness: {status}
-
----
-
-## Component Status
-
-### Agents
-- **Built Agents:** {count} — {list}
-- **Spec Agents:** {count} — {list}
-
-### Workflows
-- **Built Workflows:** {count} — {list}
-- **Spec Workflows:** {count} — {list}
-
----
-
-## Recommendations
-
-{priority-listed-recommendations}
-
-### Priority 1 - Critical (must fix)
-
-{critical_issues}
-
-### Priority 2 - High (should fix)
-
-{high_priority_issues}
-
-### Priority 3 - Medium (nice to have)
-
-{medium_priority_issues}
-
----
-
-## Sub-Process Validation
-
-{if built_agents_exist}
-### Built Agent Deep Validation
-
-The following built agents can be validated in detail using the agent validation workflow:
-
-{for each built_agent}
-- **{agent_name}** — Use `{agentValidationWorkflow}`
-
-**Recommendation:** Run agent validation workflow on each built agent to verify:
-- Frontmatter completeness
-- Persona quality
-- Menu structure compliance
-- Sidecar validation
-
-**After fixing any module-level issues, I can spawn sub-processes to validate each built agent in parallel.**
-{endif}
-
-{if built_workflows_exist}
-### Built Workflow Deep Validation
-
-The following built workflows can be validated in detail using the workflow validation workflow:
-
-{for each built_workflow}
-- **{workflow_name}** — Use `{workflowValidationWorkflow}`
-
-**Recommendation:** Run workflow validation workflow on each built workflow to verify:
-- Step file compliance
-- Tri-modal structure (steps-c/steps-e/steps-v/)
-- Frontmatter completeness
-- Size limits compliance
-
-**After fixing any module-level issues, I can spawn sub-processes to validate each built workflow in parallel.**
-{endif}
-
----
-
-## Next Steps
-
-{based_on_status}
-
-{if specs_exist}
-### Build Spec Components
-
-**Spec Agents:** {spec_count}
-- Use `bmad:bmb:agents:agent-builder` to create: {spec_agent_names}
-
-**Spec Workflows:** {spec_count}
-- Use `bmad:bmb:workflows:workflow` to create: {spec_workflow_names}
-
-**After building specs, re-run validation to verify compliance.**
-{endif}
-
----
-
-**Validation Completed:** {timestamp}
-```
-
-### 3. Present Report
-
-"**✓ Validation complete!**"
-
-**Overall Status:** {overall_status}
-
-**Report saved to:** `{validationReportOutput}`
-
-{if built_components_exist}
-"**Built components found:**"
-- Built Agents: {count}
-- Built Workflows: {count}
-
-"**These can be validated in depth via sub-process.**"
-{endif}
-
-### 4. Offer Next Actions
-
-"**What would you like to do?**"
-
-- **[R]ead report** — Show the full validation report
-- **[S]ub-process validation** — Run deep validation on built agents/workflows
-- **[F]ix issues** — Edit mode to fix identified problems
-- **[D]one** — Complete validation
-
-### 5. Menu Handling
-
-- IF R: Display the full report
-- IF S:
-  - {if built_components_exist}
-  - Offer to run agent validation on built agents
-  - Offer to run workflow validation on built workflows
-  - Can run in parallel for efficiency
-  - {else}
-  - "No built components found for sub-process validation."
-  - {endif}
-- IF F: Offer to load Edit mode
-- IF D: Complete validation session
-
----
-
-## Success Metrics
-
-✅ Overall status determined
-✅ Complete report generated
-✅ Actionable recommendations provided
-✅ Sub-process validation opportunities identified
-✅ Next steps offered
+---
+name: 'step-08-report'
+description: 'Generate final validation report'
+
+validationReportOutput: '{validation_report_output}'
+agentValidationWorkflow: '{project-root}/_bmad/bmb/workflows/agent/steps-v/step-01-validate.md'
+workflowValidationWorkflow: '{project-root}/_bmad/bmb/workflows/workflow/steps-v/step-01-validate.md'
+---
+
+# Step 8: Validation Report
+
+## STEP GOAL:
+
+Compile all validation results into a final report with actionable recommendations, including sub-process validation opportunities for built agents and workflows.
+
+## 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** — reporting results
+- ✅ Clear, actionable feedback
+- ✅ Sub-process validation for built components
+
+---
+
+## MANDATORY SEQUENCE
+
+### 1. Compile Overall Status
+
+Review all validation sections and determine overall status:
+
+**PASS:** All checks passed, ready to proceed
+**WARNINGS:** Minor issues found, can proceed with fixes
+**FAIL:** Critical issues found, must fix before proceeding
+
+### 2. Generate Summary
+
+Add to `{validationReportOutput}`:
+
+```markdown
+---
+
+## Overall Summary
+
+**Status:** {PASS/WARNINGS/FAIL}
+
+**Breakdown:**
+- File Structure: {status}
+- module.yaml: {status}
+- Agent Specs: {status} ({built_count} built, {spec_count} specs)
+- Workflow Specs: {status} ({built_count} built, {spec_count} specs)
+- Documentation: {status}
+- Installation Readiness: {status}
+
+---
+
+## Component Status
+
+### Agents
+- **Built Agents:** {count} — {list}
+- **Spec Agents:** {count} — {list}
+
+### Workflows
+- **Built Workflows:** {count} — {list}
+- **Spec Workflows:** {count} — {list}
+
+---
+
+## Recommendations
+
+{priority-listed-recommendations}
+
+### Priority 1 - Critical (must fix)
+
+{critical_issues}
+
+### Priority 2 - High (should fix)
+
+{high_priority_issues}
+
+### Priority 3 - Medium (nice to have)
+
+{medium_priority_issues}
+
+---
+
+## Sub-Process Validation
+
+{if built_agents_exist}
+### Built Agent Deep Validation
+
+The following built agents can be validated in detail using the agent validation workflow:
+
+{for each built_agent}
+- **{agent_name}** — Use `{agentValidationWorkflow}`
+
+**Recommendation:** Run agent validation workflow on each built agent to verify:
+- Frontmatter completeness
+- Persona quality
+- Menu structure compliance
+- Sidecar validation
+
+**After fixing any module-level issues, I can spawn sub-processes to validate each built agent in parallel.**
+{endif}
+
+{if built_workflows_exist}
+### Built Workflow Deep Validation
+
+The following built workflows can be validated in detail using the workflow validation workflow:
+
+{for each built_workflow}
+- **{workflow_name}** — Use `{workflowValidationWorkflow}`
+
+**Recommendation:** Run workflow validation workflow on each built workflow to verify:
+- Step file compliance
+- Tri-modal structure (steps-c/steps-e/steps-v/)
+- Frontmatter completeness
+- Size limits compliance
+
+**After fixing any module-level issues, I can spawn sub-processes to validate each built workflow in parallel.**
+{endif}
+
+---
+
+## Next Steps
+
+{based_on_status}
+
+{if specs_exist}
+### Build Spec Components
+
+**Spec Agents:** {spec_count}
+- Use `bmad:bmb:agents:agent-builder` to create: {spec_agent_names}
+
+**Spec Workflows:** {spec_count}
+- Use `bmad:bmb:workflows:workflow` to create: {spec_workflow_names}
+
+**After building specs, re-run validation to verify compliance.**
+{endif}
+
+---
+
+**Validation Completed:** {timestamp}
+```
+
+### 3. Present Report
+
+"**✓ Validation complete!**"
+
+**Overall Status:** {overall_status}
+
+**Report saved to:** `{validationReportOutput}`
+
+{if built_components_exist}
+"**Built components found:**"
+- Built Agents: {count}
+- Built Workflows: {count}
+
+"**These can be validated in depth via sub-process.**"
+{endif}
+
+### 4. Offer Next Actions
+
+"**What would you like to do?**"
+
+- **[R]ead report** — Show the full validation report
+- **[S]ub-process validation** — Run deep validation on built agents/workflows
+- **[F]ix issues** — Edit mode to fix identified problems
+- **[D]one** — Complete validation
+
+### 5. Menu Handling
+
+- IF R: Display the full report
+- IF S:
+  - {if built_components_exist}
+  - Offer to run agent validation on built agents
+  - Offer to run workflow validation on built workflows
+  - Can run in parallel for efficiency
+  - {else}
+  - "No built components found for sub-process validation."
+  - {endif}
+- IF F: Offer to load Edit mode
+- IF D: Complete validation session
+
+---
+
+## Success Metrics
+
+✅ Overall status determined
+✅ Complete report generated
+✅ Actionable recommendations provided
+✅ Sub-process validation opportunities identified
+✅ Next steps offered