feat(quality): add markdownlint-cli2 to quality checks (#1039)

- Add markdownlint-cli2 as dev dependency
- Add lint:md script to package.json
- Add markdownlint job to CI workflow
- Configure 5 rules: heading-increment, no-duplicate-heading,
  no-trailing-punctuation, no-bare-urls, no-space-in-emphasis
- Fix existing violations across 19 markdown files
- No auto-fix to prevent destructive changes

Closes #1034

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: Brian <bmadcode@gmail.com>

src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-05-shopping.md

@@ -132,7 +132,7 @@ You are a **strategic shopping partner** who:
 - Plans for real-life shopping scenarios
 - Minimizes food waste thoughtfully
 
-## 📝 OUTPUT REQUIREMENTS:
+## 📊 STATUS UPDATE:
 
 Update workflow.md frontmatter:
 

src/modules/bmb/workflows/create-workflow/steps/step-09-complete.md

@@ -156,7 +156,7 @@ Update {workflowPlanFile} frontmatter:
 
 Display: **Workflow Creation Complete!** [T] Test Workflow [M] Make Adjustments [D] Get Help
 
-#### Menu Handling Logic:
+### Menu Handling Logic:
 
 - IF T: Offer to run the newly created workflow with sample data
 - IF M: Offer to make specific adjustments to the workflow

src/modules/bmb/workflows/edit-agent/steps/step-02-analyze-agent.md

@@ -85,9 +85,9 @@ Load the agent file from the path provided in step 1:
 
 - Load and read the .agent.yaml file from inside the folder
 - Inventory all sidecar files in the folder:
-  - Templates (_.md, _.txt)
+  - Templates (`_.md`, `_.txt`)
   - Documentation files
-  - Knowledge base files (_.csv, _.json, \*.yaml)
+  - Knowledge base files (`_.csv`, `_.json`, `*.yaml`)
   - Any other resources referenced by the agent
 - Note: Expert agent with sidecar structure
 

src/modules/bmb/workflows/edit-workflow/steps/step-04-validate.md

@@ -152,7 +152,7 @@ Then load and append content from {completionTemplate}
 
 Display: **Select an Option:** [A] Advanced Elicitation [P] Party Mode [C] Continue
 
-#### EXECUTION RULES:
+### EXECUTION RULES:
 
 - ALWAYS halt and wait for user input after presenting menu
 - ONLY proceed to next step when user selects 'C'