diff --git a/src/atlassian/agents/analyst.agent.yaml b/src/atlassian/agents/analyst.agent.yaml index 379d8b566..c34f7504e 100644 --- a/src/atlassian/agents/analyst.agent.yaml +++ b/src/atlassian/agents/analyst.agent.yaml @@ -34,27 +34,18 @@ agent: - "After completing any workflow, invoke the post-handoff task to record completion and hand off to the next agent" menu: - - trigger: BP or fuzzy match on brainstorm-project - exec: "{project-root}/_bmad/atlassian/workflow-overrides/1-analysis/brainstorming/workflow.md" - data: "{project-root}/_bmad/atlassian/templates/product-brief-template.md" - description: "[BP] Brainstorm Project: Expert Guided Facilitation through a single or multiple techniques with a final report" - - trigger: MR or fuzzy match on market-research - exec: "{project-root}/_bmad/atlassian/workflow-overrides/1-analysis/research/workflow-market-research.md" - description: "[MR] Market Research: Market analysis, competitive landscape, customer needs and trends" + workflow: "{project-root}/_bmad/atlassian/workflow-overrides/1-analysis/research/workflow-jira.yaml" + description: "[MR] Market Research: Market analysis, competitive landscape, customer needs and trends (output to Confluence)" - trigger: DR or fuzzy match on domain-research - exec: "{project-root}/_bmad/atlassian/workflow-overrides/1-analysis/research/workflow-domain-research.md" - description: "[DR] Domain Research: Industry domain deep dive, subject matter expertise and terminology" + workflow: "{project-root}/_bmad/atlassian/workflow-overrides/1-analysis/research/workflow-jira.yaml" + description: "[DR] Domain Research: Industry domain deep dive, subject matter expertise and terminology (output to Confluence)" - trigger: TR or fuzzy match on technical-research - exec: "{project-root}/_bmad/atlassian/workflow-overrides/1-analysis/research/workflow-technical-research.md" - description: "[TR] Technical Research: Technical feasibility, architecture options and implementation approaches" + workflow: "{project-root}/_bmad/atlassian/workflow-overrides/1-analysis/research/workflow-jira.yaml" + description: "[TR] Technical Research: Technical feasibility, architecture options and implementation approaches (output to Confluence)" - trigger: CB or fuzzy match on product-brief - exec: "{project-root}/_bmad/atlassian/workflow-overrides/1-analysis/create-product-brief/workflow.md" - description: "[CB] Create Brief: A guided experience to nail down your product idea into an executive brief" - - - trigger: DP or fuzzy match on document-project - workflow: "{project-root}/_bmad/atlassian/workflow-overrides/1-analysis/document-project/workflow.yaml" - description: "[DP] Document Project: Analyze an existing project to produce useful documentation for both human and LLM" + workflow: "{project-root}/_bmad/atlassian/workflow-overrides/1-analysis/create-product-brief/workflow-jira.yaml" + description: "[CB] Create Brief: A guided experience to nail down your product idea into an executive brief (output to Confluence)" diff --git a/src/atlassian/agents/architect.agent.yaml b/src/atlassian/agents/architect.agent.yaml index d5b8a4a3f..ecd8b841a 100644 --- a/src/atlassian/agents/architect.agent.yaml +++ b/src/atlassian/agents/architect.agent.yaml @@ -38,9 +38,9 @@ agent: menu: - trigger: CA or fuzzy match on create-architecture - exec: "{project-root}/_bmad/atlassian/workflow-overrides/3-solutioning/create-architecture/workflow.md" - description: "[CA] Create Architecture: Guided Workflow to document technical decisions to keep implementation on track" + workflow: "{project-root}/_bmad/atlassian/workflow-overrides/3-solutioning/create-architecture/workflow-jira.yaml" + description: "[CA] Create Architecture: Guided Workflow to document technical decisions (output to Confluence)" - trigger: IR or fuzzy match on implementation-readiness - exec: "{project-root}/_bmad/atlassian/workflow-overrides/3-solutioning/check-implementation-readiness/workflow.md" - description: "[IR] Implementation Readiness: Ensure the PRD, UX, and Architecture and Epics and Stories List are all aligned" + workflow: "{project-root}/_bmad/atlassian/workflow-overrides/3-solutioning/check-implementation-readiness/workflow-jira.yaml" + description: "[IR] Implementation Readiness: Ensure the PRD, UX, Architecture and Epics/Stories are all aligned" diff --git a/src/atlassian/agents/pm.agent.yaml b/src/atlassian/agents/pm.agent.yaml index 896f5e894..71f44f0c9 100644 --- a/src/atlassian/agents/pm.agent.yaml +++ b/src/atlassian/agents/pm.agent.yaml @@ -40,25 +40,17 @@ agent: menu: - trigger: CP or fuzzy match on create-prd - exec: "{project-root}/_bmad/atlassian/workflow-overrides/2-plan-workflows/create-prd/workflow-create-prd.md" - description: "[CP] Create PRD: Expert led facilitation to produce your Product Requirements Document" - - - trigger: VP or fuzzy match on validate-prd - exec: "{project-root}/_bmad/atlassian/workflow-overrides/2-plan-workflows/create-prd/workflow-validate-prd.md" - description: "[VP] Validate PRD: Validate a Product Requirements Document is comprehensive, lean, well organized and cohesive" - - - trigger: EP or fuzzy match on edit-prd - exec: "{project-root}/_bmad/atlassian/workflow-overrides/2-plan-workflows/create-prd/workflow-edit-prd.md" - description: "[EP] Edit PRD: Update an existing Product Requirements Document" + workflow: "{project-root}/_bmad/atlassian/workflow-overrides/2-plan-workflows/create-prd/workflow-jira.yaml" + description: "[CP] Create PRD: Expert led facilitation to produce your Product Requirements Document (output to Confluence)" - trigger: CE or fuzzy match on epics-stories - exec: "{project-root}/_bmad/atlassian/workflow-overrides/3-solutioning/create-epics-and-stories/workflow.md" + workflow: "{project-root}/_bmad/atlassian/workflow-overrides/3-solutioning/create-epics-and-stories/steps/step-04-jira-output.md" description: "[CE] Create Epics and Stories: Create the Epics and Stories Listing via Jira, these are the specs that will drive development" - trigger: IR or fuzzy match on implementation-readiness - exec: "{project-root}/_bmad/atlassian/workflow-overrides/3-solutioning/check-implementation-readiness/workflow.md" - description: "[IR] Implementation Readiness: Ensure the PRD, UX, and Architecture and Epics and Stories List are all aligned" + workflow: "{project-root}/_bmad/atlassian/workflow-overrides/3-solutioning/check-implementation-readiness/workflow-jira.yaml" + description: "[IR] Implementation Readiness: Ensure the PRD, UX, Architecture and Epics/Stories are all aligned" - trigger: CC or fuzzy match on correct-course - workflow: "{project-root}/_bmad/atlassian/workflow-overrides/4-implementation/correct-course/workflow.yaml" + workflow: "{project-root}/_bmad/atlassian/workflow-overrides/4-implementation/correct-course/workflow-jira.yaml" description: "[CC] Course Correction: Use this so we can determine how to proceed if major need for change is discovered mid implementation" diff --git a/src/atlassian/agents/qa.agent.yaml b/src/atlassian/agents/qa.agent.yaml index 961a89cb5..5eec95f4e 100644 --- a/src/atlassian/agents/qa.agent.yaml +++ b/src/atlassian/agents/qa.agent.yaml @@ -44,8 +44,7 @@ agent: menu: - trigger: QA or fuzzy match on qa-automate - workflow: "{project-root}/_bmad/atlassian/workflow-overrides/qa-generate-e2e-tests/workflow.yaml" - description: "[QA] Automate - Generate tests for existing features (simplified)" + description: "[QA] Automate - Generate tests for existing features using standard test framework patterns. Posts test summary to Jira." prompts: - id: welcome diff --git a/src/atlassian/agents/sm.agent.yaml b/src/atlassian/agents/sm.agent.yaml index 8e4122318..65c7811c0 100644 --- a/src/atlassian/agents/sm.agent.yaml +++ b/src/atlassian/agents/sm.agent.yaml @@ -44,10 +44,9 @@ agent: description: "[CS] Create Story (Jira): Prepare a story with all required context for implementation, output to Jira" - trigger: ER or fuzzy match on epic-retrospective - workflow: "{project-root}/_bmad/atlassian/workflow-overrides/4-implementation/retrospective/workflow.yaml" - data: "{project-root}/_bmad/_config/agent-manifest.csv" - description: "[ER] Epic Retrospective: Party Mode review of all work completed across an epic" + workflow: "{project-root}/_bmad/atlassian/workflow-overrides/4-implementation/retrospective/workflow-jira.yaml" + description: "[ER] Epic Retrospective: Party Mode review of all work completed across an epic (output to Confluence + Jira)" - trigger: CC or fuzzy match on correct-course - workflow: "{project-root}/_bmad/atlassian/workflow-overrides/4-implementation/correct-course/workflow.yaml" + workflow: "{project-root}/_bmad/atlassian/workflow-overrides/4-implementation/correct-course/workflow-jira.yaml" description: "[CC] Course Correction: Use this so we can determine how to proceed if major need for change is discovered mid implementation" diff --git a/src/atlassian/agents/ux-designer.agent.yaml b/src/atlassian/agents/ux-designer.agent.yaml index 1ab075987..369fc67ad 100644 --- a/src/atlassian/agents/ux-designer.agent.yaml +++ b/src/atlassian/agents/ux-designer.agent.yaml @@ -38,5 +38,5 @@ agent: menu: - trigger: CU or fuzzy match on ux-design - exec: "{project-root}/_bmad/atlassian/workflow-overrides/2-plan-workflows/create-ux-design/workflow.md" - description: "[CU] Create UX: Guidance through realizing the plan for your UX to inform architecture and implementation. Provides more details than what was discovered in the PRD" + workflow: "{project-root}/_bmad/atlassian/workflow-overrides/2-plan-workflows/create-ux-design/workflow-jira.yaml" + description: "[CU] Create UX: Guidance through realizing the plan for your UX to inform architecture and implementation (output to Confluence)" diff --git a/src/atlassian/checklists/correct-course-checklist.md b/src/atlassian/checklists/correct-course-checklist.md index 1ca0f8cf8..01fb68b97 100644 --- a/src/atlassian/checklists/correct-course-checklist.md +++ b/src/atlassian/checklists/correct-course-checklist.md @@ -1,6 +1,6 @@ # Change Navigation Checklist -This checklist is executed as part of: {project-root}/_bmad/atlassian/workflows/4-implementation/correct-course/workflow.yaml +This checklist is executed as part of: {project-root}/_bmad/atlassian/workflow-overrides/4-implementation/correct-course/workflow-jira.yaml Work through each section systematically with the user, recording findings and impacts diff --git a/src/atlassian/checklists/prd-checklist.md b/src/atlassian/checklists/prd-checklist.md new file mode 100644 index 000000000..0b36ba288 --- /dev/null +++ b/src/atlassian/checklists/prd-checklist.md @@ -0,0 +1,33 @@ +# PRD Validation Checklist + +## Requirements Completeness +- [ ] Problem statement clearly defined with measurable impact +- [ ] Target users/personas identified with needs documented +- [ ] All functional requirements have acceptance criteria +- [ ] Non-functional requirements specified (performance, scalability, security, accessibility) +- [ ] Success metrics defined with measurable targets +- [ ] Scope boundaries clearly stated (what's in, what's out) + +## User Stories +- [ ] User stories follow "As a [user], I want [capability], so that [benefit]" format +- [ ] Acceptance criteria use Given/When/Then format +- [ ] Edge cases and error scenarios addressed +- [ ] User journey flows documented for critical paths + +## Dependencies and Risks +- [ ] External dependencies identified (APIs, services, data sources) +- [ ] Technical constraints documented +- [ ] Known risks listed with mitigation strategies +- [ ] Assumptions explicitly stated + +## Alignment +- [ ] PRD aligns with product brief objectives +- [ ] Research findings incorporated where applicable +- [ ] Stakeholder requirements addressed +- [ ] MVP scope is achievable and delivers core value + +## Quality +- [ ] No conflicting requirements +- [ ] No ambiguous language ("should", "might", "probably") +- [ ] Prioritisation clear (must-have vs nice-to-have) +- [ ] Document is self-contained and understandable without external context diff --git a/src/atlassian/workflow-overrides/1-analysis/create-product-brief/workflow-jira.yaml b/src/atlassian/workflow-overrides/1-analysis/create-product-brief/workflow-jira.yaml index 7deba0d9c..dafb636ee 100644 --- a/src/atlassian/workflow-overrides/1-analysis/create-product-brief/workflow-jira.yaml +++ b/src/atlassian/workflow-overrides/1-analysis/create-product-brief/workflow-jira.yaml @@ -19,7 +19,7 @@ key_map_file: "{config_source}:key_map_file" # Workflow components installed_path: "{project-root}/_bmad/atlassian/workflow-overrides/1-analysis/create-product-brief" instructions: "{installed_path}/instructions-jira.md" -template: "{project-root}/_bmad/atlassian/templates/product-brief.template.md" +template: "{project-root}/_bmad/atlassian/templates/product-brief-template.md" # Reusable tasks context_task: "{project-root}/_bmad/atlassian/tasks/read-jira-context.md" diff --git a/src/atlassian/workflow-overrides/1-analysis/research/workflow-jira.yaml b/src/atlassian/workflow-overrides/1-analysis/research/workflow-jira.yaml index ffb13b7d4..2ae037d43 100644 --- a/src/atlassian/workflow-overrides/1-analysis/research/workflow-jira.yaml +++ b/src/atlassian/workflow-overrides/1-analysis/research/workflow-jira.yaml @@ -21,7 +21,7 @@ research_type: "{research_type}" # Workflow components installed_path: "{project-root}/_bmad/atlassian/workflow-overrides/1-analysis/research" instructions: "{installed_path}/instructions-jira.md" -template: "{project-root}/_bmad/atlassian/templates/research.template.md" +template: "{project-root}/_bmad/atlassian/templates/research-template.md" # Reusable tasks context_task: "{project-root}/_bmad/atlassian/tasks/read-jira-context.md" diff --git a/src/atlassian/workflow-overrides/3-solutioning/create-architecture/workflow-jira.yaml b/src/atlassian/workflow-overrides/3-solutioning/create-architecture/workflow-jira.yaml index 0a88332a4..fd24ee6b6 100644 --- a/src/atlassian/workflow-overrides/3-solutioning/create-architecture/workflow-jira.yaml +++ b/src/atlassian/workflow-overrides/3-solutioning/create-architecture/workflow-jira.yaml @@ -19,7 +19,7 @@ key_map_file: "{config_source}:key_map_file" # Workflow components installed_path: "{project-root}/_bmad/atlassian/workflow-overrides/3-solutioning/create-architecture" instructions: "{installed_path}/instructions-jira.md" -template: "{project-root}/_bmad/atlassian/templates/architecture-template.md" +template: "{project-root}/_bmad/atlassian/templates/architecture-decision-template.md" # Reusable tasks context_task: "{project-root}/_bmad/atlassian/tasks/read-jira-context.md" diff --git a/src/atlassian/workflow-overrides/4-implementation/code-review/workflow-jira.yaml b/src/atlassian/workflow-overrides/4-implementation/code-review/workflow-jira.yaml index 11effcd7f..c97c808f0 100644 --- a/src/atlassian/workflow-overrides/4-implementation/code-review/workflow-jira.yaml +++ b/src/atlassian/workflow-overrides/4-implementation/code-review/workflow-jira.yaml @@ -16,7 +16,7 @@ status_transitions: "{config_source}:status_transitions" # Workflow components installed_path: "{project-root}/_bmad/atlassian/workflow-overrides/4-implementation/code-review" instructions: "{installed_path}/instructions-jira.md" -checklist: "{project-root}/_bmad/atlassian/workflows/4-implementation/code-review/checklist.md" +checklist: "{project-root}/_bmad/atlassian/checklists/code-review-checklist.md" # Reusable tasks transition_task: "{project-root}/_bmad/atlassian/tasks/transition-jira-issue.md" diff --git a/src/atlassian/workflow-overrides/4-implementation/create-story/workflow-jira.yaml b/src/atlassian/workflow-overrides/4-implementation/create-story/workflow-jira.yaml index 636991c60..5cee63c53 100644 --- a/src/atlassian/workflow-overrides/4-implementation/create-story/workflow-jira.yaml +++ b/src/atlassian/workflow-overrides/4-implementation/create-story/workflow-jira.yaml @@ -16,8 +16,8 @@ status_transitions: "{config_source}:status_transitions" # Workflow components installed_path: "{project-root}/_bmad/atlassian/workflow-overrides/4-implementation/create-story" instructions: "{installed_path}/instructions-jira.md" -checklist: "{project-root}/_bmad/atlassian/workflows/4-implementation/create-story/checklist.md" -template: "{project-root}/_bmad/atlassian/workflows/4-implementation/create-story/template.md" +checklist: "{project-root}/_bmad/atlassian/checklists/create-story-checklist.md" +template: "{project-root}/_bmad/atlassian/templates/story-template.md" # Reusable tasks transition_task: "{project-root}/_bmad/atlassian/tasks/transition-jira-issue.md" diff --git a/src/atlassian/workflow-overrides/4-implementation/dev-story/workflow-jira.yaml b/src/atlassian/workflow-overrides/4-implementation/dev-story/workflow-jira.yaml index 8db72f436..2146524bb 100644 --- a/src/atlassian/workflow-overrides/4-implementation/dev-story/workflow-jira.yaml +++ b/src/atlassian/workflow-overrides/4-implementation/dev-story/workflow-jira.yaml @@ -16,7 +16,7 @@ status_transitions: "{config_source}:status_transitions" # Workflow components installed_path: "{project-root}/_bmad/atlassian/workflow-overrides/4-implementation/dev-story" instructions: "{installed_path}/instructions-jira.md" -checklist: "{project-root}/_bmad/atlassian/workflows/4-implementation/dev-story/checklist.md" +checklist: "{project-root}/_bmad/atlassian/checklists/dev-story-checklist.md" # Reusable tasks transition_task: "{project-root}/_bmad/atlassian/tasks/transition-jira-issue.md" diff --git a/src/atlassian/workflow-overrides/4-implementation/sprint-planning/workflow-jira.yaml b/src/atlassian/workflow-overrides/4-implementation/sprint-planning/workflow-jira.yaml index a5bb511a8..51a9b5fc7 100644 --- a/src/atlassian/workflow-overrides/4-implementation/sprint-planning/workflow-jira.yaml +++ b/src/atlassian/workflow-overrides/4-implementation/sprint-planning/workflow-jira.yaml @@ -17,6 +17,7 @@ status_transitions: "{config_source}:status_transitions" # Workflow components installed_path: "{project-root}/_bmad/atlassian/workflow-overrides/4-implementation/sprint-planning" instructions: "{installed_path}/instructions-jira.md" +checklist: "{project-root}/_bmad/atlassian/checklists/sprint-planning-checklist.md" # Tracking system tracking_system: "jira"