bmad-method 6.0.0-alpha.4 → 6.0.0-alpha.5

package/bmad/bmm/workflows/workflow-status/README.md

@@ -1,260 +0,0 @@
-# Workflow Status System
-
-The universal entry point for BMM workflows - answers "what should I do now?" for any agent.
-
-## Overview
-
-The workflow status system provides:
-
-- **Smart project initialization** - Detects existing work and infers project details
-- **Simple status tracking** - Key-value pairs for instant parsing
-- **Intelligent routing** - Suggests next actions based on current state
-- **Modular workflow paths** - Each project type/level has its own clean definition
-
-## Architecture
-
-### Core Components
-
-```
-workflow-status/
-├── workflow.yaml              # Main configuration
-├── instructions.md            # Status checker (99 lines)
-├── workflow-status-template.yaml # Clean YAML status template
-├── project-levels.yaml        # Source of truth for scale definitions
-└── paths/                     # Modular workflow definitions
-    ├── greenfield-level-0.yaml through level-4.yaml
-    ├── brownfield-level-0.yaml through level-4.yaml
-    └── game-design.yaml
-```
-
-### Related Workflow
-
-```
-workflow-init/
-├── workflow.yaml              # Initialization configuration
-└── instructions.md            # Smart setup (182 lines)
-```
-
-## How It Works
-
-### For New Projects
-
-1. User runs `workflow-status`
-2. System finds no status file
-3. Directs to `workflow-init`
-4. Init workflow:
-   - Scans for existing work (PRDs, code, etc.)
-   - Infers project details from what it finds
-   - Asks minimal questions (name + description)
-   - Confirms understanding in one step
-   - Creates status file with workflow path
-
-### For Existing Projects
-
-1. User runs `workflow-status`
-2. System reads status file
-3. Shows current state and options:
-   - Continue in-progress work
-   - Next required step
-   - Available optional workflows
-4. User picks action
-
-## Status File Format
-
-Clean YAML format with all workflows listed up front:
-
-```yaml
-# generated: 2025-10-29
-# project: MyProject
-# project_type: software
-# project_level: 2
-# field_type: greenfield
-# workflow_path: greenfield-level-2.yaml
-
-workflow_status:
-  # Phase 1: Analysis
-  brainstorm-project: optional
-  research: optional
-  product-brief: recommended
-
-  # Phase 2: Planning
-  prd: docs/prd.md
-  validate-prd: optional
-  create-design: conditional
-
-  # Phase 3: Solutioning
-  create-architecture: required
-  validate-architecture: optional
-  solutioning-gate-check: required
-```
-
-**Status Values:**
-
-- `required` / `optional` / `recommended` / `conditional` - Not yet started
-- `{file-path}` - Completed (e.g., `docs/prd.md`)
-- `skipped` - Optional workflow that was skipped
-
-Any agent can instantly parse what they need:
-
-- Read YAML to see all workflows and their status
-- Check which workflows are completed vs pending
-- Auto-detect existing work by scanning for output files
-
-## Project Levels
-
-Source of truth: `/src/modules/bmm/README.md` lines 77-85
-
-- **Level 0**: Single atomic change (1 story)
-- **Level 1**: Small feature (1-10 stories)
-- **Level 2**: Medium project (5-15 stories)
-- **Level 3**: Complex system (12-40 stories)
-- **Level 4**: Enterprise scale (40+ stories)
-
-## Workflow Paths
-
-Each combination has its own file:
-
-- `greenfield-level-X.yaml` - New projects at each level
-- `brownfield-level-X.yaml` - Existing codebases at each level
-- `game-design.yaml` - Game projects (all levels)
-
-Benefits:
-
-- Load only what's needed (60 lines vs 750+)
-- Easy to maintain individual paths
-- Clear separation of concerns
-
-## Smart Detection
-
-The init workflow intelligently detects:
-
-**Project Type:**
-
-- Finds GDD → game
-- Otherwise → software
-
-**Project Level:**
-
-- Reads PRD epic/story counts
-- Analyzes scope descriptions
-- Makes educated guess
-
-**Field Type:**
-
-- Finds source code → brownfield
-- Only planning docs → greenfield
-- Checks git history age
-
-**Documentation Status:**
-
-- Finds index.md → was undocumented
-- Good README → documented
-- Missing docs → needs documentation
-
-## Usage Examples
-
-### Any Agent Checking Status
-
-```
-Agent: workflow-status
-Result: "Current: Phase 2 - Planning, Next: prd (pm agent)"
-```
-
-### New Project Setup
-
-```
-Agent: workflow-status
-System: "No status found. Run workflow-init"
-Agent: workflow-init
-System: "Tell me about your project"
-User: "Building a dashboard with user management"
-System: "Level 2 greenfield software project. Correct?"
-User: "Yes"
-System: "Status created! Next: pm agent, run prd"
-```
-
-### Smart Inference
-
-```
-System finds: prd-dashboard.md with 3 epics
-System finds: package.json, src/ directory
-System infers: Level 2 brownfield software
-User confirms or corrects
-```
-
-## Philosophy
-
-**Less Structure, More Intelligence**
-
-Instead of complex if/else logic:
-
-- Trust the LLM to analyze and infer
-- Use natural language for corrections
-- Keep menus simple and contextual
-- Let intelligence emerge from the model
-
-**Result:** A workflow system that feels like talking to a smart assistant, not filling out a form.
-
-## Implementation Details
-
-### workflow-init (6 Steps)
-
-1. **Scan for existing work** - Check for docs, code, git history
-2. **Confirm findings** - Show what was detected (if anything)
-3. **Gather info** - Name, description, confirm type/level/field
-4. **Load path file** - Select appropriate workflow definition
-5. **Generate workflow** - Build from path file
-6. **Create status file** - Save and show next step
-
-### workflow-status (4 Steps)
-
-1. **Check for status file** - Direct to init if missing
-2. **Parse status** - Extract key-value pairs
-3. **Display options** - Show current, required, optional
-4. **Handle selection** - Execute user's choice
-
-## Best Practices
-
-1. **Let the AI guess** - It's usually right, user corrects if needed
-2. **One conversation** - Get all info in Step 3 of init
-3. **Simple parsing** - Key-value pairs, not complex structures
-4. **Modular paths** - Each scenario in its own file
-5. **Trust intelligence** - LLM understands context better than rules
-
-## Integration
-
-Other workflows read the status to coordinate:
-
-- Any workflow can check CURRENT_PHASE
-- Workflows can verify prerequisites are complete
-- All agents can ask "what should I do?"
-
-**Phase 4 (Implementation):**
-
-- workflow-status only tracks sprint-planning completion
-- After sprint-planning, all story/epic tracking happens in sprint-status.yaml
-- Phase 4 workflows do NOT read/write workflow-status (except sprint-planning for prerequisite verification)
-
-The workflow-status.yaml file is the single source of truth for Phases 1-3, and sprint-status.yaml takes over for Phase 4 implementation tracking.
-
-## Benefits
-
-✅ **Smart Detection** - Infers from existing work instead of asking everything
-✅ **Minimal Questions** - Just name and description in most cases
-✅ **Clean Status** - Simple key-value pairs for instant parsing
-✅ **Modular Paths** - 60-line files instead of 750+ line monolith
-✅ **Natural Language** - "Tell me about your project" not "Pick 1-12"
-✅ **Intelligent Menus** - Shows only relevant options
-✅ **Fast Parsing** - Grep instead of complex logic
-✅ **Easy Maintenance** - Change one level without affecting others
-
-## Future Enhancements
-
-- Visual progress indicators
-- Time tracking and estimates
-- Multi-project support
-- Team synchronization
-
----
-
-**This workflow is the front door to BMad Method. Start here to know what to do next.**

package/bmad/bmm/workflows/workflow-status/paths/brownfield-level-0.yaml

@@ -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"

package/bmad/bmm/workflows/workflow-status/paths/brownfield-level-2.yaml

@@ -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"

package/bmad/bmm/workflows/workflow-status/paths/brownfield-level-4.yaml

@@ -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"

package/bmad/bmm/workflows/workflow-status/paths/greenfield-level-0.yaml

@@ -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"

package/bmad/bmm/workflows/workflow-status/paths/greenfield-level-3.yaml

@@ -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"

package/bmad/bmm/workflows/workflow-status/paths/greenfield-level-4.yaml

@@ -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"