5 levels of scale adaption compressed to 3 clear distinctions driven by user preference and project needs

This commit is contained in:
Brian Madison 2025-11-03 17:06:15 -06:00
parent 750024fb14
commit 88d043245f
24 changed files with 1512 additions and 1467 deletions

View File

@ -22,10 +22,6 @@ agent:
workflow: "{project-root}/bmad/bmm/workflows/workflow-status/workflow.yaml"
description: Check workflow status and get recommendations
- trigger: correct-course
workflow: "{project-root}/bmad/bmm/workflows/4-implementation/correct-course/workflow.yaml"
description: Course Correction Analysis
- trigger: create-architecture
workflow: "{project-root}/bmad/bmm/workflows/3-solutioning/architecture/workflow.yaml"
description: Produce a Scale Adaptive Architecture

View File

@ -20,20 +20,16 @@ agent:
menu:
- trigger: workflow-status
workflow: "{project-root}/bmad/bmm/workflows/workflow-status/workflow.yaml"
description: Check workflow status and get recommendations
description: "Check workflow status and get recommendations"
- trigger: create-story
workflow: "{project-root}/bmad/bmm/workflows/4-implementation/create-story/workflow.yaml"
description: Create Development Story
- trigger: dev-story
- trigger: develop-story
workflow: "{project-root}/bmad/bmm/workflows/4-implementation/dev-story/workflow.yaml"
description: Implement Story with Context
description: "Execute Dev Story workflow, implementing tasks and tests, or performing updates to the story"
- trigger: story-done
workflow: "{project-root}/bmad/bmm/workflows/4-implementation/story-done/workflow.yaml"
description: "Mark story done after DoD complete"
- trigger: code-review
workflow: "{project-root}/bmad/bmm/workflows/4-implementation/code-review/workflow.yaml"
description: Review Story Implementation
- trigger: retro
workflow: "{project-root}/bmad/bmm/workflows/4-implementation/retrospective/workflow.yaml"
description: Sprint Retrospective
description: "Perform a thorough clean context QA code review on a story flagged Ready for Review"

View File

@ -31,7 +31,7 @@ agent:
- trigger: epic-tech-context
workflow: "{project-root}/bmad/bmm/workflows/4-implementation/epic-tech-context/workflow.yaml"
description: (Optional) Use the PRD and Architecture to create a Tech-Spec for a specific epic
description: (Optional) Use the PRD and Architecture to create a Epic-Tech-Spec for a specific epic
- trigger: validate-epic-tech-context
validate-workflow: "{project-root}/bmad/bmm/workflows/4-implementation/epic-tech-context/workflow.yaml"

View File

@ -23,12 +23,12 @@ Complete guides for the BMad Method Module (BMM) - AI-powered agile development
Understanding how BMM adapts to your needs:
- **[Scale Adaptive System](./scale-adaptive-system.md)** - How BMM adapts to project size and complexity (42 min read)
- The five complexity levels (0-4)
- Automatic level detection
- Documentation requirements per level
- Three planning tracks (Quick Flow, BMad Method, Enterprise Method)
- Automatic track recommendation
- Documentation requirements per track
- Planning workflow routing
- **[Quick Spec Flow](./quick-spec-flow.md)** - Fast-track workflow for Level 0-1 projects (26 min read)
- **[Quick Spec Flow](./quick-spec-flow.md)** - Fast-track workflow for Quick Flow track (26 min read)
- Bug fixes and small features
- Rapid prototyping approach
- Auto-detection of stack and patterns
@ -62,7 +62,7 @@ Comprehensive guide for brownfield development:
- **[Brownfield Development Guide](./brownfield-guide.md)** - Complete guide for existing codebases (53 min read)
- Documentation phase strategies
- Level detection for brownfield
- Track selection for brownfield
- Integration with existing patterns
- Phase-by-phase workflow guidance
- Common scenarios and troubleshooting
@ -86,7 +86,7 @@ Essential reference materials:
**Build something new (greenfield)**
→ Start with [Quick Start Guide](./quick-start.md)
→ Then review [Scale Adaptive System](./scale-adaptive-system.md) to understand levels
→ Then review [Scale Adaptive System](./scale-adaptive-system.md) to understand tracks
**Fix a bug or add small feature**
→ Go directly to [Quick Spec Flow](./quick-spec-flow.md)
@ -95,7 +95,7 @@ Essential reference materials:
→ Read [Brownfield Development Guide](./brownfield-guide.md)
→ Pay special attention to Phase 0 documentation requirements
**Understand project complexity levels**
**Understand planning tracks and methodology**
→ See [Scale Adaptive System](./scale-adaptive-system.md)
**Find specific commands or answers**
@ -114,12 +114,12 @@ Comprehensive documentation for all BMM workflows organized by phase:
- **[Phase 2: Planning Workflows](./workflows-planning.md)** - Scale-adaptive planning (967 lines)
- prd, tech-spec, gdd, narrative, ux
- Level 0-4 planning approach
- Track-based planning approach (Quick Flow, BMad Method, Enterprise Method)
- Which planning workflow to use
- **[Phase 3: Solutioning Workflows](./workflows-solutioning.md)** - Architecture and validation (638 lines)
- architecture, solutioning-gate-check
- Required for Level 3-4 projects
- Required for BMad Method and Enterprise Method tracks
- Preventing agent conflicts
- **[Phase 4: Implementation Workflows](./workflows-implementation.md)** - Sprint-based development (1,634 lines)

View File

@ -144,11 +144,7 @@ The BMad Method Module (BMM) provides a comprehensive team of specialized AI age
**Workflows:**
- `workflow-status` - Check what to do next
- `create-architecture` - Decision-focused architecture with:
- Starter template intelligence
- Novel pattern design
- Implementation patterns for agent consistency
- Adaptive facilitation (beginner/expert)
- `create-architecture` - Decision-focused architecture with
- `validate-architecture` - Validate architecture document
- `solutioning-gate-check` - Validate readiness for Phase 4
- `correct-course` - Handle technical changes

View File

@ -35,21 +35,21 @@ Brownfield projects involve working within existing codebases rather than starti
## Getting Started
### Understanding Project Levels
### Understanding Planning Tracks
For complete level details, see [Scale Adaptive System](./scale-adaptive-system.md).
For complete track details, see [Scale Adaptive System](./scale-adaptive-system.md).
**Brownfield levels at a glance:**
**Brownfield tracks at a glance:**
| Level | Scope | Stories | Key Difference |
| ----- | -------------------- | ------- | ---------------------------------- |
| **0** | Bug fix | 1 | Must understand affected code |
| **1** | Small feature | 1-10 | Respect existing patterns |
| **2** | Feature set | 5-15 | Integrate with architecture |
| **3** | Complex integration | 12-40 | Review existing architecture first |
| **4** | Enterprise expansion | 40+ | Full system documentation required |
| Track | Scope | Typical Stories | Key Difference |
| --------------------- | -------------------------- | --------------- | ----------------------------------------------- |
| **Quick Flow** | Bug fixes, small features | 1-15 | Must understand affected code and patterns |
| **BMad Method** | Feature sets, integrations | 10-50+ | Integrate with existing architecture |
| **Enterprise Method** | Enterprise expansions | 30+ | Full system documentation + compliance required |
### Level Detection for Brownfield
**Note:** Story counts are guidance, not definitions. Tracks are chosen based on planning needs.
### Track Selection for Brownfield
When you run `workflow-init`, it handles brownfield intelligently:
@ -69,23 +69,23 @@ When you run `workflow-init`, it handles brownfield intelligently:
**Step 3: Analyzes your description**
- Keywords: "fix" → Level 0, "add feature" → Level 1, "dashboard" → Level 2
- Story count estimation
- Confirms suggested level with you
- Keywords: "fix", "bug" → Quick Flow, "dashboard", "platform" → BMad Method, "enterprise", "multi-tenant" → Enterprise Method
- Complexity assessment
- Confirms suggested track with you
**Key Principle:** System asks about YOUR current work first, uses old artifacts as context only.
**Example: Old Level 3 PRD, New Level 0 Work**
**Example: Old Complex PRD, New Simple Work**
```
System: "Found PRD.md (Level 3, 30 stories, 6 months old)"
System: "Found PRD.md (BMad Method track, 30 stories, 6 months old)"
System: "Is this work in progress or previous effort?"
You: "Previous effort - I'm just fixing a bug now"
System: "Tell me about your current work"
You: "Update payment method enums"
System: "Level 0 brownfield. Correct?"
System: "Quick Flow track (tech-spec approach). Correct?"
You: "Yes"
✅ Creates Level 0 workflow
✅ Creates Quick Flow workflow
```
---
@ -140,14 +140,14 @@ If `docs/index.md` exists with comprehensive content, skip to Phase 1 or 2.
Without it, workflows lack context:
- **tech-spec** (Level 0-1) can't auto-detect stack/patterns
- **PRD** (Level 2-4) can't reference existing code
- **architecture** (Level 3-4) can't build on existing structure
- **tech-spec** (Quick Flow) can't auto-detect stack/patterns
- **PRD** (BMad Method/Enterprise) can't reference existing code
- **architecture** (BMad Method/Enterprise) can't build on existing structure
- **story-context** can't inject pattern-specific guidance
---
## Workflow Phases by Level
## Workflow Phases by Track
### Phase 1: Analysis (Optional)
@ -155,7 +155,7 @@ Without it, workflows lack context:
- `brainstorm-project` - Solution exploration
- `research` - Technical/market research
- `product-brief` - Strategic planning
- `product-brief` - Strategic planning (BMad Method/Enterprise tracks only)
**When to use:** Complex features, technical decisions, strategic additions
@ -165,24 +165,24 @@ See [Workflows Guide](../workflows/README.md) for details.
### Phase 2: Planning (Required)
**Planning approach adapts by level:**
**Planning approach adapts by track:**
**Level 0-1:** Use `tech-spec` workflow
**Quick Flow:** Use `tech-spec` workflow
- Creates tech-spec.md
- Auto-detects existing stack (brownfield)
- Confirms conventions with you
- Generates implementation-ready stories
**Level 2-4:** Use `prd` workflow
**BMad Method/Enterprise:** Use `prd` workflow
- Creates PRD.md + epics.md
- Creates PRD.md + epic breakdown
- References existing architecture
- Plans integration points
**Brownfield-specific:** See [Scale Adaptive System](./scale-adaptive-system.md) for complete workflow paths by level.
**Brownfield-specific:** See [Scale Adaptive System](./scale-adaptive-system.md) for complete workflow paths by track.
### Phase 3: Solutioning (Level 2-4 Only)
### Phase 3: Solutioning (BMad Method/Enterprise Only)
**Critical for brownfield:**
@ -193,12 +193,10 @@ See [Workflows Guide](../workflows/README.md) for details.
**Workflows:**
- `architecture-review` - Understand existing (Level 3-4)
- `integration-planning` - Plan integration approach (Level 3-4)
- `create-architecture` - Extend architecture docs (Level 2-4)
- `solutioning-gate-check` - Validate before implementation (Level 3-4)
- `create-architecture` - Extend architecture docs (BMad Method/Enterprise)
- `solutioning-gate-check` - Validate before implementation (BMad Method/Enterprise)
### Phase 4: Implementation (All Levels)
### Phase 4: Implementation (All Tracks)
**Sprint-based development through story iteration:**
@ -307,10 +305,12 @@ Document in tech-spec/architecture:
## Common Scenarios
### Scenario 1: Bug Fix (Level 0)
### Scenario 1: Bug Fix (Quick Flow)
**Situation:** Authentication token expiration causing logout issues
**Track:** Quick Flow
**Workflow:**
1. **Document:** Skip if auth system documented, else run `document-project` (Quick scan)
@ -326,10 +326,12 @@ Document in tech-spec/architecture:
---
### Scenario 2: Small Feature (Level 1)
### Scenario 2: Small Feature (Quick Flow)
**Situation:** Add "forgot password" to existing auth system
**Track:** Quick Flow
**Workflow:**
1. **Document:** Run `document-project` (Deep scan of auth module if not documented)
@ -346,37 +348,40 @@ Document in tech-spec/architecture:
---
### Scenario 3: Feature Set (Level 2)
### Scenario 3: Feature Set (BMad Method)
**Situation:** Add user dashboard with analytics, preferences, activity
**Track:** BMad Method
**Workflow:**
1. **Document:** Run `document-project` (Deep scan) - Critical for understanding existing UI patterns
2. **Analyze:** Load Analyst → `research` (if evaluating analytics libraries)
3. **Plan:** Load PM → `prd`
4. **Implement:** Sprint-based (10-15 stories)
4. **Solution:** Load Architect → `create-architecture``solutioning-gate-check`
5. **Implement:** Sprint-based (10-15 stories)
- Load SM → `sprint-planning`
- Per epic: `epic-tech-context` → stories
- Load DEV → `dev-story` per story
5. **Review:** Per story completion
6. **Review:** Per story completion
**Time:** 1-2 weeks
---
### Scenario 4: Complex Integration (Level 3)
### Scenario 4: Complex Integration (BMad Method)
**Situation:** Add real-time collaboration to document editor
**Track:** BMad Method
**Workflow:**
1. **Document:** Run `document-project` (Exhaustive if not documented) - **Mandatory**
2. **Analyze:** Load Analyst → `research` (WebSocket vs WebRTC vs CRDT)
3. **Plan:** Load PM → `prd`
4. **Solution:**
- Load Architect → `architecture-review` (understand existing editor)
- Load Architect → `integration-planning` (WebSocket integration strategy)
- Load Architect → `create-architecture` (extend for real-time layer)
- Load Architect → `solutioning-gate-check`
5. **Implement:** Sprint-based (20-30 stories)
@ -385,10 +390,12 @@ Document in tech-spec/architecture:
---
### Scenario 5: Enterprise Expansion (Level 4)
### Scenario 5: Enterprise Expansion (Enterprise Method)
**Situation:** Add multi-tenancy to single-tenant SaaS platform
**Track:** Enterprise Method
**Workflow:**
1. **Document:** Run `document-project` (Exhaustive) - **Mandatory**
@ -398,7 +405,7 @@ Document in tech-spec/architecture:
- `product-brief` - Strategic document
3. **Plan:** Load PM → `prd` (comprehensive)
4. **Solution:**
- `architecture-review` - Full system review
- `create-architecture` - Full system architecture
- `integration-planning` - Phased migration strategy
- `create-architecture` - Multi-tenancy architecture
- `validate-architecture` - External review
@ -456,7 +463,7 @@ For complete troubleshooting, see [Troubleshooting Guide](./troubleshooting.md).
- Which existing modules to modify
- What APIs/services to integrate with
- Data flow between new and existing code
4. Run `integration-planning` workflow (Level 3-4)
4. Review architecture document for integration guidance
### Existing Tests Breaking
@ -504,21 +511,19 @@ document-project # Create comprehensive docs (10-30min)
# Analyst agent:
brainstorm-project # Explore solutions
research # Gather data
product-brief # Strategic planning
product-brief # Strategic planning (BMad Method/Enterprise only)
# Phase 2: Planning (Required)
# PM agent:
tech-spec # Level 0-1
prd # Level 2-4
tech-spec # Quick Flow track
prd # BMad Method/Enterprise tracks
# Phase 3: Solutioning (Level 2-4)
# Phase 3: Solutioning (BMad Method/Enterprise)
# Architect agent:
architecture-review # Review existing (L3-4)
integration-planning # Plan integration (L3-4)
create-architecture # Extend architecture (L2-4)
solutioning-gate-check # Final approval (L3-4)
create-architecture # Extend architecture
solutioning-gate-check # Final validation
# Phase 4: Implementation (All Levels)
# Phase 4: Implementation (All Tracks)
# SM agent:
sprint-planning # Initialize tracking
epic-tech-context # Epic context
@ -545,17 +550,17 @@ correct-course # If issues
**Phase 1-3 Tracking:**
- `docs/bmm-workflow-status.md` - Progress tracker
- `docs/bmm-workflow-status.yaml` - Progress tracker
**Phase 2 Planning:**
- `docs/tech-spec.md` (Level 0-1)
- `docs/PRD.md` (Level 2-4)
- `docs/epics.md` (Level 2-4)
- `docs/tech-spec.md` (Quick Flow track)
- `docs/PRD.md` (BMad Method/Enterprise tracks)
- Epic breakdown
**Phase 3 Architecture:**
- `docs/architecture.md` (Level 2-4)
- `docs/architecture.md` (BMad Method/Enterprise tracks)
**Phase 4 Implementation:**
@ -573,13 +578,13 @@ flowchart TD
START --> CHECK
CHECK -->|No| DOC[document-project<br/>Deep scan]
CHECK -->|Yes| LEVEL{What Level?}
CHECK -->|Yes| TRACK{What Track?}
DOC --> LEVEL
DOC --> TRACK
LEVEL -->|0-1| TS[tech-spec]
LEVEL -->|2| PRD[prd]
LEVEL -->|3-4| PRD2[prd → architecture]
TRACK -->|Quick Flow| TS[tech-spec]
TRACK -->|BMad Method| PRD[prd → architecture]
TRACK -->|Enterprise| PRD2[prd → arch + security/devops]
TS --> IMPL[Phase 4<br/>Implementation]
PRD --> IMPL
@ -600,7 +605,7 @@ flowchart TD
2. ✅ **Use fresh chats for complex workflows** - Prevents hallucinations
3. ✅ **Verify files exist before workflows** - Check PRD, epics, stories present
4. ✅ **Read agent menu first** - Confirm agent has the workflow
5. ✅ **Start with smaller level if unsure** - Easy to upgrade (L1 → L2)
5. ✅ **Start with simpler track if unsure** - Easy to upgrade (Quick Flow → BMad Method)
6. ✅ **Keep status files updated** - Manual updates when needed
7. ✅ **Run retrospectives after epics** - Catch issues early
8. ✅ **Follow phase sequence** - Don't skip required phases
@ -609,8 +614,8 @@ flowchart TD
## Related Documentation
- **[Scale Adaptive System](./scale-adaptive-system.md)** - Understanding levels and complexity
- **[Quick Spec Flow](./quick-spec-flow.md)** - Fast-track for Level 0-1
- **[Scale Adaptive System](./scale-adaptive-system.md)** - Understanding tracks and complexity
- **[Quick Spec Flow](./quick-spec-flow.md)** - Fast-track for Quick Flow
- **[Quick Start Guide](./quick-start.md)** - Getting started with BMM
- **[Glossary](./glossary.md)** - Key terminology
- **[FAQ](./faq.md)** - Common questions

View File

@ -29,7 +29,7 @@ The complete methodology for AI-assisted software development, encompassing plan
### Scale-Adaptive System
BMad Method's intelligent workflow orchestration that automatically adjusts planning depth, documentation requirements, and implementation processes based on project size and complexity (Levels 0-4).
BMad Method's intelligent workflow orchestration that automatically adjusts planning depth, documentation requirements, and implementation processes based on project needs through three distinct planning tracks (Quick Flow, BMad Method, Enterprise Method).
### Agent
@ -43,29 +43,23 @@ A multi-step guided process that orchestrates AI agent activities to produce spe
## Scale & Complexity
### Level 0 (Single Atomic Change)
### Quick Flow Track
Single-story projects like bug fixes, typos, or small patches. Uses tech-spec only, no architecture needed. Estimated completion: hours.
Fast implementation track using tech-spec planning only. Best for bug fixes, small features, and changes with clear scope. Typical range: 1-15 stories. No architecture phase needed. Examples: bug fixes, OAuth login, search features.
### Level 1 (Small Feature)
### BMad Method Track
Projects with 1-10 stories, typically 2-3 related changes. Examples: OAuth login, search feature, user profile page. Uses tech-spec with epic breakdown.
Full product planning track using PRD + Architecture + UX. Best for products, platforms, and complex features requiring system design. Typical range: 10-50+ stories. Examples: admin dashboards, e-commerce platforms, SaaS products.
### Level 2 (Medium Project)
### Enterprise Method Track
Projects with 5-15 stories across multiple epics. Examples: admin dashboard, customer portal, reporting system. Uses PRD + optional architecture.
Extended enterprise planning track adding Security Architecture, DevOps Strategy, and Test Strategy to BMad Method. Best for enterprise requirements, compliance needs, and multi-tenant systems. Typical range: 30+ stories. Examples: multi-tenant platforms, compliance-driven systems, mission-critical applications.
### Level 3 (Complex Integration)
### Planning Track
Projects with 12-40 stories involving subsystems and integrations. Examples: e-commerce platform, SaaS product, multi-module system. Requires PRD + comprehensive architecture.
The methodology path (Quick Flow, BMad Method, or Enterprise Method) chosen for a project based on planning needs, complexity, and requirements rather than story count alone.
### Level 4 (Enterprise Scale)
Projects with 40+ stories across products. Examples: multi-tenant systems, product ecosystems, platform expansions. Requires full methodology with strategic planning.
### Complexity Level
The scale rating (0-4) assigned to a project based on story count, integration requirements, team size, and architectural complexity.
**Note:** Story counts are guidance, not definitions. Tracks are determined by what planning the project needs, not story math.
---
@ -73,23 +67,23 @@ The scale rating (0-4) assigned to a project based on story count, integration r
### Tech-Spec (Technical Specification)
**Level 0-1 only.** Comprehensive technical plan created upfront that serves as the primary planning document for small changes or features. Contains problem statement, solution approach, file-level changes, stack detection (brownfield), testing strategy, and developer resources.
**Quick Flow track only.** Comprehensive technical plan created upfront that serves as the primary planning document for small changes or features. Contains problem statement, solution approach, file-level changes, stack detection (brownfield), testing strategy, and developer resources.
### Epic-Tech-Spec (Epic Technical Specification)
**Level 2-4 only.** Detailed technical planning document created during implementation (just-in-time) for each epic. Supplements PRD + Architecture with epic-specific implementation details, code-level design decisions, and integration points.
**BMad Method/Enterprise tracks only.** Detailed technical planning document created during implementation (just-in-time) for each epic. Supplements PRD + Architecture with epic-specific implementation details, code-level design decisions, and integration points.
**Key Difference:** Tech-spec (Level 0-1) is created upfront and is the only planning doc. Epic-tech-spec (Level 2-4) is created per epic during implementation and supplements PRD + Architecture.
**Key Difference:** Tech-spec (Quick Flow) is created upfront and is the only planning doc. Epic-tech-spec (BMad Method/Enterprise) is created per epic during implementation and supplements PRD + Architecture.
### PRD (Product Requirements Document)
**Level 2-4.** Product-level planning document containing vision, goals, feature requirements, epic breakdown, success criteria, and UX considerations. Replaces tech-spec for larger projects that need product planning.
**BMad Method/Enterprise tracks.** Product-level planning document containing vision, goals, feature requirements, epic breakdown, success criteria, and UX considerations. Replaces tech-spec for larger projects that need product planning.
### Architecture Document
**Level 2-4.** System-wide design document defining structure, components, interactions, data models, integration patterns, security, performance, and deployment. Optional for Level 2, required for Level 3-4.
**BMad Method/Enterprise tracks.** System-wide design document defining structure, components, interactions, data models, integration patterns, security, performance, and deployment.
**Scale-Adaptive:** Architecture complexity scales with level - Level 2 is lightweight, Level 4 is enterprise-grade.
**Scale-Adaptive:** Architecture complexity scales with track - BMad Method is lightweight to moderate, Enterprise Method is comprehensive with security/devops/test strategies.
### Epics
@ -113,15 +107,15 @@ Game development equivalent of PRD, created by Game Designer agent for game proj
### Phase 1: Analysis (Optional)
Discovery and research phase including brainstorming, research workflows, and product brief creation. Optional for small projects (Level 0-1), recommended for Level 2, required for Level 3-4.
Discovery and research phase including brainstorming, research workflows, and product brief creation. Optional for Quick Flow, recommended for BMad Method, required for Enterprise Method.
### Phase 2: Planning (Required)
**Always required.** Creates formal requirements and work breakdown. Routes to tech-spec (Level 0-1) or PRD (Level 2-4) based on detected complexity level.
**Always required.** Creates formal requirements and work breakdown. Routes to tech-spec (Quick Flow) or PRD (BMad Method/Enterprise) based on selected track.
### Phase 3: Solutioning (Conditional)
### Phase 3: Solutioning (Track-Dependent)
Architecture design phase. Optional for Level 2, required for Level 3-4. Includes architecture creation, validation, and gate checks.
Architecture design phase. Required for BMad Method and Enterprise Method tracks. Includes architecture creation, validation, and gate checks.
### Phase 4: Implementation (Required)
@ -129,7 +123,7 @@ Sprint-based development through story-by-story iteration. Uses sprint-planning,
### Quick Spec Flow
Fast-track workflow system for Level 0-1 projects that goes straight from idea to tech-spec to implementation, bypassing heavy planning. Designed for bug fixes, small features, and rapid prototyping.
Fast-track workflow system for Quick Flow track projects that goes straight from idea to tech-spec to implementation, bypassing heavy planning. Designed for bug fixes, small features, and rapid prototyping.
### Just-In-Time Design
@ -153,11 +147,11 @@ Agent that initializes workflows, conducts research, creates product briefs, and
### Architect
Agent that designs system architecture, creates architecture documents, performs technical reviews, and validates designs. Primary agent for Phase 3.
Agent that designs system architecture, creates architecture documents, performs technical reviews, and validates designs. Primary agent for Phase 3 solutioning.
### SM (Scrum Master)
Agent that manages sprints, creates stories, generates contexts, and coordinates implementation. Primary orchestrator for Phase 4.
Agent that manages sprints, creates stories, generates contexts, and coordinates implementation. Primary orchestrator for Phase 4 implementation.
### DEV (Developer)
@ -191,9 +185,9 @@ Multi-agent collaboration feature where all installed agents (19+ from BMM, CIS,
## Status & Tracking
### bmm-workflow-status.md
### bmm-workflow-status.yaml
**Phases 0-3.** Tracking file that shows current phase, completed workflows, progress, and next recommended actions. Created by workflow-init, updated automatically.
**Phases 1-3.** Tracking file that shows current phase, completed workflows, progress, and next recommended actions. Created by workflow-init, updated automatically.
### sprint-status.yaml
@ -269,7 +263,7 @@ Workflow that initializes Phase 4 implementation by creating sprint-status.yaml,
### Gate Check
Validation workflow (solutioning-gate-check) run before Phase 4 to ensure PRD, architecture, and UX documents are cohesive with no gaps or contradictions. Required for Level 3-4.
Validation workflow (solutioning-gate-check) run before Phase 4 to ensure PRD, architecture, and UX documents are cohesive with no gaps or contradictions. Required for BMad Method and Enterprise Method tracks.
### DoD (Definition of Done)
@ -289,11 +283,11 @@ Universal entry point workflow that checks for existing status file, displays cu
### Workflow Init
Initialization workflow that creates bmm-workflow-status.md, detects greenfield vs brownfield, determines complexity level, and sets up appropriate workflow path.
Initialization workflow that creates bmm-workflow-status.yaml, detects greenfield vs brownfield, determines planning track, and sets up appropriate workflow path.
### Level Detection
### Track Selection
Automatic analysis by workflow-init that uses keyword analysis, story count estimation, and complexity indicators to suggest appropriate level (0-4). User can override suggested level.
Automatic analysis by workflow-init that uses keyword analysis, complexity indicators, and project requirements to suggest appropriate track (Quick Flow, BMad Method, or Enterprise Method). User can override suggested track.
### Correct Course
@ -305,7 +299,7 @@ Plan for handling changes to existing data, schemas, APIs, or patterns during br
### Feature Flags
Implementation technique for brownfield projects that allows gradual rollout of new functionality, easy rollback, and A/B testing. Recommended for Level 2+ brownfield changes.
Implementation technique for brownfield projects that allows gradual rollout of new functionality, easy rollback, and A/B testing. Recommended for BMad Method and Enterprise brownfield changes.
### Integration Points
@ -320,8 +314,8 @@ Quick Spec Flow feature that automatically detects existing code style, naming c
## Related Documentation
- [Quick Start Guide](./quick-start.md) - Learn BMM basics
- [Scale Adaptive System](./scale-adaptive-system.md) - Deep dive on levels and complexity
- [Scale Adaptive System](./scale-adaptive-system.md) - Deep dive on tracks and complexity
- [Brownfield Guide](./brownfield-guide.md) - Working with existing codebases
- [Quick Spec Flow](./quick-spec-flow.md) - Fast-track for Level 0-1
- [Quick Spec Flow](./quick-spec-flow.md) - Fast-track for Quick Flow track
- [FAQ](./faq.md) - Common questions
- [Troubleshooting](./troubleshooting.md) - Problem resolution

View File

@ -8,26 +8,26 @@
## What is Quick Spec Flow?
Quick Spec Flow is a **streamlined alternative** to the full BMad Method for Level 0-1 projects. Instead of going through Product Brief → PRD → Architecture, you go **straight to a context-aware technical specification** and start coding.
Quick Spec Flow is a **streamlined alternative** to the full BMad Method for Quick Flow track projects. Instead of going through Product Brief → PRD → Architecture, you go **straight to a context-aware technical specification** and start coding.
### When to Use Quick Spec Flow
✅ **Use Quick Spec Flow (Level 0-1) when:**
✅ **Use Quick Flow track when:**
- Single bug fix or small enhancement (Level 0)
- Small feature with 2-3 related changes (Level 1)
- Single bug fix or small enhancement
- Small feature with clear scope (typically 1-15 stories)
- Rapid prototyping or experimentation
- Adding to existing brownfield codebase
- You know exactly what you want to build
❌ **Use Full BMM Flow (Level 2-4) when:**
❌ **Use BMad Method or Enterprise tracks when:**
- Building new products or major features (Level 2-4)
- Building new products or major features
- Need stakeholder alignment
- Complex multi-team coordination
- Requires extensive planning and architecture
💡 **Not sure?** Run `workflow-init` to get a recommendation based on your project's size and complexity!
💡 **Not sure?** Run `workflow-init` to get a recommendation based on your project's needs!
---
@ -68,7 +68,7 @@ flowchart TD
---
## Level 0: Single Atomic Change
## Single Atomic Change
**Best for:** Bug fixes, single file changes, isolated improvements
@ -104,7 +104,7 @@ flowchart TD
- ✅ Auto-validates quality
- ✅ Story context optional (tech-spec is comprehensive!)
### Example Level 0 Scenarios
### Example Single Change Scenarios
- "Fix the login validation bug"
- "Add email field to user registration form"
@ -113,13 +113,13 @@ flowchart TD
---
## Level 1: Coherent Small Feature
## Coherent Small Feature
**Best for:** Small features with 2-3 related user stories
### What You Get
1. **tech-spec.md** - Same comprehensive spec as Level 0
1. **tech-spec.md** - Same comprehensive spec as single change projects
2. **epics.md** - Epic organization with story breakdown
3. **story-[epic-slug]-1.md** - First story
4. **story-[epic-slug]-2.md** - Second story
@ -147,7 +147,7 @@ Stories are **automatically validated** to ensure proper sequence:
- ✅ Infrastructure → Features → Polish order
- ✅ Backend → Frontend flow
### Example Level 1 Scenarios
### Example Small Feature Scenarios
- "Add OAuth social login (Google, GitHub, Twitter)"
- "Build user profile page with avatar upload"
@ -302,7 +302,7 @@ Generates scores:
- Implementation Readiness: ✅ Ready
```
### Story Validation (Level 1 Only)
### Story Validation (Multi-Story Features)
Checks:
@ -317,7 +317,7 @@ Checks:
## Complete User Journey
### Scenario 1: Bug Fix (Level 0)
### Scenario 1: Bug Fix (Single Change)
**Goal:** Fix login validation bug
@ -342,7 +342,7 @@ Checks:
---
### Scenario 2: Small Feature (Level 1)
### Scenario 2: Small Feature (Multi-Story)
**Goal:** Add OAuth social login (Google, GitHub)
@ -392,7 +392,7 @@ Quick Spec Flow works seamlessly with all Phase 4 implementation workflows:
### sprint-planning (SM Agent)
- ✅ Works with epics.md from tech-spec
- ✅ Organizes Level 1 stories for coordinated implementation
- ✅ Organizes multi-story features for coordinated implementation
- ✅ Tracks progress through sprint-status.yaml
### dev-story (DEV Agent)
@ -405,7 +405,7 @@ Quick Spec Flow works seamlessly with all Phase 4 implementation workflows:
## Comparison: Quick Spec vs Full BMM
| Aspect | Quick Spec Flow (Level 0-1) | Full BMM Flow (Level 2-4) |
| Aspect | Quick Flow Track | BMad Method/Enterprise Tracks |
| --------------------- | ---------------------------- | ---------------------------------- |
| **Setup** | None (standalone) | workflow-init recommended |
| **Planning Docs** | tech-spec.md only | Product Brief → PRD → Architecture |
@ -419,18 +419,18 @@ Quick Spec Flow works seamlessly with all Phase 4 implementation workflows:
---
## When to Graduate from Quick Spec to Full BMM
## When to Graduate from Quick Flow to BMad Method
Start with Quick Spec, but switch to Full BMM when:
Start with Quick Flow, but switch to BMad Method when:
- ❌ Project grows beyond 3-5 stories
- ❌ Project grows beyond initial scope
- ❌ Multiple teams need coordination
- ❌ Stakeholders need formal documentation
- ❌ Product vision is unclear
- ❌ Architectural decisions need deep analysis
- ❌ Compliance/regulatory requirements exist
💡 **Tip:** You can always run `workflow-init` later to transition from Quick Spec to Full BMM!
💡 **Tip:** You can always run `workflow-init` later to transition from Quick Flow to BMad Method!
---
@ -466,8 +466,8 @@ Start with Quick Spec, but switch to Full BMM when:
### 🎯 **Focus**
- Level 0: Single atomic change
- Level 1: Coherent small feature
- Single atomic changes
- Coherent small features
- No scope creep
- Fast iteration
@ -500,7 +500,7 @@ Start with Quick Spec, but switch to Full BMM when:
Quick Spec Flow is **fully standalone**:
- Detects if you're Level 0 or Level 1
- Detects if it's a single change or multi-story feature
- Asks for greenfield vs brownfield
- Works without status file tracking
- Perfect for rapid prototyping
@ -525,13 +525,13 @@ Quick Spec Flow is **fully standalone**:
**A:** Absolutely! Quick Spec Flow captures UX/UI considerations, component changes, and accessibility requirements.
### Q: What if my Level 0 project grows?
### Q: What if my Quick Flow project grows?
**A:** No problem! You can always transition to Full BMM by running workflow-init and create-prd. Your tech-spec becomes input for the PRD.
**A:** No problem! You can always transition to BMad Method by running workflow-init and create-prd. Your tech-spec becomes input for the PRD.
### Q: Do I need story-context for every story?
**A:** Usually no! Tech-spec is comprehensive enough for most Level 0-1 projects. Only use story-context for complex edge cases.
**A:** Usually no! Tech-spec is comprehensive enough for most Quick Flow projects. Only use story-context for complex edge cases.
### Q: Can I skip validation?
@ -566,13 +566,13 @@ When validation runs, read the scores. They tell you if your spec is production-
### 5. **Story Context is Optional**
For Level 0, try going directly to dev-story first. Only add story-context if you hit complexity.
For single changes, try going directly to dev-story first. Only add story-context if you hit complexity.
### 6. **Keep Level 0 Truly Atomic**
### 6. **Keep Single Changes Truly Atomic**
If your "single change" needs 3+ files, it might be Level 1. Let the workflow guide you.
If your "single change" needs 3+ files, it might be a multi-story feature. Let the workflow guide you.
### 7. **Validate Story Sequence for Level 1**
### 7. **Validate Story Sequence for Multi-Story Features**
When you get multiple stories, check the dependency validation output. Proper sequence matters!
@ -580,7 +580,7 @@ When you get multiple stories, check the dependency validation output. Proper se
## Real-World Examples
### Example 1: Adding Logging (Level 0)
### Example 1: Adding Logging (Single Change)
**Input:** "Add structured logging to payment processing"
@ -596,7 +596,7 @@ When you get multiple stories, check the dependency validation output. Proper se
---
### Example 2: Search Feature (Level 1)
### Example 2: Search Feature (Multi-Story)
**Input:** "Add search to product catalog with filters"

View File

@ -19,7 +19,7 @@ BMad Method (BMM) helps you build software through guided workflows with special
1. **Phase 1: Analysis** (Optional) - Brainstorming, Research, Product Brief
2. **Phase 2: Planning** (Required) - Create your requirements (tech-spec or PRD)
3. **Phase 3: Architecture** (Conditional) - Design the architecture for complex projects (10+ stories)
3. **Phase 3: Solutioning** (Track-dependent) - Design the architecture for BMad Method and Enterprise tracks
4. **Phase 4: Implementation** (Required) - Build your software Epic by Epic, Story by Story
## Installation
@ -54,28 +54,28 @@ During workflow-init, you'll describe:
- Whether there's an existing codebase or this is a new project
- The general size and complexity (you can adjust this later)
#### Project Scale Levels
#### Planning Tracks
Based on your description, the workflow will suggest a level and let you choose from:
Based on your description, the workflow will suggest a track and let you choose from:
**Greenfield Project Levels:**
**Three Planning Tracks:**
- **Level 0** - Single atomic change (1 story) - bug fixes, typos, minor updates, single file changes
- **Level 1** - Small feature (1-10 stories) - simple additions, isolated features, one module
- **Level 2** - Medium feature set (5-15 stories) - dashboards, multiple related features, several modules
- **Level 3** - Complex integration (12-40 stories) - platform features, major integrations, architectural changes
- **Level 4** - Enterprise expansion (40+ stories) - multi-tenant, ecosystem changes, system-wide initiatives
- **Quick Flow** - Fast implementation (tech-spec only) - bug fixes, simple features, clear scope (typically 1-15 stories)
- **BMad Method** - Full planning (PRD + Architecture + UX) - products, platforms, complex features (typically 10-50+ stories)
- **Enterprise Method** - Extended planning (BMad Method + Security/DevOps/Test) - enterprise requirements, compliance, multi-tenant (typically 30+ stories)
**Note**: Story counts are guidance, not definitions. Tracks are chosen based on planning needs, not story math.
#### What gets created?
Once you confirm your level, the `bmm-workflow-status.md` file will be created in your project's docs folder (assuming default install location). This file tracks your progress through all phases.
Once you confirm your track, the `bmm-workflow-status.yaml` file will be created in your project's docs folder (assuming default install location). This file tracks your progress through all phases.
**Important notes:**
- Every level has different paths through the phases
- Every track has different paths through the phases
- Story counts can still change based on overall complexity as you work
- For this guide, we'll assume a Level 2 project
- This workflow will guide you through Phase 1 (optional), Phase 2 (required), and Phase 3 (required for Level 2+ complexity)
- For this guide, we'll assume a BMad Method track project
- This workflow will guide you through Phase 1 (optional), Phase 2 (required), and Phase 3 (required for BMad Method and Enterprise tracks)
### Step 2: Work Through Phases 1-3
@ -100,12 +100,12 @@ Phase 1 (Analysis) is entirely optional. All workflows are optional or recommend
The next TRULY REQUIRED step is:
- PRD (Product Requirements Document) in Phase 2 - Planning
- Agent: pm
- Command: /bmad:bmm:workflows:prd
- Command: prd
```
#### How to Run Workflows in Phases 1-3
When an agent tells you to run a workflow (like `/bmad:bmm:workflows:prd`):
When an agent tells you to run a workflow (like `prd`):
1. **Start a new chat** with the specified agent (e.g., PM) - See [docs/ide-info](../docs/ide-info/) for your IDE's specific instructions
2. **Wait for the menu** to appear
@ -121,21 +121,21 @@ The agents in V6 are very good with fuzzy menu matching!
For v4 users or those who prefer to skip workflow-status guidance:
- **Analyst** → Brainstorming, Product Brief
- **PM** → PRD (10+ stories) OR tech-spec (1-10 stories)
- **PM** → PRD (BMad Method/Enterprise tracks) OR tech-spec (Quick Flow track)
- **UX-Designer** → UX Design Document (if UI-heavy)
- **Architect** → Architecture (10+ stories)
- **Architect** → Architecture (BMad Method/Enterprise tracks)
#### Phase 2: Planning - Creating the PRD
**For Level 2+ projects (10+ stories):**
**For BMad Method and Enterprise tracks:**
1. Load the **PM agent** in a new chat
2. Tell it to run the PRD workflow
3. Once complete, you'll have two files:
3. Once complete, you'll have:
- **PRD.md** - Your Product Requirements Document
- **Epics.md** - High-level epics with stories
- Epic breakdown
**For smaller projects (Levels 0-1):**
**For Quick Flow track:**
- Use **tech-spec** instead of PRD (no architecture needed)
@ -149,7 +149,7 @@ If your project has a user interface:
#### Phase 3: Architecture
**For Level 2+ projects only:**
**For BMad Method and Enterprise tracks:**
1. Load the **Architect agent** in a new chat
2. Tell it to run the create-architecture workflow
@ -261,7 +261,7 @@ The agent creates documents, asks questions, and helps you make decisions throug
BMad creates two files to track your progress:
**1. bmm-workflow-status.md**
**1. bmm-workflow-status.yaml**
- Shows which phase you're in and what's next
- Created by workflow-init
@ -293,16 +293,16 @@ flowchart LR
subgraph P2["Phase 2 (Required)<br/>Planning"]
direction TB
B1[Level 0-1:<br/>tech-spec]
B2[Level 2+:<br/>PRD]
B1[Quick Flow:<br/>tech-spec]
B2[Method/Enterprise:<br/>PRD]
B3[UX opt]
B4[PM, UX]
B1 ~~~ B2 ~~~ B3 ~~~ B4
end
subgraph P3["Phase 3 (Conditional)<br/>Architecture"]
subgraph P3["Phase 3 (Track-dependent)<br/>Solutioning"]
direction TB
C1[Level 2+:<br/>architecture]
C1[Method/Enterprise:<br/>architecture]
C2[gate-check]
C3[Architect]
C1 ~~~ C2 ~~~ C3
@ -332,7 +332,7 @@ flowchart LR
## Common Questions
**Q: Do I always need architecture?**
A: Only for larger projects (10+ stories). Small projects can skip straight from tech-spec to implementation.
A: Only for BMad Method and Enterprise tracks. Quick Flow projects skip straight from tech-spec to implementation.
**Q: Can I change my plan later?**
A: Yes! The SM agent has a "correct-course" workflow for handling scope changes.
@ -359,7 +359,7 @@ A: Yes, once you learn the flow. Use the Quick Reference in Step 2 to go directl
**Always use fresh chats** - Load agents in new chats for each workflow to avoid context issues
**Let workflow-status guide you** - Load any agent and ask for status when unsure what's next
**Level matters** - Small projects (0-1) use tech-spec, larger projects (2+) need PRD and architecture
**Track matters** - Quick Flow uses tech-spec, BMad Method/Enterprise need PRD and architecture
**Tracking is automatic** - The status files update themselves, no manual editing needed
**Agents are flexible** - Use menu numbers, shortcuts (\*prd), or natural language

File diff suppressed because it is too large Load Diff

View File

@ -1,54 +0,0 @@
# Brownfield Level 0 - Single Atomic Change in Existing Codebase
# One change to existing system
project_type: "software"
level: 0
field_type: "brownfield"
description: "Single atomic change to existing codebase"
phases:
- prerequisite: true
name: "Documentation"
conditional: "if_undocumented"
note: "NOT a phase - prerequisite for brownfield without docs OR post-completion cleanup"
workflows:
- id: "document-project"
required: true
agent: "analyst"
command: "document-project"
output: "Comprehensive project documentation"
purpose: "Understand existing codebase before planning OR create superior final docs after Phase 4"
- phase: 1
name: "Analysis"
optional: true
workflows:
- id: "brainstorm-project"
optional: true
agent: "analyst"
command: "brainstorm-project"
- phase: 2
name: "Planning"
required: true
workflows:
- id: "tech-spec"
required: true
agent: "architect"
command: "tech-spec"
output: "Creates single story file"
note: "Must understand existing patterns"
- phase: 3
name: "Solutioning"
skip: true
- phase: 4
name: "Implementation"
required: true
workflows:
- id: "sprint-planning"
required: true
agent: "sm"
command: "sprint-planning"
note: "Creates sprint plan with all stories - subsequent work tracked in sprint plan output, not workflow-status"

View File

@ -1,76 +0,0 @@
# Brownfield Level 2 - Medium Project in Existing Codebase
# 5-15 stories, multiple features added to existing system
project_type: "software"
level: 2
field_type: "brownfield"
description: "Medium project adding multiple features to existing codebase"
phases:
- prerequisite: true
name: "Documentation"
conditional: "if_undocumented"
note: "NOT a phase - prerequisite for brownfield without docs OR post-completion cleanup"
workflows:
- id: "document-project"
required: true
agent: "analyst"
command: "document-project"
output: "Comprehensive project documentation"
purpose: "Understand existing codebase before planning OR create superior final docs after Phase 4"
- phase: 1
name: "Analysis"
optional: true
workflows:
- id: "brainstorm-project"
optional: true
agent: "analyst"
command: "brainstorm-project"
- id: "research"
optional: true
agent: "analyst"
command: "research"
- id: "product-brief"
optional: true
agent: "analyst"
command: "product-brief"
- phase: 2
name: "Planning"
required: true
workflows:
- id: "prd"
recommended: true
agent: "pm"
command: "prd"
output: "Focused PRD for new features"
note: "Must consider existing system constraints"
- id: "validate-prd"
optional: true
agent: "pm"
command: "validate-prd"
- id: "tech-spec"
required: true
agent: "pm"
command: "tech-spec"
output: "Creates spec with multiple story files"
note: "Integrate with existing patterns"
- id: "create-design"
conditional: "if_has_ui"
agent: "ux-designer"
command: "create-design"
- phase: 3
name: "Solutioning"
skip: true
- phase: 4
name: "Implementation"
required: true
workflows:
- id: "sprint-planning"
required: true
agent: "sm"
command: "sprint-planning"
note: "Creates sprint plan with all stories - subsequent work tracked in sprint plan output, not workflow-status"

View File

@ -1,88 +0,0 @@
# Brownfield Level 4 - Enterprise Scale Changes to Existing System
# 40+ stories, major expansion of existing enterprise system
project_type: "software"
level: 4
field_type: "brownfield"
description: "Enterprise scale expansion of existing system"
phases:
- prerequisite: true
name: "Documentation"
conditional: "if_undocumented"
note: "NOT a phase - prerequisite for brownfield without docs OR post-completion cleanup. Critical for enterprise-scale changes"
workflows:
- id: "document-project"
required: true
agent: "analyst"
command: "document-project"
output: "Comprehensive project documentation"
purpose: "Understand existing codebase before planning OR create superior final docs after Phase 4"
- phase: 1
name: "Analysis"
required: true
workflows:
- id: "brainstorm-project"
recommended: true
agent: "analyst"
command: "brainstorm-project"
- id: "research"
required: true
agent: "analyst"
command: "research"
note: "Research existing system architecture deeply"
- id: "product-brief"
required: true
agent: "analyst"
command: "product-brief"
note: "Strategic brief for major expansion"
- phase: 2
name: "Planning"
required: true
workflows:
- id: "prd"
required: true
agent: "pm"
command: "prd"
output: "Comprehensive PRD considering existing system"
- id: "validate-prd"
optional: true
agent: "pm"
command: "validate-prd"
- id: "create-design"
required: true
agent: "ux-designer"
command: "create-design"
note: "Multiple UI/UX specifications"
- phase: 3
name: "Solutioning"
required: true
workflows:
- id: "create-architecture"
required: true
agent: "architect"
command: "create-architecture"
output: "Architecture for system expansion"
note: "Must maintain backward compatibility"
- id: "validate-architecture"
optional: true
agent: "architect"
command: "validate-architecture"
- id: "solutioning-gate-check"
required: true
agent: "architect"
command: "solutioning-gate-check"
note: "Critical validation before major changes"
- phase: 4
name: "Implementation"
required: true
workflows:
- id: "sprint-planning"
required: true
agent: "sm"
command: "sprint-planning"
note: "Creates sprint plan with all stories - subsequent work tracked in sprint plan output, not workflow-status"

View File

@ -0,0 +1,120 @@
# BMad Enterprise Method - Brownfield
# Extended enterprise planning for complex brownfield with security/devops/test (30+ stories typically)
method_name: "BMad Enterprise Method"
track: "enterprise"
field_type: "brownfield"
description: "Enterprise-grade planning for complex brownfield additions with extended requirements"
phases:
- prerequisite: true
name: "Documentation"
conditional: "if_undocumented"
note: "NOT a phase - prerequisite for brownfield without docs (nearly mandatory for enterprise)"
workflows:
- id: "document-project"
required: true
agent: "analyst"
command: "document-project"
output: "Comprehensive project documentation"
purpose: "Understand existing codebase - critical for enterprise brownfield"
- phase: 0
name: "Discovery (Required)"
required: true
note: "Analysis phase required for enterprise projects"
workflows:
- id: "brainstorm-project"
optional: true
agent: "analyst"
command: "brainstorm-project"
included_by: "user_choice"
- id: "research"
recommended: true
agent: "analyst"
command: "research"
included_by: "user_choice"
note: "Highly recommended - compliance, integration, risk research"
- id: "product-brief"
optional: true
agent: "analyst"
command: "product-brief"
included_by: "user_choice"
note: "Optional for brownfield enterprise"
- phase: 1
name: "Planning"
required: true
workflows:
- id: "prd"
required: true
agent: "pm"
command: "prd"
output: "Enterprise PRD with compliance requirements"
note: "Must address existing system constraints and migration strategy"
- id: "validate-prd"
recommended: true
agent: "pm"
command: "validate-prd"
- id: "create-design"
recommended: true
agent: "ux-designer"
command: "create-design"
note: "Recommended - must integrate with existing UX patterns"
- phase: 2
name: "Solutioning"
required: true
workflows:
- id: "create-architecture"
required: true
agent: "architect"
command: "create-architecture"
output: "Integration architecture with enterprise considerations"
note: "Distills brownfield context + adds security/scalability/compliance design"
- id: "create-security-architecture"
required: true
agent: "architect"
command: "create-security-architecture"
output: "Security architecture for brownfield integration"
note: "Future workflow - threat model, auth integration, audit requirements"
- id: "create-devops-strategy"
required: true
agent: "architect"
command: "create-devops-strategy"
output: "DevOps strategy for brownfield deployment"
note: "Future workflow - CI/CD integration, deployment strategy, monitoring"
- id: "create-test-strategy"
required: true
agent: "tea"
command: "create-test-strategy"
output: "Test strategy including regression testing"
note: "Future workflow - critical for brownfield to prevent breaking existing functionality"
- id: "validate-architecture"
optional: true
agent: "architect"
command: "validate-architecture"
- id: "solutioning-gate-check"
required: true
agent: "architect"
command: "solutioning-gate-check"
note: "Critical gate - validates all planning before touching production system"
- phase: 3
name: "Implementation"
required: true
workflows:
- id: "sprint-planning"
required: true
agent: "sm"
command: "sprint-planning"
note: "Enterprise brownfield requires careful phasing and feature flags"

View File

@ -0,0 +1,108 @@
# BMad Enterprise Method - Greenfield
# Extended enterprise planning with security/devops/test for greenfield (30+ stories typically)
method_name: "BMad Enterprise Method"
track: "enterprise"
field_type: "greenfield"
description: "Complete enterprise-grade planning with security, devops, and test strategy"
phases:
- phase: 0
name: "Discovery (Required)"
required: true
note: "Analysis phase required for enterprise projects"
workflows:
- id: "brainstorm-project"
optional: true
agent: "analyst"
command: "brainstorm-project"
included_by: "user_choice"
- id: "research"
recommended: true
agent: "analyst"
command: "research"
included_by: "user_choice"
note: "Highly recommended for enterprise - domain and compliance research"
- id: "product-brief"
recommended: true
agent: "analyst"
command: "product-brief"
included_by: "user_choice"
note: "Recommended for strategic alignment"
- phase: 1
name: "Planning"
required: true
workflows:
- id: "prd"
required: true
agent: "pm"
command: "prd"
output: "Comprehensive Product Requirements Document"
note: "Enterprise-level requirements with compliance considerations"
- id: "validate-prd"
recommended: true
agent: "pm"
command: "validate-prd"
- id: "create-design"
recommended: true
agent: "ux-designer"
command: "create-design"
note: "Highly recommended for enterprise - design system and patterns"
- phase: 2
name: "Solutioning"
required: true
workflows:
- id: "create-architecture"
required: true
agent: "architect"
command: "create-architecture"
output: "Enterprise-grade system architecture"
note: "Includes scalability, multi-tenancy, integration architecture"
- id: "create-security-architecture"
required: true
agent: "architect"
command: "create-security-architecture"
output: "Security architecture and threat model"
note: "Future workflow - security design, auth, compliance"
- id: "create-devops-strategy"
required: true
agent: "architect"
command: "create-devops-strategy"
output: "DevOps pipeline and infrastructure plan"
note: "Future workflow - CI/CD, deployment, monitoring"
- id: "create-test-strategy"
required: true
agent: "tea"
command: "create-test-strategy"
output: "Comprehensive test strategy"
note: "Future workflow - test approach, automation, quality gates"
- id: "validate-architecture"
optional: true
agent: "architect"
command: "validate-architecture"
- id: "solutioning-gate-check"
required: true
agent: "architect"
command: "solutioning-gate-check"
note: "Validates all planning artifacts align before implementation"
- phase: 3
name: "Implementation"
required: true
workflows:
- id: "sprint-planning"
required: true
agent: "sm"
command: "sprint-planning"
note: "Creates sprint plan - enterprise projects may require phased rollout"

View File

@ -1,45 +0,0 @@
# Greenfield Level 0 - Single Atomic Change
# The simplest possible workflow - one change, one story
project_type: "software"
level: 0
field_type: "greenfield"
description: "Single atomic change - bug fix, tiny feature, one story"
phases:
- phase: 1
name: "Analysis"
optional: true
workflows:
- id: "brainstorm-project"
optional: true
agent: "analyst"
command: "brainstorm-project"
- id: "product-brief"
optional: true
agent: "analyst"
command: "product-brief"
- phase: 2
name: "Planning"
required: true
workflows:
- id: "tech-spec"
required: true
agent: "pm"
command: "tech-spec"
output: "Creates Technical Specification with single story file"
- phase: 3
name: "Solutioning"
skip: true
- phase: 4
name: "Implementation"
required: true
workflows:
- id: "sprint-planning"
required: true
agent: "sm"
command: "sprint-planning"
note: "Creates sprint plan with all stories - subsequent work tracked in sprint plan output, not workflow-status"

View File

@ -1,73 +0,0 @@
# Greenfield Level 3 - Complex System
# Subsystems, integrations, architectural decisions required
project_type: "software"
level: 3
field_type: "greenfield"
description: "Complex system - subsystems, integrations, architectural decisions"
phases:
- phase: 1
name: "Analysis"
optional: true
workflows:
- id: "brainstorm-project"
optional: true
agent: "analyst"
command: "brainstorm-project"
- id: "research"
optional: true
agent: "analyst"
command: "research"
note: "Multiple research areas likely"
- id: "product-brief"
recommended: true
agent: "analyst"
command: "product-brief"
- phase: 2
name: "Planning"
required: true
workflows:
- id: "prd"
required: true
agent: "pm"
command: "prd"
output: "High-level requirements and epic definitions"
- id: "validate-prd"
optional: true
agent: "pm"
command: "validate-prd"
- id: "create-design"
conditional: "if_has_ui"
agent: "ux-designer"
command: "create-design"
- phase: 3
name: "Solutioning"
required: true
workflows:
- id: "create-architecture"
required: true
agent: "architect"
command: "create-architecture"
output: "System-wide architecture document"
- id: "validate-architecture"
optional: true
agent: "architect"
command: "validate-architecture"
- id: "solutioning-gate-check"
recommended: true
agent: "architect"
command: "solutioning-gate-check"
note: "Validate PRD + UX + architecture cohesion before implementation"
- phase: 4
name: "Implementation"
required: true
workflows:
- id: "sprint-planning"
required: true
agent: "sm"
command: "sprint-planning"
note: "Creates sprint plan with all stories - subsequent work tracked in sprint plan output, not workflow-status"

View File

@ -1,75 +0,0 @@
# Greenfield Level 4 - Enterprise Scale
# Multiple products, enterprise architecture, 40+ stories
project_type: "software"
level: 4
field_type: "greenfield"
description: "Enterprise scale - multiple products, enterprise architecture"
phases:
- phase: 1
name: "Analysis"
required: true
workflows:
- id: "brainstorm-project"
recommended: true
agent: "analyst"
command: "brainstorm-project"
- id: "research"
required: false
agent: "analyst"
command: "research"
note: "Extensive research across multiple domains"
- id: "product-brief"
required: true
agent: "analyst"
command: "product-brief"
note: "Strategic brief for enterprise scope"
- phase: 2
name: "Planning"
required: true
workflows:
- id: "prd"
required: true
agent: "pm"
command: "prd"
output: "Comprehensive product requirements document"
- id: "validate-prd"
optional: true
agent: "pm"
command: "validate-prd"
- id: "create-design"
required: true
agent: "ux-designer"
command: "create-design"
note: "Multiple UI/UX specifications needed"
- phase: 3
name: "Solutioning"
required: true
workflows:
- id: "create-architecture"
required: true
agent: "architect"
command: "create-architecture"
output: "Enterprise architecture documentation"
- id: "validate-architecture"
optional: true
agent: "architect"
command: "validate-architecture"
- id: "solutioning-gate-check"
required: true
agent: "architect"
command: "solutioning-gate-check"
note: "Validate PRD + UX + architecture cohesion before implementation"
- phase: 4
name: "Implementation"
required: true
workflows:
- id: "sprint-planning"
required: true
agent: "sm"
command: "sprint-planning"
note: "Creates sprint plan with all stories - subsequent work tracked in sprint plan output, not workflow-status"

View File

@ -1,43 +1,49 @@
# Brownfield Level 3 - Complex Integration with Existing System
# Major feature addition requiring architectural integration
# BMad Method - Brownfield
# Full product + architecture planning for complex brownfield additions (10-50+ stories typically)
project_type: "software"
level: 3
method_name: "BMad Method"
track: "method"
field_type: "brownfield"
description: "Complex integration with existing system architecture"
description: "Complete product and system design for complex brownfield work"
phases:
- prerequisite: true
name: "Documentation"
conditional: "if_undocumented"
note: "NOT a phase - prerequisite for brownfield without docs OR post-completion cleanup"
note: "NOT a phase - prerequisite for brownfield without docs"
workflows:
- id: "document-project"
required: true
agent: "analyst"
command: "document-project"
output: "Comprehensive project documentation"
purpose: "Understand existing codebase before planning OR create superior final docs after Phase 4"
purpose: "Understand existing codebase before planning"
- phase: 1
name: "Analysis"
recommended: true
- phase: 0
name: "Discovery (Optional)"
optional: true
note: "User-selected during workflow-init"
workflows:
- id: "brainstorm-project"
optional: true
agent: "analyst"
command: "brainstorm-project"
included_by: "user_choice"
- id: "research"
recommended: true
optional: true
agent: "analyst"
command: "research"
note: "Research existing architecture patterns"
included_by: "user_choice"
- id: "product-brief"
recommended: true
optional: true
agent: "analyst"
command: "product-brief"
included_by: "user_choice"
note: "Optional for brownfield, less common than greenfield"
- phase: 2
- phase: 1
name: "Planning"
required: true
workflows:
@ -45,46 +51,42 @@ phases:
required: true
agent: "pm"
command: "prd"
output: "Requirements with integration points"
output: "PRD focused on new features/changes"
note: "Must consider existing system constraints"
- id: "validate-prd"
optional: true
agent: "pm"
command: "validate-prd"
- id: "create-design"
conditional: "if_has_ui"
agent: "ux-designer"
command: "create-design"
note: "Must align with existing UI patterns"
- phase: 3
- phase: 2
name: "Solutioning"
required: true
workflows:
- id: "architecture-review"
required: true
agent: "architect"
command: "architecture-review"
note: "Review existing architecture first"
- id: "integration-planning"
required: true
agent: "architect"
command: "integration-planning"
output: "Integration strategy document"
- id: "create-architecture"
required: true
recommended: true
agent: "architect"
command: "create-architecture"
note: "Extension of existing architecture"
output: "Integration architecture - solution design for THIS project"
note: "HIGHLY RECOMMENDED: Distills massive brownfield context into focused solution design. Prevents agent confusion."
- id: "validate-architecture"
optional: true
agent: "architect"
command: "validate-architecture"
- id: "solutioning-gate-check"
required: true
agent: "architect"
command: "solutioning-gate-check"
note: "Validates PRD + UX + Architecture (if created) cohesion"
- phase: 4
- phase: 3
name: "Implementation"
required: true
workflows:
@ -92,4 +94,4 @@ phases:
required: true
agent: "sm"
command: "sprint-planning"
note: "Creates sprint plan with all stories - subsequent work tracked in sprint plan output, not workflow-status"
note: "Creates sprint plan with stories"

View File

@ -1,31 +1,38 @@
# Greenfield Level 2 - Medium Project
# Multiple epics with 10+ stories total
# BMad Method - Greenfield
# Full product + architecture planning for greenfield projects (10-50+ stories typically)
project_type: "software"
level: 2
method_name: "BMad Method"
track: "method"
field_type: "greenfield"
description: "Medium project - multiple epics, 10+ stories"
description: "Complete product and system design methodology for greenfield projects"
phases:
- phase: 1
name: "Analysis"
- phase: 0
name: "Discovery (Optional)"
optional: true
note: "User-selected during workflow-init"
workflows:
- id: "brainstorm-project"
optional: true
agent: "analyst"
command: "brainstorm-project"
included_by: "user_choice"
- id: "research"
optional: true
agent: "analyst"
command: "research"
note: "Can have multiple research docs"
included_by: "user_choice"
note: "Can have multiple research workflows"
- id: "product-brief"
recommended: true
optional: true
agent: "analyst"
command: "product-brief"
included_by: "user_choice"
note: "Recommended for greenfield Method projects"
- phase: 2
- phase: 1
name: "Planning"
required: true
workflows:
@ -33,22 +40,21 @@ phases:
required: true
agent: "pm"
command: "prd"
output: "Creates PRD with epics.md and story list"
output: "Product Requirements Document with epics and stories"
- id: "validate-prd"
optional: true
agent: "pm"
command: "validate-prd"
note: "Quality check for PRD completeness"
- id: "create-design"
conditional: "if_has_ui"
agent: "ux-designer"
command: "create-design"
- id: "tech-spec"
optional: true
agent: "pm"
command: "tech-spec"
note: "Lightweight Technical Specification planning"
note: "Determined after PRD - user/agent decides if needed"
- phase: 3
- phase: 2
name: "Solutioning"
required: true
workflows:
@ -56,18 +62,22 @@ phases:
required: true
agent: "architect"
command: "create-architecture"
output: "System-wide architecture document"
output: "System architecture document"
note: "Complete system design for greenfield projects"
- id: "validate-architecture"
optional: true
agent: "architect"
command: "validate-architecture"
note: "Quality check for architecture completeness"
- id: "solutioning-gate-check"
required: true
agent: "architect"
command: "solutioning-gate-check"
note: "Validate PRD + UX + architecture cohesion before implementation"
note: "Validates PRD + UX + Architecture cohesion before implementation"
- phase: 4
- phase: 3
name: "Implementation"
required: true
workflows:
@ -75,4 +85,4 @@ phases:
required: true
agent: "sm"
command: "sprint-planning"
note: "Creates sprint plan with all stories - subsequent work tracked in sprint plan output, not workflow-status"
note: "Creates sprint plan - subsequent work tracked there"

View File

@ -1,38 +1,42 @@
# Brownfield Level 1 - Small Feature in Existing Codebase
# 1-10 stories adding to existing system
# BMad Quick Flow - Brownfield
# Fast implementation path for existing codebases (1-15 stories typically)
project_type: "software"
level: 1
method_name: "BMad Quick Flow"
track: "quick-flow"
field_type: "brownfield"
description: "Small feature addition to existing codebase"
description: "Fast tech-spec based implementation for brownfield projects"
phases:
- prerequisite: true
name: "Documentation"
conditional: "if_undocumented"
note: "NOT a phase - prerequisite for brownfield without docs OR post-completion cleanup"
note: "NOT a phase - prerequisite for brownfield without docs"
workflows:
- id: "document-project"
required: true
agent: "analyst"
command: "document-project"
output: "Comprehensive project documentation"
purpose: "Understand existing codebase before planning OR create superior final docs after Phase 4"
purpose: "Understand existing codebase before planning"
- phase: 1
name: "Analysis"
- phase: 0
name: "Discovery (Optional)"
optional: true
note: "User-selected during workflow-init"
workflows:
- id: "brainstorm-project"
optional: true
agent: "analyst"
command: "brainstorm-project"
included_by: "user_choice"
- id: "research"
optional: true
agent: "analyst"
command: "research"
included_by: "user_choice"
- phase: 2
- phase: 1
name: "Planning"
required: true
workflows:
@ -40,14 +44,10 @@ phases:
required: true
agent: "pm"
command: "tech-spec"
output: "Creates story files for feature"
note: "Must integrate with existing architecture"
output: "Technical Specification with stories (auto-detects epic if 2+ stories)"
note: "Integrates with existing codebase patterns from document-project"
- phase: 3
name: "Solutioning"
skip: true
- phase: 4
- phase: 2
name: "Implementation"
required: true
workflows:
@ -55,4 +55,4 @@ phases:
required: true
agent: "sm"
command: "sprint-planning"
note: "Creates sprint plan with all stories - subsequent work tracked in sprint plan output, not workflow-status"
note: "Creates sprint plan with all stories"

View File

@ -1,30 +1,31 @@
# Greenfield Level 1 - Small Feature
# Coherent feature with 2-3 stories in a single epic
# BMad Quick Flow - Greenfield
# Fast implementation path with tech-spec planning (1-15 stories typically)
project_type: "software"
level: 1
method_name: "BMad Quick Flow"
track: "quick-flow"
field_type: "greenfield"
description: "Small coherent feature - 2-3 stories, single epic"
description: "Fast tech-spec based implementation for greenfield projects"
phases:
- phase: 1
name: "Analysis"
- phase: 0
name: "Discovery (Optional)"
optional: true
note: "User-selected during workflow-init"
workflows:
- id: "brainstorm-project"
optional: true
agent: "analyst"
command: "brainstorm-project"
included_by: "user_choice"
- id: "research"
optional: true
agent: "analyst"
command: "research"
- id: "product-brief"
optional: true
agent: "analyst"
command: "product-brief"
included_by: "user_choice"
note: "Can have multiple research workflows"
- phase: 2
- phase: 1
name: "Planning"
required: true
workflows:
@ -32,13 +33,10 @@ phases:
required: true
agent: "pm"
command: "tech-spec"
output: "Creates Technical Specification with an epic and 2-3 story files"
output: "Technical Specification with stories (auto-detects epic if 2+ stories)"
note: "Quick Spec Flow - implementation-focused planning"
- phase: 3
name: "Solutioning"
skip: true
- phase: 4
- phase: 2
name: "Implementation"
required: true
workflows:

View File

@ -1,11 +1,11 @@
# Workflow Status Template
# This tracks progress through phases 1-3 of the BMM methodology
# Phase 4 (Implementation) is tracked separately in sprint-status.yaml
# This tracks progress through BMM methodology phases
# Phase 3/4 (Implementation) is tracked separately in sprint-status.yaml
# generated: {{generated}}
# project: {{project_name}}
# project_type: {{project_type}}
# project_level: {{project_level}}
# selected_track: {{selected_track}}
# field_type: {{field_type}}
# workflow_path: {{workflow_path_file}}
@ -24,7 +24,7 @@
generated: "{{generated}}"
project: "{{project_name}}"
project_type: "{{project_type}}"
project_level: "{{project_level}}"
selected_track: "{{selected_track}}"
field_type: "{{field_type}}"
workflow_path: "{{workflow_path_file}}"