BMAD-METHOD/src/modules/bmb/docs/workflows/index.md

1.8 KiB

BMAD Workflows Documentation

Welcome to the BMAD Workflows documentation - a modern system for creating structured, collaborative workflows optimized for AI execution.

📚 Core Documentation

Terms

Essential terminology and concepts for understanding BMAD workflows.

Architecture & Execution Model

The micro-file architecture, JIT step loading, state management, and collaboration patterns that make BMAD workflows optimal for AI execution.

Writing Workflows

Complete guide to creating workflows: workflow.md control files, step files, CSV data integration, and frontmatter design.

Step Files & Dialog Patterns

Crafting effective step files: structure, execution rules, prescriptive vs intent-based dialog, and validation patterns.

Templates & Content Generation

Creating append-only templates, frontmatter design, conditional content, and dynamic content generation strategies.

Workflow Patterns

Common workflow types: linear, conditional, protocol integration, multi-agent workflows, and real-world examples.

Migration Guide

Converting from XML-heavy workflows to the new pure markdown format, with before/after examples and checklist.

Best Practices & Reference

Critical rules, anti-patterns, performance optimization, debugging, quick reference templates, and troubleshooting.

🚀 Quick Start

BMAD workflows are pure markdown, self-contained systems that guide collaborative processes through structured step files where the AI acts as a facilitator working with humans.


This documentation covers the next generation of BMAD workflows - designed from the ground up for optimal AI-human collaboration.