Files
BMAD-METHOD/.bmad/bmb/workflows/edit-workflow/checklist.md
Brian Madison 7eb52520fa Major Enhancements:
- Installation path is now fully configurable, allowing users to specify custom installation directories during setup
  - Default installation location changed to .bmad (hidden directory) for cleaner project root organization

    Web Bundle Improvements:

    - All web bundles (single agent and team) now include party mode support for multi-agent collaboration!
    - Advanced elicitation capabilities integrated into standalone agents
    - All bundles enhanced with party mode agent manifests
    - Added default-party.csv files to bmm, bmgd, and cis module teams
    - The default party file is what will be used with single agent bundles. teams can customize for different party configurations before web bundling through a setting in the team yaml file
    - New web bundle outputs for all agents (analyst, architect, dev, pm, sm, tea, tech-writer, ux-designer, game-*, creative-squad)

    Phase 4 Workflow Updates (In Progress):

    - Initiated shift to separate phase 4 implementation artifacts from documentation
        - Phase 4 implementation artifacts (stories, code review, sprint plan, context files) will move to dedicated location outside docs folder
        - Installer questions and configuration added for artifact path selection
        - Updated workflow.yaml files for code-review, sprint-planning, story-context, epic-tech-context, and retrospective workflows to support this, but still might require some udpates

    Additional Changes:

    - New agent and action command header models for standardization
    - Enhanced web-bundle-activation-steps fragment
    - Updated web-bundler.js to support new structure
    - VS Code settings updated for new .bmad directory
    - Party mode instructions and workflow enhanced for better orchestration

   IDE Installer Updates:

    - Show version number of installer in cli
    - improved Installer UX
    - Gemini TOML Improved to have clear loading instructions with @ commands
    - All tools agent launcher mds improved to use a central file template critical indication isntead of hardcoding in 2 different locations.
2025-11-09 17:39:05 -06:00

2.8 KiB

Edit Workflow - Validation Checklist

Pre-Edit Analysis

  • Target workflow.yaml file successfully loaded and parsed
  • All referenced workflow files identified and accessible
  • Workflow type correctly determined (document/action/interactive/autonomous/meta)
  • Best practices guide loaded and available for reference

Edit Execution Quality

  • User clearly informed of identified issues with priority levels
  • Edit menu presented with all 8 standard options
  • Selected edit type matches the actual changes made
  • All proposed changes explained with reasoning before application

File Integrity

  • All modified files maintain valid YAML/Markdown syntax
  • No placeholders like {TITLE} or {WORKFLOW_CODE} remain in edited files
  • File paths use proper variable substitution ({project-root}, {installed_path})
  • All file references resolve to actual paths

Convention Compliance

  • Instructions.md contains critical workflow engine reference header
  • Instructions.md contains workflow.yaml processing reference header
  • All step numbers are sequential (1, 2, 3... or 1a, 1b, 2a...)
  • Each step has both n= attribute and goal= attribute
  • Variable names use snake_case consistently
  • Template variables (if any) match tags exactly

Instruction Quality

  • Each step has a single, clear goal stated
  • Instructions are specific with quantities (e.g., "3-5 items" not "several items")
  • Optional steps marked with optional="true" attribute
  • Repeating steps use proper repeat syntax (repeat="3" or repeat="until-complete")
  • User prompts use tags and wait for response
  • Actions use tags for required operations

Validation Criteria (if checklist.md exists)

  • All checklist items are measurable and specific
  • No vague criteria like "Good documentation" present
  • Checklist organized into logical sections
  • Each criterion can be objectively verified as true/false

Change Documentation

  • All changes logged with description of what and why
  • Change summary includes list of modified files
  • Improvements clearly articulated in relation to best practices
  • Next steps or recommendations provided

Post-Edit Verification

  • Edited workflow follows patterns from production examples
  • No functionality broken by the edits
  • Workflow ready for testing or production use
  • User given option to test the edited workflow

Common Issues Resolved

  • Missing critical headers added if they were absent
  • Broken variable references fixed
  • Vague instructions made specific
  • Template-only workflows have template.md file
  • Action workflows have template: false in workflow.yaml
  • Step count reasonable (5-10 steps maximum unless justified)