workflow-status phase paths corrected with current reality

This commit is contained in:
Brian Madison 2025-12-28 22:01:08 +08:00
parent b509fb9a1e
commit ff0517f4d0
6 changed files with 158 additions and 185 deletions

3
.gitignore vendored
View File

@ -46,8 +46,6 @@ CLAUDE.local.md
# Project-specific # Project-specific
_bmad-core _bmad-core
_bmad-creator-tools _bmad-creator-tools
test-project-install/*
sample-project/*
flattened-codebase.xml flattened-codebase.xml
*.stats.md *.stats.md
.internal-docs/ .internal-docs/
@ -66,6 +64,7 @@ shared-modules
z*/ z*/
_bmad _bmad
_bmad-output
.claude .claude
.codex .codex
.github/chatmodes .github/chatmodes

View File

@ -7,116 +7,97 @@ field_type: "brownfield"
description: "Enterprise-grade planning for complex brownfield additions with extended requirements" description: "Enterprise-grade planning for complex brownfield additions with extended requirements"
phases: phases:
- prerequisite: true - phase: 0
name: "Documentation" name: "Documentation"
conditional: "if_undocumented" conditional: "if_undocumented"
note: "NOT a phase - prerequisite for brownfield without docs (nearly mandatory for enterprise)" note: "Prerequisite for brownfield without docs"
workflows: workflows:
- id: "document-project" - id: "document-project"
required: true required: true
workflow: "{project-root}/_bmad/bmm/workflows/document-project/workflow.yaml"
agent: "analyst" agent: "analyst"
command: "document-project" command: "/bmad:bmm:workflows:document-project"
output: "Comprehensive project documentation" output: "Comprehensive project documentation"
purpose: "Understand existing codebase - critical for enterprise brownfield" purpose: "Understand existing codebase before planning"
- phase: 1
- phase: 0 name: "Analysis (Optional)"
name: "Discovery (Required)" optional: true
required: true note: "User-selected during workflow-init"
note: "Analysis phase required for enterprise projects"
workflows: workflows:
- id: "brainstorm-project" - id: "brainstorm-project"
exec: "{project-root}/_bmad/core/workflows/brainstorming/workflow.md"
optional: true optional: true
agent: "analyst" agent: "analyst"
command: "brainstorm-project" command: "/bmad:bmm:workflows:brainstorming"
included_by: "user_choice"
note: "Uses core brainstorming workflow with project context template" note: "Uses core brainstorming workflow with project context template"
included_by: "user_choice"
- id: "research" - id: "research"
recommended: true exec: "{project-root}/_bmad/bmm/workflows/1-analysis/research/workflow.md"
agent: "analyst"
command: "research"
included_by: "user_choice"
note: "Highly recommended - compliance, integration, risk research"
- id: "product-brief"
optional: true optional: true
agent: "analyst" agent: "analyst"
command: "product-brief" command: "/bmad:bmm:workflows:research"
included_by: "user_choice" included_by: "user_choice"
note: "Optional for brownfield enterprise" note: "Can have multiple research workflows"
- id: "product-brief"
- phase: 1 exec: "{project-root}/_bmad/bmm/workflows/1-analysis/create-product-brief/workflow.md"
optional: true
agent: "analyst"
command: "/bmad:bmm:workflows:create-product-brief"
included_by: "user_choice"
note: "Recommended for greenfield Method projects"
- phase: 2
name: "Planning" name: "Planning"
required: true required: true
workflows: workflows:
- id: "prd" - id: "prd"
exec: "{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd/workflow.md"
required: true required: true
agent: "pm" agent: "pm"
command: "prd" command: "/bmad:bmm:workflows:create-prd"
output: "Enterprise PRD with compliance requirements" output: "Product Requirements Document with FRs and NFRs"
note: "Must address existing system constraints and migration strategy"
- id: "create-ux-design" - id: "create-ux-design"
recommended: true conditional: "if_has_ui"
exec: "{project-root}/_bmad/bmm/workflows/2-plan-workflows/create-ux-design/workflow.md"
agent: "ux-designer" agent: "ux-designer"
command: "create-ux-design" command: "/bmad:bmm:workflows:create-ux-design"
note: "Recommended - must integrate with existing UX patterns" note: "Determined after PRD - user/agent decides if needed"
- phase: 3
- phase: 2
name: "Solutioning" name: "Solutioning"
required: true required: true
workflows: workflows:
- id: "create-architecture" - id: "create-architecture"
required: true required: true
exec: "{project-root}/_bmad/bmm/workflows/3-solutioning/create-architecture/workflow.md"
agent: "architect" agent: "architect"
command: "create-architecture" command: "/bmad:bmm:workflows:create-architecture"
output: "Integration architecture with enterprise considerations" output: "System architecture document"
note: "Distills brownfield context + adds security/scalability/compliance design" note: "Complete system design for greenfield projects"
- id: "create-epics-and-stories" - id: "create-epics-and-stories"
required: true required: true
exec: "{project-root}/_bmad/bmm/workflows/3-solutioning/create-epics-and-stories/workflow.md"
agent: "pm" agent: "pm"
command: "create-epics-and-stories" command: "/bmad:bmm:workflows:create-epics-and-stories"
note: "Required: Break down PRD into implementable epics and stories with full context (PRD + UX + Architecture)" note: "Required: Break down PRD into implementable epics and stories with full context (PRD + UX + Architecture)"
- id: "test-design" - id: "test-design"
required: true optional: true
workflow: "{project-root}/_bmad/bmm/workflows/testarch/test-design/workflow.yaml"
agent: "tea" agent: "tea"
command: "test-design" command: "/bmad:bmm:workflows:test-design"
output: "System-level testability review" output: "System-level testability review"
note: "Enterprise requires testability validation - auto-detects system-level mode" note: "Testability assessment before gate check - auto-detects system-level mode"
# - id: "create-security-architecture"
# optional: true
# agent: "architect"
# command: "create-security-architecture"
# output: "Security architecture for brownfield integration"
# note: "Future workflow - optional extended enterprise workflow for threat model, auth integration, audit requirements"
# - id: "create-devops-strategy"
# optional: true
# agent: "architect"
# command: "create-devops-strategy"
# output: "DevOps strategy for brownfield deployment"
# note: "Future workflow - optional extended enterprise workflow for CI/CD integration, deployment strategy, monitoring"
- id: "validate-architecture"
recommended: true
agent: "architect"
command: "validate-architecture"
- id: "implementation-readiness" - id: "implementation-readiness"
required: true required: true
exec: "{project-root}/_bmad/bmm/workflows/3-solutioning/check-implementation-readiness/workflow.md"
agent: "architect" agent: "architect"
command: "implementation-readiness" command: "/bmad:bmm:workflows:implementation-readiness"
note: "Validates PRD + Architecture + Epics + UX (optional)" note: "Validates PRD + Architecture + Epics + UX (optional)"
- phase: 4
- phase: 3
name: "Implementation" name: "Implementation"
required: true required: true
workflows: workflows:
- id: "sprint-planning" - id: "sprint-planning"
required: true required: true
workflow: "{project-root}/_bmad/bmm/workflows/4-implementation/sprint-planning/workflow.yaml"
agent: "sm" agent: "sm"
command: "sprint-planning" command: "/bmad:bmm:workflows:sprint-planning"
note: "Enterprise brownfield requires careful phasing and feature flags" note: "Creates sprint plan - subsequent work tracked there"

View File

@ -7,104 +7,94 @@ field_type: "greenfield"
description: "Complete enterprise-grade planning with security, devops, and test strategy" description: "Complete enterprise-grade planning with security, devops, and test strategy"
phases: phases:
- phase: 0 - phase: 1
name: "Discovery (Required)" name: "Analysis (Optional)"
required: true optional: true
note: "Analysis phase required for enterprise projects" note: "User-selected during workflow-init"
workflows: workflows:
- id: "brainstorm-project" - id: "brainstorm-project"
exec: "{project-root}/_bmad/core/workflows/brainstorming/workflow.md"
optional: true optional: true
agent: "analyst" agent: "analyst"
command: "brainstorm-project" command: "/bmad:bmm:workflows:brainstorming"
note: "Uses core brainstorming workflow with project context template"
included_by: "user_choice" included_by: "user_choice"
note: "Uses core brainstorming workflow with project context template"
- id: "research" - id: "research"
recommended: true exec: "{project-root}/_bmad/bmm/workflows/1-analysis/research/workflow.md"
optional: true
agent: "analyst" agent: "analyst"
command: "research" command: "/bmad:bmm:workflows:research"
included_by: "user_choice" included_by: "user_choice"
note: "Highly recommended for enterprise - domain and compliance research" note: "Can have multiple research workflows"
- id: "product-brief" - id: "product-brief"
recommended: true exec: "{project-root}/_bmad/bmm/workflows/1-analysis/create-product-brief/workflow.md"
optional: true
agent: "analyst" agent: "analyst"
command: "product-brief" command: "/bmad:bmm:workflows:create-product-brief"
included_by: "user_choice" included_by: "user_choice"
note: "Recommended for strategic alignment" note: "Recommended for greenfield Method projects"
- phase: 1 - phase: 2
name: "Planning" name: "Planning"
required: true required: true
workflows: workflows:
- id: "prd" - id: "prd"
exec: "{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd/workflow.md"
required: true required: true
agent: "pm" agent: "pm"
command: "prd" command: "/bmad:bmm:workflows:create-prd"
output: "Comprehensive Product Requirements Document" output: "Product Requirements Document with FRs and NFRs"
note: "Enterprise-level requirements with compliance considerations"
- id: "create-ux-design" - id: "create-ux-design"
recommended: true conditional: "if_has_ui"
exec: "{project-root}/_bmad/bmm/workflows/2-plan-workflows/create-ux-design/workflow.md"
agent: "ux-designer" agent: "ux-designer"
command: "create-ux-design" command: "/bmad:bmm:workflows:create-ux-design"
note: "Highly recommended for enterprise - design system and patterns" note: "Determined after PRD - user/agent decides if needed"
- phase: 2 - phase: 3
name: "Solutioning" name: "Solutioning"
required: true required: true
workflows: workflows:
- id: "create-architecture" - id: "create-architecture"
required: true required: true
exec: "{project-root}/_bmad/bmm/workflows/3-solutioning/create-architecture/workflow.md"
agent: "architect" agent: "architect"
command: "create-architecture" command: "/bmad:bmm:workflows:create-architecture"
output: "Enterprise-grade system architecture" output: "System architecture document"
note: "Includes scalability, multi-tenancy, integration architecture" note: "Complete system design for greenfield projects"
- id: "test-design"
required: true
agent: "tea"
command: "test-design"
output: "System-level testability review"
note: "Enterprise requires testability validation - auto-detects system-level mode"
# - id: "create-security-architecture"
# optional: true
# agent: "architect"
# command: "create-security-architecture"
# output: "Security architecture and threat model"
# note: "Future workflow - optional extended enterprise workflow for security design, auth, compliance"
# - id: "create-devops-strategy"
# optional: true
# agent: "architect"
# command: "create-devops-strategy"
# output: "DevOps pipeline and infrastructure plan"
# note: "Future workflow - optional extended enterprise workflow for CI/CD, deployment, monitoring"
- id: "validate-architecture"
recommended: true
agent: "architect"
command: "validate-architecture"
- id: "create-epics-and-stories" - id: "create-epics-and-stories"
required: true required: true
exec: "{project-root}/_bmad/bmm/workflows/3-solutioning/create-epics-and-stories/workflow.md"
agent: "pm" agent: "pm"
command: "create-epics-and-stories" command: "/bmad:bmm:workflows:create-epics-and-stories"
note: "Required: Break down PRD into implementable epics and stories with full context (PRD + UX + Architecture)" note: "Required: Break down PRD into implementable epics and stories with full context (PRD + UX + Architecture)"
- id: "test-design"
optional: true
workflow: "{project-root}/_bmad/bmm/workflows/testarch/test-design/workflow.yaml"
agent: "tea"
command: "/bmad:bmm:workflows:test-design"
output: "System-level testability review"
note: "Testability assessment before gate check - auto-detects system-level mode"
- id: "implementation-readiness" - id: "implementation-readiness"
required: true required: true
exec: "{project-root}/_bmad/bmm/workflows/3-solutioning/check-implementation-readiness/workflow.md"
agent: "architect" agent: "architect"
command: "implementation-readiness" command: "/bmad:bmm:workflows:implementation-readiness"
note: "Validates PRD + Architecture + Epics + UX (optional)" note: "Validates PRD + Architecture + Epics + UX (optional)"
- phase: 3 - phase: 4
name: "Implementation" name: "Implementation"
required: true required: true
workflows: workflows:
- id: "sprint-planning" - id: "sprint-planning"
required: true required: true
workflow: "{project-root}/_bmad/bmm/workflows/4-implementation/sprint-planning/workflow.yaml"
agent: "sm" agent: "sm"
command: "sprint-planning" command: "/bmad:bmm:workflows:sprint-planning"
note: "Creates sprint plan - enterprise projects may require phased rollout" note: "Creates sprint plan - subsequent work tracked there"

View File

@ -7,100 +7,97 @@ field_type: "brownfield"
description: "Complete product and system design for complex brownfield work" description: "Complete product and system design for complex brownfield work"
phases: phases:
- prerequisite: true - phase: 0
name: "Documentation" name: "Documentation"
conditional: "if_undocumented" conditional: "if_undocumented"
note: "NOT a phase - prerequisite for brownfield without docs" note: "Prerequisite for brownfield without docs"
workflows: workflows:
- id: "document-project" - id: "document-project"
required: true required: true
workflow: "{project-root}/_bmad/bmm/workflows/document-project/workflow.yaml"
agent: "analyst" agent: "analyst"
command: "document-project" command: "/bmad:bmm:workflows:document-project"
output: "Comprehensive project documentation" output: "Comprehensive project documentation"
purpose: "Understand existing codebase before planning" purpose: "Understand existing codebase before planning"
- phase: 1
- phase: 0 name: "Analysis (Optional)"
name: "Discovery (Optional)"
optional: true optional: true
note: "User-selected during workflow-init" note: "User-selected during workflow-init"
workflows: workflows:
- id: "brainstorm-project" - id: "brainstorm-project"
exec: "{project-root}/_bmad/core/workflows/brainstorming/workflow.md"
optional: true optional: true
agent: "analyst" agent: "analyst"
command: "brainstorm-project" command: "/bmad:bmm:workflows:brainstorming"
included_by: "user_choice" included_by: "user_choice"
note: "Uses core brainstorming workflow with project context template" note: "Uses core brainstorming workflow with project context template"
- id: "research" - id: "research"
exec: "{project-root}/_bmad/bmm/workflows/1-analysis/research/workflow.md"
optional: true optional: true
agent: "analyst" agent: "analyst"
command: "research" command: "/bmad:bmm:workflows:research"
included_by: "user_choice" included_by: "user_choice"
note: "Can have multiple research workflows"
- id: "product-brief" - id: "product-brief"
exec: "{project-root}/_bmad/bmm/workflows/1-analysis/create-product-brief/workflow.md"
optional: true optional: true
agent: "analyst" agent: "analyst"
command: "product-brief" command: "/bmad:bmm:workflows:create-product-brief"
included_by: "user_choice" included_by: "user_choice"
note: "Optional for brownfield, less common than greenfield" note: "Recommended for greenfield Method projects"
- phase: 2
- phase: 1
name: "Planning" name: "Planning"
required: true required: true
workflows: workflows:
- id: "prd" - id: "prd"
exec: "{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd/workflow.md"
required: true required: true
agent: "pm" agent: "pm"
command: "prd" command: "/bmad:bmm:workflows:create-prd"
output: "PRD focused on new features/changes" output: "Product Requirements Document with FRs and NFRs"
note: "Must consider existing system constraints"
- id: "create-ux-design" - id: "create-ux-design"
conditional: "if_has_ui" conditional: "if_has_ui"
exec: "{project-root}/_bmad/bmm/workflows/2-plan-workflows/create-ux-design/workflow.md"
agent: "ux-designer" agent: "ux-designer"
command: "create-ux-design" command: "/bmad:bmm:workflows:create-ux-design"
note: "Determined after PRD - user/agent decides if needed"
- phase: 2 - phase: 3
name: "Solutioning" name: "Solutioning"
required: true required: true
workflows: workflows:
- id: "create-architecture" - id: "create-architecture"
recommended: true required: true
exec: "{project-root}/_bmad/bmm/workflows/3-solutioning/create-architecture/workflow.md"
agent: "architect" agent: "architect"
command: "create-architecture" command: "/bmad:bmm:workflows:create-architecture"
output: "Integration architecture - solution design for THIS project" output: "System architecture document"
note: "HIGHLY RECOMMENDED: Distills massive brownfield context into focused solution design. Prevents agent confusion." note: "Complete system design for greenfield projects"
- id: "create-epics-and-stories" - id: "create-epics-and-stories"
required: true required: true
exec: "{project-root}/_bmad/bmm/workflows/3-solutioning/create-epics-and-stories/workflow.md"
agent: "pm" agent: "pm"
command: "create-epics-and-stories" command: "/bmad:bmm:workflows:create-epics-and-stories"
note: "Required: Break down PRD into implementable epics and stories with full context (PRD + UX + Architecture)" note: "Required: Break down PRD into implementable epics and stories with full context (PRD + UX + Architecture)"
- id: "test-design" - id: "test-design"
recommended: true optional: true
workflow: "{project-root}/_bmad/bmm/workflows/testarch/test-design/workflow.yaml"
agent: "tea" agent: "tea"
command: "test-design" command: "/bmad:bmm:workflows:test-design"
output: "System-level testability review" output: "System-level testability review"
note: "Testability assessment before gate check - auto-detects system-level mode" note: "Testability assessment before gate check - auto-detects system-level mode"
- id: "validate-architecture"
optional: true
agent: "architect"
command: "validate-architecture"
- id: "implementation-readiness" - id: "implementation-readiness"
required: true required: true
exec: "{project-root}/_bmad/bmm/workflows/3-solutioning/check-implementation-readiness/workflow.md"
agent: "architect" agent: "architect"
command: "implementation-readiness" command: "/bmad:bmm:workflows:implementation-readiness"
note: "Validates PRD + Architecture + Epics + UX (optional)" note: "Validates PRD + Architecture + Epics + UX (optional)"
- phase: 4
- phase: 3
name: "Implementation" name: "Implementation"
required: true required: true
workflows: workflows:
- id: "sprint-planning" - id: "sprint-planning"
required: true required: true
workflow: "{project-root}/_bmad/bmm/workflows/4-implementation/sprint-planning/workflow.yaml"
agent: "sm" agent: "sm"
command: "sprint-planning" command: "/bmad:bmm:workflows:sprint-planning"
note: "Creates sprint plan with stories" note: "Creates sprint plan - subsequent work tracked there"

View File

@ -7,90 +7,94 @@ field_type: "greenfield"
description: "Complete product and system design methodology for greenfield projects" description: "Complete product and system design methodology for greenfield projects"
phases: phases:
- phase: 0 - phase: 1
name: "Discovery (Optional)" name: "Analysis (Optional)"
optional: true optional: true
note: "User-selected during workflow-init" note: "User-selected during workflow-init"
workflows: workflows:
- id: "brainstorm-project" - id: "brainstorm-project"
exec: "{project-root}/_bmad/core/workflows/brainstorming/workflow.md"
optional: true optional: true
agent: "analyst" agent: "analyst"
command: "brainstorm-project" command: "/bmad:bmm:workflows:brainstorming"
included_by: "user_choice" included_by: "user_choice"
note: "Uses core brainstorming workflow with project context template" note: "Uses core brainstorming workflow with project context template"
- id: "research" - id: "research"
exec: "{project-root}/_bmad/bmm/workflows/1-analysis/research/workflow.md"
optional: true optional: true
agent: "analyst" agent: "analyst"
command: "research" command: "/bmad:bmm:workflows:research"
included_by: "user_choice" included_by: "user_choice"
note: "Can have multiple research workflows" note: "Can have multiple research workflows"
- id: "product-brief" - id: "product-brief"
exec: "{project-root}/_bmad/bmm/workflows/1-analysis/create-product-brief/workflow.md"
optional: true optional: true
agent: "analyst" agent: "analyst"
command: "product-brief" command: "/bmad:bmm:workflows:create-product-brief"
included_by: "user_choice" included_by: "user_choice"
note: "Recommended for greenfield Method projects" note: "Recommended for greenfield Method projects"
- phase: 1 - phase: 2
name: "Planning" name: "Planning"
required: true required: true
workflows: workflows:
- id: "prd" - id: "prd"
exec: "{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd/workflow.md"
required: true required: true
agent: "pm" agent: "pm"
command: "prd" command: "/bmad:bmm:workflows:create-prd"
output: "Product Requirements Document with FRs and NFRs" output: "Product Requirements Document with FRs and NFRs"
- id: "create-ux-design" - id: "create-ux-design"
conditional: "if_has_ui" conditional: "if_has_ui"
exec: "{project-root}/_bmad/bmm/workflows/2-plan-workflows/create-ux-design/workflow.md"
agent: "ux-designer" agent: "ux-designer"
command: "create-ux-design" command: "/bmad:bmm:workflows:create-ux-design"
note: "Determined after PRD - user/agent decides if needed" note: "Determined after PRD - user/agent decides if needed"
- phase: 2 - phase: 3
name: "Solutioning" name: "Solutioning"
required: true required: true
workflows: workflows:
- id: "create-architecture" - id: "create-architecture"
required: true required: true
exec: "{project-root}/_bmad/bmm/workflows/3-solutioning/create-architecture/workflow.md"
agent: "architect" agent: "architect"
command: "create-architecture" command: "/bmad:bmm:workflows:create-architecture"
output: "System architecture document" output: "System architecture document"
note: "Complete system design for greenfield projects" note: "Complete system design for greenfield projects"
- id: "create-epics-and-stories" - id: "create-epics-and-stories"
required: true required: true
exec: "{project-root}/_bmad/bmm/workflows/3-solutioning/create-epics-and-stories/workflow.md"
agent: "pm" agent: "pm"
command: "create-epics-and-stories" command: "/bmad:bmm:workflows:create-epics-and-stories"
note: "Required: Break down PRD into implementable epics and stories with full context (PRD + UX + Architecture)" note: "Required: Break down PRD into implementable epics and stories with full context (PRD + UX + Architecture)"
- id: "test-design" - id: "test-design"
recommended: true optional: true
workflow: "{project-root}/_bmad/bmm/workflows/testarch/test-design/workflow.yaml"
agent: "tea" agent: "tea"
command: "test-design" command: "/bmad:bmm:workflows:test-design"
output: "System-level testability review" output: "System-level testability review"
note: "Testability assessment before gate check - auto-detects system-level mode" note: "Testability assessment before gate check - auto-detects system-level mode"
- id: "validate-architecture"
optional: true
agent: "architect"
command: "validate-architecture"
note: "Quality check for architecture completeness"
- id: "implementation-readiness" - id: "implementation-readiness"
required: true required: true
exec: "{project-root}/_bmad/bmm/workflows/3-solutioning/check-implementation-readiness/workflow.md"
agent: "architect" agent: "architect"
command: "implementation-readiness" command: "/bmad:bmm:workflows:implementation-readiness"
note: "Validates PRD + Architecture + Epics + UX (optional)" note: "Validates PRD + Architecture + Epics + UX (optional)"
- phase: 3 - phase: 4
name: "Implementation" name: "Implementation"
required: true required: true
workflows: workflows:
- id: "sprint-planning" - id: "sprint-planning"
required: true required: true
workflow: "{project-root}/_bmad/bmm/workflows/4-implementation/sprint-planning/workflow.yaml"
agent: "sm" agent: "sm"
command: "sprint-planning" command: "/bmad:bmm:workflows:sprint-planning"
note: "Creates sprint plan - subsequent work tracked there" note: "Creates sprint plan - subsequent work tracked there"

2
tools/docs/index.md Normal file
View File

@ -0,0 +1,2 @@
# Tool and Repo Maintainability Documentation