From 79ac3c91fe8ee56f52faf34fadbe1481f2fde65f Mon Sep 17 00:00:00 2001 From: Brian Madison Date: Sun, 12 Oct 2025 16:14:29 -0500 Subject: [PATCH] central source of trust for workflow status, current, and next story or epic --- src/modules/bmm/workflows/2-plan/README.md | 10 +- .../workflows/2-plan/gdd/instructions-gdd.md | 4 +- .../workflows/2-plan/instructions-router.md | 98 +++++--- .../workflows/2-plan/prd/instructions-lg.md | 2 +- .../workflows/2-plan/prd/instructions-med.md | 2 +- .../bmm/workflows/2-plan/prd/workflow.yaml | 6 +- .../tech-spec/instructions-level0-story.md | 8 +- .../tech-spec/instructions-level1-stories.md | 8 +- .../2-plan/tech-spec/instructions-sm.md | 10 +- .../workflows/2-plan/ux/instructions-ux.md | 2 +- .../bmm/workflows/2-plan/workflow.yaml | 6 +- .../bmm/workflows/3-solutioning/README.md | 16 +- .../bmm/workflows/3-solutioning/checklist.md | 2 +- .../workflows/3-solutioning/instructions.md | 4 +- .../bmm/workflows/3-solutioning/workflow.yaml | 4 +- src/modules/bmm/workflows/README.md | 6 +- .../project-workflow-analysis-template.md | 135 ----------- .../project-workflow-status-template.md | 221 ++++++++++++++++++ 18 files changed, 328 insertions(+), 216 deletions(-) delete mode 100644 src/modules/bmm/workflows/_shared/project-workflow-analysis-template.md create mode 100644 src/modules/bmm/workflows/_shared/project-workflow-status-template.md diff --git a/src/modules/bmm/workflows/2-plan/README.md b/src/modules/bmm/workflows/2-plan/README.md index 84c8473f..0f2efc3c 100644 --- a/src/modules/bmm/workflows/2-plan/README.md +++ b/src/modules/bmm/workflows/2-plan/README.md @@ -8,7 +8,7 @@ This scale-adaptive workflow represents the cornerstone of BMM v6's intelligent The workflow's routing intelligence analyzes project characteristics through multi-dimensional assessment: project type (game, web, mobile, backend), context (greenfield vs. brownfield), scope indicators, and complexity signals. Based on this analysis, it classifies projects into five levels with distinct artifact requirements. Level 0 produces only tech specs for single atomic changes. Levels 1-2 generate focused PRDs with embedded tech specs. Levels 3-4 create comprehensive PRDs with separate epics that hand off to the architect-driven solutioning workflow. This classification isn't merely about document generation—it fundamentally changes how requirements are structured, validated, and communicated to downstream consumers. -Critical to v6's flow improvement is this workflow's integration with the project-workflow-analysis.md tracking document, which maintains project state across sessions, tracks which agents participate in each phase, and provides continuity for multi-session planning efforts. The workflow can resume from any point, intelligently detecting existing artifacts and determining next steps without redundant work. For game projects, it routes to specialized GDD generation with genre-specific templates. For UX-heavy projects, it can generate standalone UX specifications or AI frontend prompts from existing specs. +Critical to v6's flow improvement is this workflow's integration with the project-workflow-status.md tracking document, which maintains project state across sessions, tracks which agents participate in each phase, and provides continuity for multi-session planning efforts. The workflow can resume from any point, intelligently detecting existing artifacts and determining next steps without redundant work. For game projects, it routes to specialized GDD generation with genre-specific templates. For UX-heavy projects, it can generate standalone UX specifications or AI frontend prompts from existing specs. ## Key Features @@ -104,7 +104,7 @@ plan-project/ ### Generated Files -- **Primary output**: PRD.md (except Level 0), tech-spec.md, project-workflow-analysis.md +- **Primary output**: PRD.md (except Level 0), tech-spec.md, project-workflow-status.md - **Supporting files**: epics.md (Level 3-4), PRD-validation-report.md (if validation run) ### Output Structure by Level @@ -166,7 +166,7 @@ plan-project/ **Issue**: Workflow creates wrong level of documentation - **Solution**: Review project assessment and restart with correct scope classification -- **Check**: Verify the project-workflow-analysis.md reflects actual project complexity +- **Check**: Verify the project-workflow-status.md reflects actual project complexity **Issue**: Missing input documents cause incomplete planning @@ -175,7 +175,7 @@ plan-project/ **Issue**: Continuation from previous session fails -- **Solution**: Check for existing project-workflow-analysis.md and ensure output folder is correct +- **Solution**: Check for existing project-workflow-status.md and ensure output folder is correct - **Check**: Verify previous session completed at a valid checkpoint ## Customization @@ -201,7 +201,7 @@ For issues or questions: - Review the workflow creation guide at `/bmad/bmb/workflows/create-workflow/workflow-creation-guide.md` - Validate output using `checklist.md` -- Consult project assessment in `project-workflow-analysis.md` +- Consult project assessment in `project-workflow-status.md` - Check continuation status in existing output documents --- diff --git a/src/modules/bmm/workflows/2-plan/gdd/instructions-gdd.md b/src/modules/bmm/workflows/2-plan/gdd/instructions-gdd.md index 3df20407..ca8fe7a3 100644 --- a/src/modules/bmm/workflows/2-plan/gdd/instructions-gdd.md +++ b/src/modules/bmm/workflows/2-plan/gdd/instructions-gdd.md @@ -12,7 +12,7 @@ -Load project-workflow-analysis.md +Load project-workflow-status.md Confirm project_type == "game" @@ -439,7 +439,7 @@ Since this is a Level {{project_level}} game project, you need solutioning for p - [ ] **Run solutioning workflow** (REQUIRED) - Command: `workflow solution-architecture` - - Input: GDD.md, project-workflow-analysis.md + - Input: GDD.md, project-workflow-status.md - Output: solution-architecture.md with engine/platform specifics - Note: Registry.csv will provide engine-specific guidance diff --git a/src/modules/bmm/workflows/2-plan/instructions-router.md b/src/modules/bmm/workflows/2-plan/instructions-router.md index 05cb834d..f6a58bb1 100644 --- a/src/modules/bmm/workflows/2-plan/instructions-router.md +++ b/src/modules/bmm/workflows/2-plan/instructions-router.md @@ -3,36 +3,60 @@ This is the INITIAL ASSESSMENT phase - determines which instruction set to load -ALWAYS check for existing project-workflow-analysis.md first +ALWAYS check for existing project-workflow-status.md first The workflow execution engine is governed by: {project_root}/bmad/core/tasks/workflow.xml - + -Check if {output_folder}/project-workflow-analysis.md exists +Check if any project-workflow-status\*.md files exist in {output_folder}/ - Load the analysis file - Check for existing workflow outputs based on level in analysis: + Find the most recent project-workflow-status-YYYY-MM-DD.md file + Load the status file + Check for existing workflow outputs based on level in status file: - Level 0: Check for tech-spec.md - Level 1-2: Check for PRD.md, epic-stories.md, tech-spec.md - Level 3-4: Check for PRD.md, epics.md -Previous analysis found (Level {{project_level}}). +Found existing workflow status file: project-workflow-status-{{file_date}}.md (Level {{project_level}}) **Existing documents detected:** {{list_existing_docs}} Options: -1. Continue where left off with existing documents -2. Start fresh assessment (will archive existing work) -3. Review and modify previous analysis +1. Continue with this workflow (will update existing status file) +2. Start new workflow (will create new dated status file: project-workflow-status-{{today}}.md) +3. Review and modify previous status +4. I'm working on something else (ignore this file) + + + Set status_file_path = existing file path + Set continuation_mode = true + + + + Set status_file_path = "{output_folder}/project-workflow-status-{{today}}.md" + Archive old status file to: "{output_folder}/archive/project-workflow-status-{{old_date}}.md" + Set continuation_mode = false + Proceed to new assessment + + + + Do not use status file for this session + Proceed with user's requested workflow + Exit router (user is not using BMM planning workflow) + + - + + Create new versioned status file + Set status_file_path = "{output_folder}/project-workflow-status-{{today}}.md" + Set start_date = {{today}} Proceed to assessment @@ -204,58 +228,60 @@ Examples: - + -Initialize analysis using analysis_template from workflow.yaml +Initialize status file using status_template from workflow.yaml +Write to versioned file path: {{status_file_path}} +Set start_date = {{today}} in template variables Capture any technical preferences mentioned during assessment Initialize Workflow Status Tracker with current state -Generate comprehensive analysis with all assessment data. +Generate comprehensive status document with all assessment data. -project_type -project_level -instruction_set -scope_description -story_count -epic_count -timeline -field_type -existing_docs -team_size -deployment_intent -expected_outputs -workflow_steps -next_steps -special_notes -technical_preferences +project_type +project_level +instruction_set +scope_description +story_count +epic_count +timeline +field_type +existing_docs +team_size +deployment_intent +expected_outputs +workflow_steps +next_steps +special_notes +technical_preferences Initialize Workflow Status Tracker section: -current_phase +current_phase Set to: "2-Plan" -current_workflow +current_workflow Set to: "tech-spec (Level 0 - starting)" Set to: "tech-spec (Level 1 - starting)" Set to: "PRD (Level {{project_level}} - starting)" -progress_percentage +progress_percentage Set to: 10% (assessment complete) -artifacts_table +artifacts_table Initialize with: ``` -| project-workflow-analysis.md | Complete | {output_folder}/project-workflow-analysis.md | {{date}} | +| project-workflow-status.md | Complete | {output_folder}/project-workflow-status.md | {{date}} | ``` -next_action +next_action Set to: "Generate technical specification and single user story" Set to: "Generate technical specification and epic/stories (2-3 stories)" Set to: "Generate PRD and epic breakdown" -decisions_log +decisions_log Add first entry: ``` diff --git a/src/modules/bmm/workflows/2-plan/prd/instructions-lg.md b/src/modules/bmm/workflows/2-plan/prd/instructions-lg.md index 2f2dd980..fb474086 100644 --- a/src/modules/bmm/workflows/2-plan/prd/instructions-lg.md +++ b/src/modules/bmm/workflows/2-plan/prd/instructions-lg.md @@ -12,7 +12,7 @@ -Load project-workflow-analysis.md +Load project-workflow-status.md Confirm Level 3-4 - Full product or platform diff --git a/src/modules/bmm/workflows/2-plan/prd/instructions-med.md b/src/modules/bmm/workflows/2-plan/prd/instructions-med.md index 67b5b7a9..a1910e08 100644 --- a/src/modules/bmm/workflows/2-plan/prd/instructions-med.md +++ b/src/modules/bmm/workflows/2-plan/prd/instructions-med.md @@ -12,7 +12,7 @@ -Load project-workflow-analysis.md +Load project-workflow-status.md Confirm Level 1-2 - Feature or small system diff --git a/src/modules/bmm/workflows/2-plan/prd/workflow.yaml b/src/modules/bmm/workflows/2-plan/prd/workflow.yaml index 6d279714..65b0161a 100644 --- a/src/modules/bmm/workflows/2-plan/prd/workflow.yaml +++ b/src/modules/bmm/workflows/2-plan/prd/workflow.yaml @@ -19,11 +19,11 @@ instructions_lg: "{installed_path}/instructions-lg.md" # Level 3-4 # Templates prd_template: "{installed_path}/prd-template.md" -analysis_template: "{project-root}/bmad/bmm/workflows/_shared/project-workflow-analysis-template.md" +status_template: "{project-root}/bmad/bmm/workflows/_shared/project-workflow-status-template.md" epics_template: "{installed_path}/epics-template.md" # Output configuration -analysis_file: "{output_folder}/project-workflow-analysis.md" +status_file: "{output_folder}/project-workflow-status.md" default_output_file: "{output_folder}/PRD.md" epics_output_file: "{output_folder}/epics.md" validation_output_file: "{output_folder}/PRD-validation-report.md" @@ -74,7 +74,7 @@ web_bundle: - "bmad/bmm/workflows/2-plan/prd/instructions-med.md" - "bmad/bmm/workflows/2-plan/prd/instructions-lg.md" - "bmad/bmm/workflows/2-plan/prd/prd-template.md" - - "bmad/bmm/workflows/_shared/project-workflow-analysis-template.md" + - "bmad/bmm/workflows/_shared/project-workflow-status-template.md" - "bmad/bmm/workflows/2-plan/prd/epics-template.md" # Scale parameters - adaptive by project level scale_parameters: diff --git a/src/modules/bmm/workflows/2-plan/tech-spec/instructions-level0-story.md b/src/modules/bmm/workflows/2-plan/tech-spec/instructions-level0-story.md index 0eefe36e..93b9aa28 100644 --- a/src/modules/bmm/workflows/2-plan/tech-spec/instructions-level0-story.md +++ b/src/modules/bmm/workflows/2-plan/tech-spec/instructions-level0-story.md @@ -10,7 +10,7 @@ Read the completed tech-spec.md file from {output_folder}/tech-spec.md -Load project-workflow-analysis.md from {output_folder}/project-workflow-analysis.md +Load project-workflow-status.md from {output_folder}/project-workflow-status.md Extract dev_story_location from config (where stories are stored) Extract the problem statement from "Technical Approach" section Extract the scope from "Source Tree Structure" section @@ -100,7 +100,7 @@ -Open {output_folder}/project-workflow-analysis.md +Open {output_folder}/project-workflow-status.md Update "Workflow Status Tracker" section Set current_phase = "2-Plan" @@ -130,7 +130,7 @@ - **{{date}}**: Level 0 tech-spec and story generation completed. Story: story-{slug}.md ready for context generation. ``` -Save project-workflow-analysis.md +Save project-workflow-status.md @@ -163,7 +163,7 @@ **Progress Tracking:** -- All decisions logged in: `project-workflow-analysis.md` +- All decisions logged in: `project-workflow-status.md` - Next action clearly identified Ready to proceed? Choose your path: diff --git a/src/modules/bmm/workflows/2-plan/tech-spec/instructions-level1-stories.md b/src/modules/bmm/workflows/2-plan/tech-spec/instructions-level1-stories.md index f0983624..c814a14b 100644 --- a/src/modules/bmm/workflows/2-plan/tech-spec/instructions-level1-stories.md +++ b/src/modules/bmm/workflows/2-plan/tech-spec/instructions-level1-stories.md @@ -11,7 +11,7 @@ Read the completed tech-spec.md file from {output_folder}/tech-spec.md -Load project-workflow-analysis.md from {output_folder}/project-workflow-analysis.md +Load project-workflow-status.md from {output_folder}/project-workflow-status.md Extract dev_story_location from config (where stories are stored) Identify all implementation tasks from the "Implementation Guide" section Identify the overall feature goal from "Technical Approach" section @@ -230,7 +230,7 @@ Epic: Icon Reliability -Open {output_folder}/project-workflow-analysis.md +Open {output_folder}/project-workflow-status.md Update "Workflow Status Tracker" section Set current_phase = "2-Plan" @@ -265,7 +265,7 @@ Epic: Icon Reliability - **{{date}}**: Level 1 tech-spec and epic/stories generation completed. {{story_count}} stories created. Ready for implementation of story-{epic_slug}-1.md. ``` -Save project-workflow-analysis.md +Save project-workflow-status.md @@ -317,7 +317,7 @@ d. Run dev-story workflow to implement story 1 **Progress Tracking:** -- All decisions logged in: `project-workflow-analysis.md` +- All decisions logged in: `project-workflow-status.md` - Next action clearly identified Ready to proceed? Choose your path: diff --git a/src/modules/bmm/workflows/2-plan/tech-spec/instructions-sm.md b/src/modules/bmm/workflows/2-plan/tech-spec/instructions-sm.md index 1f48fcda..d5142e0e 100644 --- a/src/modules/bmm/workflows/2-plan/tech-spec/instructions-sm.md +++ b/src/modules/bmm/workflows/2-plan/tech-spec/instructions-sm.md @@ -11,7 +11,7 @@ -Load project-workflow-analysis.md from {output_folder}/project-workflow-analysis.md +Load project-workflow-status.md from {output_folder}/project-workflow-status.md Update Workflow Status Tracker: @@ -21,7 +21,7 @@ Set current_workflow = "tech-spec (Level 1 - generating tech spec)" Set progress_percentage = 20% -Save project-workflow-analysis.md +Save project-workflow-status.md Confirm Level 0 - Single atomic change @@ -40,9 +40,9 @@ Generate tech-spec.md - this is the TECHNICAL SOURCE OF TRUTH ALL TECHNICAL DECISIONS MUST BE DEFINITIVE - NO AMBIGUITY ALLOWED -Update progress in project-workflow-analysis.md: +Update progress in project-workflow-status.md: Set progress_percentage = 40% -Save project-workflow-analysis.md +Save project-workflow-status.md Initialize tech-spec.md using tech_spec_template from workflow.yaml @@ -108,7 +108,7 @@ Run cohesion validation? (y/n) -Load project-workflow-analysis.md to determine project_level +Load project-workflow-status.md to determine project_level Invoke instructions-level0-story.md to generate single user story diff --git a/src/modules/bmm/workflows/2-plan/ux/instructions-ux.md b/src/modules/bmm/workflows/2-plan/ux/instructions-ux.md index bb0e9d16..fae00d8c 100644 --- a/src/modules/bmm/workflows/2-plan/ux/instructions-ux.md +++ b/src/modules/bmm/workflows/2-plan/ux/instructions-ux.md @@ -38,7 +38,7 @@ If no: We'll gather basic requirements to create the UX spec - epics.md or epic-stories.md (helps understand feature grouping) - tech-spec.md (understand technical constraints) - solution-architecture.md (if Level 3-4 project) -- project-workflow-analysis.md (understand project level and scope) +- project-workflow-status.md (understand project level and scope) diff --git a/src/modules/bmm/workflows/2-plan/workflow.yaml b/src/modules/bmm/workflows/2-plan/workflow.yaml index 0d539e67..36983945 100644 --- a/src/modules/bmm/workflows/2-plan/workflow.yaml +++ b/src/modules/bmm/workflows/2-plan/workflow.yaml @@ -27,7 +27,7 @@ workflow_ux: "{installed_path}/ux/workflow.yaml" # Templates - Load these only when the instructions request loading them prd_template: "{installed_path}/prd/prd-template.md" -analysis_template: "{project-root}/bmad/bmm/workflows/_shared/project-workflow-analysis-template.md" +status_template: "{project-root}/bmad/bmm/workflows/_shared/project-workflow-status-template.md" epics_template: "{installed_path}/prd/epics-template.md" tech_spec_template: "{installed_path}/tech-spec/tech-spec-template.md" ux_spec_template: "{installed_path}/ux/ux-spec-template.md" @@ -39,7 +39,7 @@ narrative_template: "{installed_path}/narrative/narrative-template.md" instructions: "{installed_path}/instructions-router.md" # Output configuration -analysis_file: "{output_folder}/project-workflow-analysis.md" +status_file: "{output_folder}/project-workflow-status.md" default_output_file: "{output_folder}/PRD.md" gdd_output_file: "{output_folder}/GDD.md" epics_output_file: "{output_folder}/epics.md" @@ -83,7 +83,7 @@ web_bundle: instructions_narrative: "bmad/bmm/workflows/2-plan/narrative/instructions-narrative.md" # Templates - Load these only when the instructions request loading them prd_template: "{installed_path}/prd/prd-template.md" - analysis_template: "bmad/bmm/workflows/_shared/project-workflow-analysis-template.md" + status_template: "bmad/bmm/workflows/_shared/project-workflow-status-template.md" epics_template: "{installed_path}/prd/epics-template.md" tech_spec_template: "{installed_path}/tech-spec/tech-spec-template.md" ux_spec_template: "{installed_path}/ux/ux-spec-template.md" diff --git a/src/modules/bmm/workflows/3-solutioning/README.md b/src/modules/bmm/workflows/3-solutioning/README.md index 9f47f2f0..44113c7e 100644 --- a/src/modules/bmm/workflows/3-solutioning/README.md +++ b/src/modules/bmm/workflows/3-solutioning/README.md @@ -24,12 +24,12 @@ This workflow generates comprehensive, scale-adaptive solution architecture docu Run this workflow **AFTER** completing: -| Prerequisite | Required For | Location | -| -------------------------- | ----------------------------- | ------------------------------------ | -| **plan-project workflow** | All projects | `/docs/project-workflow-analysis.md` | -| **PRD with epics/stories** | Level 1+ projects | `/docs/PRD.md` | -| **GDD (for games)** | Game projects | `/docs/GDD.md` or `/docs/PRD.md` | -| **UX Specification** | UI projects (web/mobile/game) | `/docs/ux-specification.md` | +| Prerequisite | Required For | Location | +| -------------------------- | ----------------------------- | ---------------------------------- | +| **plan-project workflow** | All projects | `/docs/project-workflow-status.md` | +| **PRD with epics/stories** | Level 1+ projects | `/docs/PRD.md` | +| **GDD (for games)** | Game projects | `/docs/GDD.md` or `/docs/PRD.md` | +| **UX Specification** | UI projects (web/mobile/game) | `/docs/ux-specification.md` | --- @@ -41,7 +41,7 @@ workflow solution-architecture **The workflow will:** -1. Load `project-workflow-analysis.md` (from plan-project) +1. Load `project-workflow-status.md` (from plan-project) 2. Check prerequisites (PRD/GDD, UX spec if needed) 3. Read requirements (PRD for apps, GDD for games) 4. Ask architecture pattern questions @@ -110,7 +110,7 @@ Each row maps to: ### Step 0: Prerequisites and Scale Check -Load `project-workflow-analysis.md`: +Load `project-workflow-status.md`: - Extract: `project_level` (0-4), `project_type` (web/game/mobile/etc.), `field_type` (greenfield/brownfield) - Validate: PRD exists, UX spec exists (if UI project) diff --git a/src/modules/bmm/workflows/3-solutioning/checklist.md b/src/modules/bmm/workflows/3-solutioning/checklist.md index de9176a5..2c00022e 100644 --- a/src/modules/bmm/workflows/3-solutioning/checklist.md +++ b/src/modules/bmm/workflows/3-solutioning/checklist.md @@ -87,7 +87,7 @@ Use this checklist during workflow execution and review. - [ ] Tech-spec generated for each epic - [ ] Saved as tech-spec-epic-{{N}}.md -- [ ] project-workflow-analysis.md updated +- [ ] project-workflow-status.md updated ### Step 10: Polyrepo Strategy (Optional) diff --git a/src/modules/bmm/workflows/3-solutioning/instructions.md b/src/modules/bmm/workflows/3-solutioning/instructions.md index 23388b36..6b55e95c 100644 --- a/src/modules/bmm/workflows/3-solutioning/instructions.md +++ b/src/modules/bmm/workflows/3-solutioning/instructions.md @@ -7,7 +7,7 @@ This workflow generates scale-adaptive solution architecture documentation that -1. Read project-workflow-analysis.md: +1. Read project-workflow-status.md: Path: {{project_workflow_analysis_path}} 2. Extract: @@ -579,7 +579,7 @@ For each epic in PRD: tech_specs -Update project-workflow-analysis.md workflow status: +Update project-workflow-status.md workflow status: - [x] Solution architecture generated - [x] Cohesion check passed - [x] Tech specs generated for all epics diff --git a/src/modules/bmm/workflows/3-solutioning/workflow.yaml b/src/modules/bmm/workflows/3-solutioning/workflow.yaml index 46479543..55d2528b 100644 --- a/src/modules/bmm/workflows/3-solutioning/workflow.yaml +++ b/src/modules/bmm/workflows/3-solutioning/workflow.yaml @@ -16,8 +16,8 @@ inputs: default: "{output_folder}/PRD.md" required: true - name: project_workflow_analysis_path - description: "Path to project-workflow-analysis.md from plan-project workflow" - default: "{output_folder}/project-workflow-analysis.md" + description: "Path to project-workflow-status.md from plan-project workflow" + default: "{output_folder}/project-workflow-status.md" required: true - name: project_level description: "Project level (0-4) from analysis file" diff --git a/src/modules/bmm/workflows/README.md b/src/modules/bmm/workflows/README.md index c85e2b66..b6b1e21c 100644 --- a/src/modules/bmm/workflows/README.md +++ b/src/modules/bmm/workflows/README.md @@ -109,7 +109,7 @@ plan-project │ ├─→ Level 0 → tech-spec workflow │ ├─→ Level 1-2 → PRD + embedded tech-spec │ └─→ Level 3-4 → PRD + epics → Solutioning - └─→ Generate project-workflow-analysis.md (tracking doc) + └─→ Generate project-workflow-status.md (tracking doc) ``` ### Key Outputs @@ -118,7 +118,7 @@ plan-project - **Epics.md**: Epic breakdown with stories (Levels 2-4) - **tech-spec.md**: Technical specification (Levels 0-2 only) - **GDD.md**: Game Design Document (game projects) -- **project-workflow-analysis.md**: Workflow state tracking +- **project-workflow-status.md**: Workflow state tracking ## Phase 3: Solutioning (Levels 3-4 Only) @@ -251,7 +251,7 @@ plan-project (Phase 2) ### Tracking Documents -- **project-workflow-analysis.md**: Maintains workflow state, level, and progress +- **project-workflow-status.md**: Maintains workflow state, level, and progress - **Epics.md**: Master list of epics and stories (source of truth for planning) ### Phase Outputs diff --git a/src/modules/bmm/workflows/_shared/project-workflow-analysis-template.md b/src/modules/bmm/workflows/_shared/project-workflow-analysis-template.md deleted file mode 100644 index dcc41498..00000000 --- a/src/modules/bmm/workflows/_shared/project-workflow-analysis-template.md +++ /dev/null @@ -1,135 +0,0 @@ -# Project Workflow Analysis - -**Date:** {{date}} -**Project:** {{project_name}} -**Analyst:** {{user_name}} -**Last Updated:** {{date}} - ---- - -## Workflow Status Tracker - -**Current Phase:** {{current_phase}} -**Current Workflow:** {{current_workflow}} -**Current Agent:** {{current_agent}} -**Overall Progress:** {{progress_percentage}}% - -### Phase Completion Status - -- [ ] **1-Analysis** - Research, brainstorm, brief (optional) -- [ ] **2-Plan** - PRD/GDD/Tech-Spec + Stories/Epics -- [ ] **3-Solutioning** - Architecture + Tech Specs (Level 2+ only) -- [ ] **4-Implementation** - Story development and delivery - -### Artifacts Generated - -| Artifact | Status | Location | Date | -| -------- | ------ | -------- | ---- | - -{{#artifacts}} -| {{name}} | {{status}} | {{path}} | {{date}} | -{{/artifacts}} - -### Next Action Required - -**What to do next:** {{next_action}} - -**Command to run:** {{next_command}} - -**Agent to load:** {{next_agent}} - ---- - -## Assessment Results - -### Project Classification - -- **Project Type:** {{project_type}} -- **Project Level:** {{project_level}} -- **Instruction Set:** {{instruction_set}} - -### Scope Summary - -- **Brief Description:** {{scope_description}} -- **Estimated Stories:** {{story_count}} -- **Estimated Epics:** {{epic_count}} -- **Timeline:** {{timeline}} - -### Context - -- **Greenfield/Brownfield:** {{field_type}} -- **Existing Documentation:** {{existing_docs}} -- **Team Size:** {{team_size}} -- **Deployment Intent:** {{deployment_intent}} - -## Recommended Workflow Path - -### Primary Outputs - -{{expected_outputs}} - -### Workflow Sequence - -{{workflow_steps}} - -### Next Actions - -{{next_steps}} - -## Special Considerations - -{{special_notes}} - -## Technical Preferences Captured - -{{technical_preferences}} - -## Story Naming Convention - -### Level 0 (Single Atomic Change) - -- **Format:** `story-.md` -- **Example:** `story-icon-migration.md`, `story-login-fix.md` -- **Location:** `{{dev_story_location}}/` -- **Max Stories:** 1 (if more needed, consider Level 1) - -### Level 1 (Coherent Feature) - -- **Format:** `story--<n>.md` -- **Example:** `story-oauth-integration-1.md`, `story-oauth-integration-2.md` -- **Location:** `{{dev_story_location}}/` -- **Max Stories:** 2-3 (prefer longer stories over more stories) - -### Level 2+ (Multiple Epics) - -- **Format:** `story-<epic>.<story>.md` -- **Example:** `story-1.1.md`, `story-1.2.md`, `story-2.1.md` -- **Location:** `{{dev_story_location}}/` -- **Max Stories:** Per epic breakdown in epics.md - -## Decision Log - -### Planning Decisions Made - -{{#decisions}} - -- **{{decision_date}}**: {{decision_description}} - {{/decisions}} - ---- - -## Change History - -{{#changes}} - -### {{change_date}} - {{change_author}} - -- Phase: {{change_phase}} -- Changes: {{change_description}} - {{/changes}} - ---- - -_This analysis serves as the **single source of truth** for project workflow decisions, progress tracking, and next actions. All BMM workflow phases reference this document for coordination._ - -_Template Location: `bmad/bmm/workflows/_shared/project-workflow-analysis-template.md`_ diff --git a/src/modules/bmm/workflows/_shared/project-workflow-status-template.md b/src/modules/bmm/workflows/_shared/project-workflow-status-template.md new file mode 100644 index 00000000..7e171658 --- /dev/null +++ b/src/modules/bmm/workflows/_shared/project-workflow-status-template.md @@ -0,0 +1,221 @@ +# Project Workflow Status + +**Project:** {{project_name}} +**Created:** {{start_date}} +**Last Updated:** {{last_updated}} +**Status File:** `project-workflow-status-{{start_date}}.md` + +--- + +## Workflow Status Tracker + +**Current Phase:** {{current_phase}} +**Current Workflow:** {{current_workflow}} +**Current Agent:** {{current_agent}} +**Overall Progress:** {{progress_percentage}}% + +### Phase Completion Status + +- [ ] **1-Analysis** - Research, brainstorm, brief (optional) +- [ ] **2-Plan** - PRD/GDD/Tech-Spec + Stories/Epics +- [ ] **3-Solutioning** - Architecture + Tech Specs (Level 2+ only) +- [ ] **4-Implementation** - Story development and delivery + +### Implementation Progress (Phase 4 Only) + +**Story Tracking:** {{story_tracking_mode}} + +{{#if in_phase_4}} + +#### Current Work In Progress + +- **Current Epic:** {{current_epic_number}} - {{current_epic_title}} +- **Current Story:** {{current_story_number}} - {{current_story_title}} +- **Story File:** `{{current_story_file}}` +- **Story Status:** {{current_story_status}} + +#### Next Story To Work On + +- **Next Epic:** {{next_epic_number}} - {{next_epic_title}} +- **Next Story:** {{next_story_number}} - {{next_story_title}} +- **Next Story File:** `{{next_story_file}}` + +**Logic:** Next story is determined by: + +1. If current epic has more stories → next story in same epic +2. If current epic complete → first story of next epic +3. If all epics complete → Project complete! + +#### Epic/Story Summary + +**Total Epics:** {{total_epics}} +**Total Stories:** {{total_stories}} +**Completed Stories:** {{completed_stories}} +**Remaining Stories:** {{remaining_stories}} + +**Epic Breakdown:** +{{#epics}} + +- Epic {{epic_number}}: {{epic_title}} ({{epic_completed_stories}}/{{epic_total_stories}} stories complete) + {{/epics}} + +{{/if}} + +### Artifacts Generated + +| Artifact | Status | Location | Date | +| -------- | ------ | -------- | ---- | + +{{#artifacts}} +| {{name}} | {{status}} | {{path}} | {{date}} | +{{/artifacts}} + +### Next Action Required + +**What to do next:** {{next_action}} + +**Command to run:** {{next_command}} + +**Agent to load:** {{next_agent}} + +--- + +## Assessment Results + +### Project Classification + +- **Project Type:** {{project_type}} +- **Project Level:** {{project_level}} +- **Instruction Set:** {{instruction_set}} + +### Scope Summary + +- **Brief Description:** {{scope_description}} +- **Estimated Stories:** {{story_count}} +- **Estimated Epics:** {{epic_count}} +- **Timeline:** {{timeline}} + +### Context + +- **Greenfield/Brownfield:** {{field_type}} +- **Existing Documentation:** {{existing_docs}} +- **Team Size:** {{team_size}} +- **Deployment Intent:** {{deployment_intent}} + +## Recommended Workflow Path + +### Primary Outputs + +{{expected_outputs}} + +### Workflow Sequence + +{{workflow_steps}} + +### Next Actions + +{{next_steps}} + +## Special Considerations + +{{special_notes}} + +## Technical Preferences Captured + +{{technical_preferences}} + +## Story Naming Convention + +### Level 0 (Single Atomic Change) + +- **Format:** `story-<short-title>.md` +- **Example:** `story-icon-migration.md`, `story-login-fix.md` +- **Location:** `{{dev_story_location}}/` +- **Max Stories:** 1 (if more needed, consider Level 1) + +### Level 1 (Coherent Feature) + +- **Format:** `story-<title>-<n>.md` +- **Example:** `story-oauth-integration-1.md`, `story-oauth-integration-2.md` +- **Location:** `{{dev_story_location}}/` +- **Max Stories:** 2-3 (prefer longer stories over more stories) + +### Level 2+ (Multiple Epics) + +- **Format:** `story-<epic>.<story>.md` +- **Example:** `story-1.1.md`, `story-1.2.md`, `story-2.1.md` +- **Location:** `{{dev_story_location}}/` +- **Max Stories:** Per epic breakdown in epics.md + +## Decision Log + +### Planning Decisions Made + +{{#decisions}} + +- **{{decision_date}}**: {{decision_description}} + {{/decisions}} + +--- + +## Change History + +{{#changes}} + +### {{change_date}} - {{change_author}} + +- Phase: {{change_phase}} +- Changes: {{change_description}} + {{/changes}} + +--- + +## Agent Usage Guide + +### For SM (Scrum Master) Agent + +**When to use this file:** + +- Running create-story workflow → Read "Next Story To Work On" section +- Checking epic/story progress → Read "Implementation Progress" section +- Updating story status → Update "Current Story Status" and recalculate next story + +**Key fields:** + +- `next_story_file` → The exact file path to create +- `next_epic_number` + `next_story_number` → For story numbering + +### For DEV (Developer) Agent + +**When to use this file:** + +- Running dev-story workflow → Read "Current Work In Progress" section +- After completing story → Update status to "Complete", recalculate next story +- Checking what to work on → Read "Next Story To Work On" + +**Key fields:** + +- `current_story_file` → The story to implement +- `current_story_status` → Update after completion + +### For PM (Product Manager) Agent + +**When to use this file:** + +- Checking overall progress → Read "Phase Completion Status" +- Planning next phase → Read "Overall Progress" percentage +- Course correction → Read "Decision Log" for context + +**Key fields:** + +- `progress_percentage` → Overall project progress +- `current_phase` → What phase are we in +- `artifacts` table → What's been generated + +--- + +_This file serves as the **single source of truth** for project workflow status, epic/story tracking, and next actions. All BMM agents and workflows reference this document for coordination._ + +_Template Location: `bmad/bmm/workflows/_shared/project-workflow-status-template.md`_ + +_File Created: {{start_date}}_