brachnha-insight/_bmad/bmb/workflows/workflow/steps-v/step-01b-structure.md

name, description, nextStepFile, targetWorkflowPath, workflowPlanFile, validationReportFile, stepFileRules

name	description	nextStepFile	targetWorkflowPath	workflowPlanFile	validationReportFile	stepFileRules
step-01-validate	Initialize validation: create report and check file structure & size	./step-02-frontmatter-validation.md	{workflow_folder_path}	{workflow_folder_path}/workflow-plan.md	{workflow_folder_path}/validation-report-{datetime}.md	../data/step-file-rules.md

Validation Step 1: File Structure & Size

STEP GOAL:

To create the validation report and check that the workflow has correct file structure and all step files are within size limits.

MANDATORY EXECUTION RULES (READ FIRST):

Universal Rules:

• 🛑 DO NOT BE LAZY - LOAD AND REVIEW EVERY FILE
• 📖 CRITICAL: Read the complete step file before taking any action
• 🔄 CRITICAL: When loading next step, ensure entire file is read
• ✅ Validation does NOT stop for user input - auto-proceed through all validation steps
• ⚙️ If any instruction references a subprocess, subagent, or tool you do not have access to, you MUST still achieve the outcome in your main context

Step-Specific Rules:

• 🎯 Create validation report with header structure using subprocess optimization when available
• 🚫 DO NOT skip checking any file - DO NOT BE LAZY
• 💬 Subprocess must either update validation report directly OR return structured findings to parent for aggregation
• 🚪 This is validation - systematic and thorough

EXECUTION PROTOCOLS:

• 🎯 Load and check EVERY file in the workflow using subprocess optimization when available - single subprocess for bash/grep operations, separate subprocess per file for size analysis
• 💾 Subprocesses must either update validation report OR return findings for parent aggregation
• 📖 Save report before loading next validation step
• 🚫 DO NOT halt for user input - validation runs to completion

MANDATORY SEQUENCE

CRITICAL: Follow this sequence exactly. Do not skip or shortcut.

1. Check Folder Structure

Launch a single subprocess that will do all of the following for items:

1. Load {stepFileRules} to understand:

• File size limits (<200 recommended, 250 max)
• Required folder structure
• Required files

2. Lists the entire folder structure using bash commands
3. Verifies all required folders and files exist
4. Returns structured findings to parent for aggregation

# List folder structure
find {targetWorkflowPath} -type f -name "*.md" | sort

Expected structure:

{targetWorkflowPath}/
├── workflow.md
├── steps*/ potentially more than one folder like this (such as steps-v, steps-c - the folder name is not critical but should make sense)
│   ├── step-01-init.md
│   ├── step-01b-continue.md (if continuable)
│   ├── step-02-*.md
│   └── ...
├── */ # any other random files - critical will be later ensure its all used - aside from potential documentation for user later.
├── data/
│   └── [as needed]
└── templates/
    └── [as needed]

Check:

• ✅ workflow.md exists
• ✅ step files are in a well organized folder
• ✅ non step reference files are organized in other folders such as data, templates, or others that make sense for the workflow
• ✅ Folder names make sense

4. Check File Sizes

DO NOT BE LAZY - For EACH step file in steps-c/, launch a subprocess that:

1. Loads that step file
2. Counts lines and checks against size limits
3. Returns structured findings to parent for aggregation

Limits:

• < 200 lines: ✅ Good
• 200-300 lines: ⚠️ Approaching limit

• 300 lines: ❌ Exceeds limit

Subprocess returns: File name, line count, status (Good/Approaching limit/Exceeds limit), and any issues found.

Subprocess must either:

• Update validation report directly with findings, OR
• Return structured findings to parent for aggregation into report

Document findings in validation report:

• List all step files checked with their line counts
• Note any files approaching or exceeding size limits (<200 recommended, 250 max)
• Check data and reference files for size issues (large files should be sharded or indexed)
• Identify specific size violations and recommendations

5. Verify File Presence

From the design in {workflowPlanFile}, verify:

• Every step from design has a corresponding file
• Step files are numbered sequentially
• No gaps in numbering
• Final step exists

6. Document all findings in a report

Document the following:

• Folder structure assessment
• Required files presence check
• File size analysis results
• List of any issues found (missing files, extra files, size violations, naming issues)
• Overall validation status (PASS/FAIL/WARNINGS)

7. Save Report

CRITICAL: Save the validation report BEFORE COMPLETING THIS STEP

Display: "File Structure & Size validation complete."

---

🚨 SYSTEM SUCCESS/FAILURE METRICS

✅ SUCCESS:

• Validation report created with header structure
• EVERY file checked for structure and size
• Findings appended to report
• Report saved before proceeding
• Next validation step loaded

❌ SYSTEM FAILURE:

• Not checking every file
• Skipping size checks
• Not saving report before proceeding
• Halting for user input

Master Rule: Validation is systematic and thorough. DO NOT BE LAZY. Check EVERY file. Auto-proceed through all validation steps.