5 levels of scale adaption compressed to 3 clear distinctions driven by user preference and project needs
This commit is contained in:
parent
750024fb14
commit
88d043245f
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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"
|
||||
|
|
|
|||
|
|
@ -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"
|
||||
|
|
|
|||
|
|
@ -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)
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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"
|
||||
|
||||
|
|
|
|||
|
|
@ -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
File diff suppressed because it is too large
Load Diff
|
|
@ -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"
|
||||
|
|
@ -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"
|
||||
|
|
@ -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"
|
||||
|
|
@ -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"
|
||||
|
|
@ -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"
|
||||
|
|
@ -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"
|
||||
|
|
@ -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"
|
||||
|
|
@ -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"
|
||||
|
|
@ -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"
|
||||
|
|
@ -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"
|
||||
|
|
@ -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"
|
||||
|
|
@ -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:
|
||||
|
|
@ -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}}"
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue